Crea un invito da un contatto CRM
Attiva un contatto nuovo o qualificato, mappa il suo CRM ID a External ID, crea una scheda di invito e passa l'installazione restituita URL a un e-mail o passaggio SMS.
Guida all'automazione senza codice
Connetti 7stamp a Zapier — passo dopo passo
Guida all'implementazioneUtilizza Zapier quando il flusso di lavoro è una sequenza chiara: viene visualizzato un contatto o un ordine, 7stamp esegue un'azione, quindi viene aggiornato un altro strumento aziendale. Il percorso sicuro oggi è API entro Zapier per le chiamate in uscita 7stamp API e Webhooks by Zapier → Catch Hook per gli eventi in entrata 7stamp.
Non esiste un'app 7stamp pubblica nel marketplace di Zapier. Utilizza API by Zapier → API Request dove disponibile: memorizza una chiave API statica nella connessione dell'app invece di esporla in un passaggio Zap. Utilizzare Webhooks by Zapier solo per gli eventi Catch Hook in entrata; non inserire una chiave 7stamp Bearer in un campo di azione visibile dei Webhook.
Inizia con uno Zap lineare e testabile
Mantieni il primo Zap piccolo. Un flusso affidabile dal contatto alla carta o dall'ordine pagato ai francobolli è un punto di partenza migliore di un'ampia sincronizzazione bidirezionale CRM.
Aggiungi timbri dopo il checkout
Attiva dall'ordine pagato o dalla ricevuta chiusa, mappa l'identità del cliente e l'ordine ID, quindi utilizza Scan Card con l'importo dell'ordine o il numero esplicito di timbri.
Emetti un voucher di recupero una tantum
Utilizza una regola CRM, un evento di supporto o un'esportazione di segmenti per identificare un cliente, emettere un voucher sulla sua carta e inviare un messaggio di follow-up dal canale corretto.
Scrivi gli eventi delle carte sul tuo CRM
Usa Webhooks by Zapier > Catch Hook per ricevere gli eventi delle carte 7stamp. Abbina il record External ID restituito al record CRM e aggiungi la nota, il tag o l'attività pertinente.
7stamp operazioni per chiamare da API tramite Zapier
Aggiungi API by Zapier → API Request dopo l'attivazione. Crea una connessione con chiave 7stamp API, quindi seleziona il metodo esatto e la connessione URL completa di seguito. Ogni operazione restituisce campi che puoi mappare nel passaggio Zap successivo.
API tramite Zapier azione
POST /cards/invite Crea Card Invite
Crea una nuova installazione della carta portafoglio URL e un codice di inserimento consegna per un contatto esterno.
- Richiesto
- external_id dal trigger CRM/contact.
- Passaggio successivo
- Mappa install_url nell'e-mail, SMS o in un campo CRM.
API tramite Zapier azione
POST /cards/invite/bulk Crea in blocco Card Invites
Crea fino a 100 collegamenti di invito da un batch JSON controllato.
- Obbligatorio
- array di elementi con 1-100 oggetti di invito.
- Controlla
- Leggi success_count, error_count e ogni risultato prima della consegna.
API per Zapier azione
POST /cards/scan Scan Card
Aggiunge francobolli per User Card ID o External ID, con importo, conteggio di francobolli, ordine ID e dati di ricevuta opzionali.
- Identità
- external_id più external_source opzionale; user_card_id vince se sono presenti entrambi.
- La regola del timbro
- stamps_count ha la priorità sull'importo.
API tramite Zapier azione
POST /vouchers/issue Issue Voucher
Emette un voucher direttamente al titolare della carta.
- Richiesto voucher
- .short_description e un obiettivo external_id o conosciuto user_card_id.
- Risultato
- Mappa unique_code, stato o expires_at a una nota o messaggio CRM.
API tramite Zapier azione
POST /messages/send Send Message
Invia il push della carta portafoglio e il contenuto e-mail /or al proprietario della carta.
- Il push della carta
- card_push_text è limitato a 20 caratteri.
- oggetto più corpo; il risultato segnala se la consegna è stata in coda.
API per Zapier azione
GET /cards Find Cards
Trova i record delle carte per External ID, con filtri sorgente e modello opzionali.
- Richiesto
- external_id come parametro di query.
- Usa prima
- Usa prima di creare un invito quando la tua regola evita inviti duplicati.
API tramite Zapier azione
GET /cards/{user_card_id} Ottieni dettagli carta
Legge lo stato di una carta tramite il suo 7stamp interno ID.
- Obbligatorio
- Sostituisci {user_card_id} con un ID restituito da 7stamp.
- Output utile
- stamps_count, stato del portafoglio e active_vouchers_count.
API tramite Zapier azione
GET /templates List Templates
Elenca i modelli disponibili per il profilo connesso e verifica la connessione API.
- Primo test
- Chiamalo prima di qualsiasi azione di scrittura: non modifica i dati del cliente.
- Usa più tardi
- Un ID attivo diventa template_id quando esistono più modelli.
API per Zapier azione
GET /templates/{template_id}/design Get Template Design
Recupera le impostazioni di progettazione di un modello per un modello noto ID.
Zapier trigger
Webhooks by Zapier → Catch Hook Ricevi eventi carta
Catch Hook dà a Zapier un HTTPS unico URL. Incollalo nelle impostazioni del webhook di 7stamp Admin e testalo con un evento di carte reali.
- In Zapier
- Utilizzare Catch Hook per i dati degli eventi analizzati; usa Catch Raw Hook solo quando hai bisogno anche delle intestazioni di richiesta non elaborate/body.
- Match
- Trova il contatto CRM usando external_id e facoltativo external_source dall'evento.
Tre Zapier flussi di lavoro che puoi creare passo dopo passo
Ogni scenario utilizza un modulo Zapier reale, attualmente disponibile. Costruisci prima un piccolo percorso e testalo con un contatto usa e getta prima di accendere lo Zap.
1. Contatto qualificato CRM → emette una carta
Risultato previsto: Il passaggio successivo di Zap riceve install_url e può inviarlo al cliente o riscriverlo nel record CRM.
- 1 Crea uno Zap e seleziona l'evento CRM che indica che un contatto è idoneo alla fedeltà. Prova il trigger e conferma di avere il contatto immutabile ID.
- 2 Aggiungi API by Zapier → API Request. Crea o seleziona la connessione con tasto 7stamp API, scegli POST e imposta URL su https://api.7loc.com/cards-api/cards/invite.
- 3 Imposta il corpo su JSON. Mappa CRM ID in external_id, imposta un external_source fisso come kommo e aggiungi template_id solo quando è attivo più di un modello 7stamp.
- 4 Prova l'azione. Conferma che la risposta contenga install_url e delivery_insert_code per lo stesso external_id.
- 5 Aggiungi il tuo aggiornamento CRM, invia un'e-mail o un'azione SMS. Mappa install_url dalla risposta API; non codificare o copiare un test URL.
Controlla: Crea Card Invite restituisce sempre un nuovo invito. Aggiungi prima una richiesta Find Cards o un filtro Zapier se la tua politica prevede un invito per contatto.
2. Ordine pagato → francobolli premio
Risultato previsto: L'ordine crea una scansione tracciabile 7stamp e lo Zap può registrare stamps_added o scan_id nel sistema di origine.
- 1 Utilizza un ordine pagato/Closed Attiva la ricevuta e testalo. Conferma che il cliente ID e l'ordine unico ID siano entrambi presenti prima di continuare.
- 2 Aggiungi API by Zapier → API Request con POST https://api.7loc.com/cards-api/cards/scan e seleziona la stessa connessione 7stamp.
- 3 Invia JSON con external_id, external_source, external_order_id e l'importo per i modelli basati sull'importo o stamps_count per un premio in bollo esplicito.
- 4 Prova con un ordine usa e getta. Controlla l'esito positivo, scan_id e stamps_added nella risposta.
- 5 Aggiungi un filtro che continua solo dopo una risposta positiva, quindi aggiorna l'ordine/CRM con il risultato confermato.
Controlla: Se lo Zap viene riprodotto, controlla l'ordine originale prima di inviare un'altra scansione. Mantieni external_order_id stabile in modo che l'evento possa essere riconciliato in seguito.
3. Evento 7stamp → crea una nota o un'attività CRM
Risultato previsto: Zapier riceve un evento 7stamp analizzato, trova il cliente entro external_id e crea il follow-up appropriato.
- 1 Crea un nuovo Zap con Webhooks by Zapier come trigger. Seleziona Catch Hook, continua e copia l'unico URL mostrato nella fase Test.
- 2 In 7stamp Admin, apri API & Integrations → Webhooks, aggiungi Catch Hook URL, seleziona solo i tipi di eventi necessari e salva.
- 3 Provoca una vera scansione di prova o un evento della carta. Tornando a Zapier, fai clic su Test trigger e conferma che event_type, external_id e external_source arrivano come campi campione.
- 4 Aggiungi un'azione Trova contatto CRM utilizzando external_id. Aggiungi una regola di filtro o percorsi per event_type, ad esempio separa SCAN da REWARD_EARNED.
- 5 Crea una nota CRM/task e mappa solo i campi che esistono per quell'evento, come scanned_at, stamps_after, external_order_id o issued_vouchers.
Controlla: A Catch Hook URL è un segreto. Se lo Zap viene trasferito ad un altro proprietario, aggiorna URL in 7stamp Admin prima di fare affidamento su di esso.
Crea la chiave 7stamp API prima di creare lo Zap
Questi sono i passaggi laterali 7stamp. Fallo una volta, quindi usa la chiave solo all'interno della connessione API per Zapier, non in un campo di azione Webhooks by Zapier o in una nota. Schermata
Regole di connessione che impediscono la mancata corrispondenza dei dati
Mantieni la chiave API in una connessione API per Zapier
In 7stamp Admin, scegli API & Integrations → API Keys → Add API Key. In API di Zapier, crea una connessione con chiave API con un'intestazione statica Authorization contenente Bearer seguita da quella chiave. API di Zapier mantiene la credenziale nella connessione invece di un passaggio Zap visibile; limitare l'accesso alla connessione e ruotare la chiave se è esposta.
Mappa External ID e External Source in modo coerente
External ID è il tuo identificatore cliente stabile; External Source etichette da cui proviene, ad esempio hubspot, bitrix24, shopify o poster. Utilizza la stessa coppia per i flussi di creazione, ricerca, scansione, voucher e webhook.
Scopri quale identificatore della carta vince
Le azioni di targeting della carta accettano User Card ID o External ID. Quando sono presenti entrambi, User Card ID ha la priorità. Utilizzare il ID interno solo dopo che è stato restituito da un passaggio 7stamp attendibile; altrimenti preferisci il sistema sorgente External ID.
Esatto API entro Zapier richiesta: assegna un timbro
Copialo nel passaggio di automazione
http Method: POST
URL: https://api.7loc.com/cards-api/cards/scan
Headers:
Authorization: Bearer YOUR_7STAMP_API_KEY
Content-Type: application/json
Data:
{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"stamps_count": 1,
"external_order_id": "order_2048"
}Costruisci il tuo primo Zap
Crea una chiave 7stamp API in Admin: API & Integrations → API Keys → Add API Key. Utilizza una chiave di prova separata/profile quando disponibile.
In Zapier, crea uno Zap e testa il trigger di origine. Utilizza un campione reale in modo che il contatto ID, il cliente ID, l'ordine ID e l'importo siano disponibili per la mappatura.
Aggiungi API by Zapier → API Request. Crea una connessione 7stamp per l'intestazione statica Bearer Authorization anziché inserire il segreto in un campo di azione Webhooks by Zapier.
Chiama prima il GET https://api.7loc.com/cards-api/templates. Ciò conferma i lavori chiave e mostra quali ID modello attivi sono disponibili senza modificare i dati del cliente.
Seleziona POST /cards/invite o POST /cards/scan, imposta JSON come tipo di corpo e mappa la stalla External ID più i campi del modello pertinente/order dal grilletto.
Esegui l'azione con un contatto usa e getta, ispeziona i suoi esatti campi di risposta, quindi mappa tali campi nel passaggio successivo CRM, email o messaggio prima di pubblicare lo Zap.
Utilizza la richiesta universale solo per percorsi documentati
Utilizza API per Zapier per una richiesta 7stamp con una chiave Bearer API: mantiene le chiavi di intestazione statiche in una connessione app. Utilizza Webhooks by Zapier per la consegna dell'evento Catch Hook, non come posizione preferita per un segreto 7stamp. Mantieni la base URL su https://api.7loc.com/cards-api, utilizza il riferimento pubblico OpenAPI per schemi esatti e non inviare mai credenziali o dati del cliente a un URL non verificato.
Ricevi eventi 7stamp tramite Catch Hook
Crea Webhooks by Zapier → Catch Hook, copia l'unico URL mostrato nella configurazione del test, incollalo nelle impostazioni webhook del profilo 7stamp, seleziona i tipi di evento, e quindi inviare una scansione di prova reale o un evento della carta. Utilizza External ID e External Source del payload dell'evento per individuare il contatto CRM corretto. Scegli Catch Raw Hook solo quando hai specificamente bisogno del corpo non analizzato e delle intestazioni della richiesta.
Utilizza ora il percorso sicuro Zapier
API tramite Zapier e Catch Hook sono sufficienti per ogni operazione pubblica 7stamp API ed evento della carta. Se hai bisogno di una futura app nativa 7stamp Zapier, inviaci l'esatta action/trigger che il tuo team utilizza di più.
Domande frequenti
Dove posso trovare l'app 7stamp in Zapier?
Oggi non esiste un'app marketplace 7stamp pubblica. Utilizza API by Zapier → API Request per le chiamate 7stamp API e Webhooks by Zapier → Catch Hook per gli eventi 7stamp in entrata.
Dove creo il token Zapier?
Crea una chiave 7stamp API in Amministrazione sotto API & Integrations → API Keys → Add API Key. Memorizzalo come intestazione statica Bearer Authorization nella connessione API per Zapier, non in un campo di azione Webhooks by Zapier visibile.
Come può Zapier ricevere un francobollo o un buono evento?
Crea un Catch Hook in Webhooks by Zapier, incolla il URL generato nelle impostazioni del webhook del profilo 7stamp, seleziona gli eventi e invia un evento di prova prima di abilitare gli aggiornamenti di CRM.
Dovrei scegliere Zapier o Make?
Scegli Zapier per un flusso di lavoro con azione trigger prevalentemente lineare. Scegli Make quando hai bisogno di router, trasformazioni complesse o scenari multi-ramo lunghi. Entrambi utilizzano la stessa chiave 7stamp API e gli stessi endpoint.
Passaggio successivo
Costruisci il primo Zap con un contatto di prova
Crea la chiave API, prova da GET da /templates a API da Zapier, quindi crea un'azione contatto-carta o ordine-timbro. Aggiungi Catch Hook una volta che il flusso in uscita ha un risultato del test comprovato.