Crea una scheda dopo un nuovo contatto CRM
Utilizza il contatto CRM ID come External ID, crea un invito per la scheda 7stamp, quindi invia l'installazione restituita URL tramite la tua solita email, SMS o tramite messaggio.
Guida all'automazione senza codice
Connetti 7stamp a Make — passo dopo passo
Guida all'implementazioneUtilizza Make per connettere 7stamp con un CRM, POS, un negozio online, un foglio di calcolo, uno strumento di messaggistica o qualsiasi sistema in grado di inviare dati in uno scenario. Il percorso pronto per la produzione oggi è l'app HTTP di Make per le chiamate 7stamp API e l'app Custom webhook di Make per gli eventi 7stamp in entrata.
Non esiste ancora un'app 7stamp pubblica nel selettore di app di Make. Non aspettarne uno: aggiungi HTTP → Make a request, usa il metodo URL esatto, l'intestazione Bearer e JSON di seguito, quindi mappa i campi dal tuo modulo sorgente. Questo è lo stesso 7stamp Integration API che utilizzerebbe un futuro connettore.
Scegli il primo scenario che corrisponde al tuo flusso di lavoro
Inizia con un evento e un risultato. Una volta che i dati del test sono corretti, aggiungi filtri, router, aggiornamenti CRM e messaggi di follow-up attorno ad essi.
Aggiungi francobolli dopo un ordine pagato
Attiva lo scenario da un ordine pagato POS o e-commerce. Mappa il suo cliente stabile ID e ordina ID in Scan a Card, quindi utilizza un importo o un conteggio di francobolli esplicito.
Invia un follow-up di ricompensa
Quando un evento della carta segnala una ricompensa o un buono, ramifica lo scenario: aggiorna il CRM, avvisa il team e invia un push o un'e-mail della carta portafoglio solo quando necessario.
Gestisci un sistema senza un'app Make nativa
Utilizza il modulo HTTP di Make per chiamare direttamente 7stamp. Questa è la scelta universale per un motore di prenotazione personalizzato POS, ERP o qualsiasi servizio API-first.
7stamp operazioni per chiamare da Make HTTP
Per ciascuna carta sottostante, aggiungi HTTP → Make a request, quindi imposta il metodo e URL esattamente come mostrato. Utilizza la stessa chiave Bearer per ogni richiesta. La mappatura richiesta ti dice cosa fornire dal tuo CRM, POS o trigger e-commerce.
Make trigger
Webhooks → Custom webhook Ricevi una carta evento
Crea un Custom webhook in Make, copia il suo URL, quindi incollalo URL nelle impostazioni del webhook del profilo 7stamp. Ciò avvia uno scenario quando 7stamp invia un evento come SCAN, REWARD_EARNED o VOUCHER_ISSUED.
- In Make
- Webhooks → Custom webhook → Aggiungi; dagli un nome chiaro e copia il URL generato.
- In 7stamp
- Amministrazione → API & Integrations → Webhooks; incolla URL, seleziona i tipi di evento, salva, quindi crea un evento di prova.
HTTP
POST /cards/invite Crea un'azione Card Invite
Crea una nuova installazione personale URL e un codice di consegna-inserimento per un contatto esterno.
- Obbligatorio
- external_id — mappa la tua scuderia CRM/contact ID, non un nome.
- Quindi utilizza
- Mappa install_url dalla risposta alla tua email, SMS o CRM passaggio di aggiornamento.
HTTP azione
POST /cards/invite/bulk Creazione in blocco Card Invites
Crea fino a 100 collegamenti di invito in una richiesta. Usalo per una migrazione o una campagna controllata, non per un'esportazione illimitata di contatti.
- Elementi
- obbligatori: un array JSON di 1-100 oggetti di richiesta di invito individuali.
- Controlla
- Leggi success_count, error_count e ogni risultato prima di inviare qualsiasi collegamento.
HTTP azione
GET /cards Find Cards
Trova i record delle carte per External ID, con modello opzionale e filtri di origine.
- Obbligatorio
- Parametro di query external_id.
- Opzionali
- external_source e template_id restringono la ricerca quando un sistema ha più programmi.
HTTP azione
GET /cards/{user_card_id} Ottieni i dettagli della carta
Legge lo stato completo di una carta quando un passaggio precedente ha restituito il suo User Card ID interno.
- Obbligatorio
- Sostituisci {user_card_id} con il ID interno restituito da una risposta attendibile 7stamp.
- Evita
- Non indovinare o memorizzare una carta ID da un profilo diverso.
HTTP azione
POST /cards/scan Scansiona una carta
Aggiunge francobolli da un importo di acquisto o da un conteggio esplicito. Accetta User Card ID o External ID e può conservare il riferimento dell'ordine esterno.
- Identità
- Usa external_id e facoltativo external_source; user_card_id vince se vengono forniti entrambi.
- Acquisto
- Usa importo per carte a importo o stamps_count per un numero esplicito; stamps_count ha la priorità.
- Tracciabilità
- Mappa external_order_id dall'ordine pagato/receipt in modo che gli eventi 7stamp possano essere abbinati.
HTTP azione
GET /templates List Templates
Elenca i modelli di carte disponibili per il tasto API. Usalo per testare la connessione o per selezionare un modello dinamicamente.
- Primo test
- Questa è la prima richiesta più sicura: non ha corpo e non modifica i dati del cliente.
- Mappa più tardi
- Utilizza l'ID di un modello attivo come template_id solo quando il profilo ha più di un modello attivo.
HTTP azione
GET /templates/{template_id}/design Get Template Design
Restituisce le impostazioni di progettazione visiva per un modello noto, utile quando un altro sistema deve visualizzare una scelta di carte coerente.
HTTP azione
POST /vouchers/issue Emetti un voucher
Emette un voucher al titolare della carta identificato da External ID o User Card ID.
- Richiesto voucher
- .short_description. Scegli come bersaglio la carta con external_id o un user_card_id conosciuto.
- Validità
- Utilizzare validity_type con validity_value, oppure leggere il riferimento OpenAPI per una data di scadenza fissa.
HTTP azione
POST /messages/send Invia un messaggio
Invia contenuto al proprietario della carta tramite push della carta portafoglio e /or e-mail, in base al canale configurato e alle regole di consenso.
- Il push della carta
- card_push_text è limitato a 20 caratteri e richiede un pass portafoglio installato.
- Invia oggetto più corpo; basic HTML è supportato nel corpo.
Make modulo
Full 7stamp endpoint URL HTTP → Make a request
Questo è il modulo Make che chiama ogni percorso 7stamp sopra. Utilizza un URL completo, seleziona il metodo documentato, aggiungi l'intestazione Bearer e utilizza JSON solo quando il percorso necessita di un corpo.
- Base URL
- https://api.7loc.com/cards-api
- Intestazione
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json per POST richieste.
Tre scenari Make che puoi costruire esattamente come scritto
I nomi seguenti sono i veri moduli Make. Inizia con il primo scenario, eseguilo con un contatto usa e getta e solo dopo aggiungi router, filtri o pianificazione della produzione.
1. Nuovo contatto CRM → invia un collegamento alla carta 7stamp
Risultato previsto: Il cliente riceve la install_url restituita da 7stamp; il tuo CRM può conservare URL nello stesso record del contatto.
- 1 Crea uno scenario e aggiungi il trigger di contatto New/Created di CRM. Per Kommo, scegli l'attivatore di creazione del contatto ed eseguilo una volta per caricare un contatto di esempio.
- 2 Aggiungi HTTP → Make a request. Imposta Metodo su POST e URL su https://api.7loc.com/cards-api/cards/invite.
- 3 Aggiungi Authorization: Bearer YOUR_7STAMP_API_KEY e Content-Type: application/json. Nel corpo JSON, mappa il contatto CRM ID in external_id e imposta external_source su un'etichetta fissa come kommo.
- 4 Esegui il modulo HTTP una volta. Conferma che l'output abbia install_url, delivery_insert_code, external_id e template_id.
- 5 Aggiungi il tuo modulo di aggiornamento email/SMS/CRM dopo HTTP e mappa install_url dall'output HTTP. Salva il URL sul contatto CRM se il team deve inviarlo nuovamente in seguito.
Controlla: POST /cards/invite crea sempre un nuovo invito. Utilizza prima Find Cards se la tua regola aziendale è evitare un altro invito per un contatto esistente.
2. Ordine pagato → aggiungi timbri fedeltà
Risultato previsto: Una risposta di scansione riuscita include il successo, scan_id, stamps_added e lo stato della carta dopo la scansione per il passaggio successivo.
- 1 Inizia dall'attivatore dell'ordine pagato POS/ecommerce. Make sicuro che il suo campione contenga un cliente stabile ID e l'ordine/receipt ID.
- 2 Aggiungi HTTP → Make a request con POST https://api.7loc.com/cards-api/cards/scan e la stessa intestazione Bearer.
- 3 Mappa external_id dal cliente, external_source dal nome del sistema e external_order_id dall'ordine ID. Aggiungi importo per carte a importo o stamps_count per un numero esplicito di francobolli.
- 4 Run once con un ordine di prova. Controllare il flag di successo restituito e stamps_added prima di abilitare la pianificazione dello scenario.
- 5 Facoltativamente aggiungi un filtro dopo il passaggio HTTP: continua solo quando il successo è vero, quindi scrivi scan_id o stamps_added nell'ordine/record CRM.
Controlla: Utilizzare lo stesso external_order_id nei tentativi in modo che l'ordine possa essere tracciato negli eventi webhook successivi; non assegnare timbri due volte dopo una corsa fallita poco chiara.
3. Evento 7stamp → aggiorna l'evento CRM
Risultato previsto: Make riceve immediatamente l'evento 7stamp e può trovare il record CRM corrispondente tramite external_id e external_source.
- 1 Crea uno scenario Make separato. Aggiungi Webhooks → Custom webhook, seleziona Aggiungi, chiamalo 7stamp-card-events e copia il URL generato.
- 2 In 7stamp Admin, apri API & Integrations → Webhooks. Aggiungilo URL e seleziona un piccolo insieme di eventi, ad esempio SCAN e REWARD_EARNED.
- 3 Crea una scansione di prova usa e getta o un evento di carta in 7stamp. Ritorna a Make e usa Run once per consentire a Make di determinare la struttura dei dati dell'evento.
- 4 Aggiungi un passaggio di ricerca CRM utilizzando external_id. Aggiungi un filtro o un router su event_type in modo che SCAN, REWARD_EARNED e VOUCHER_ISSUED possano eseguire azioni diverse.
- 5 Aggiungi l'azione CRM update/note. Mappa scanned_at, stamps_after, external_order_id e issued_vouchers solo quando questi campi sono presenti per il tipo di evento selezionato.
Controlla: Mantieni privato il webhook URL. Prova un evento reale prima di attivare messaggi irreversibili, voucher o modifiche CRM.
Ottieni la chiave 7stamp API prima di aprire Make
Queste sono le schermate esatte 7stamp Admin. Crea la chiave una volta, copiala nella connessione sicura HTTP di Make/keychain, quindi rimuovila immediatamente dagli appunti. Schermata
Prepara la connessione prima di creare
Crea una chiave API per ambiente
In 7stamp Admin, vai a API & Integrations → API Keys → Add API Key. Memorizza il valore nella connessione chiave/keychain HTTP API di Make quando tale opzione è disponibile. Non mappare mai la chiave da un campo di testo, inserirla in una nota o utilizzarla in un flusso di lavoro rivolto al browser. Una chiave appartiene a un 7stamp posto di lavoro/profile.
Usa un External ID stabile
Mappa l'immutabile ID dal tuo CRM, POS, o piattaforma commerciale, ad esempio un contatto CRM ID o un cliente UUID. Aggiungi External Source come hubspot, shopify o poster quando lo stesso identificatore potrebbe apparire in più di un sistema.
Decidi quale modello applicare
Quando il profilo 7stamp connesso ha un modello di carta attivo, il modello può essere lasciato vuoto. Con più modelli, mappa o scegli deliberatamente template_id in modo che ogni invito e scansione raggiunga il programma fedeltà previsto.
Configurazione esatta Make HTTP: crea una carta di invito
Copialo nel passaggio di automazione
http Method: POST
URL: https://api.7loc.com/cards-api/cards/invite
Headers:
Authorization: Bearer YOUR_7STAMP_API_KEY
Content-Type: application/json
Body type: Raw / JSON
{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"template_id": 42
}Costruisci e testa il tuo primo scenario Make
In 7stamp Admin, crea una chiave in API & Integrations → API Keys → Add API Key. Utilizza un profilo di prova separato/key quando la configurazione del tuo account lo consente.
In Make, crea uno scenario e aggiungi il trigger sorgente. Eseguilo una volta prima della mappatura in modo da poter vedere un contatto campione reale o un ordine pagato.
Fai clic sul segno più successivo, cerca HTTP e scegli Make una richiesta. Imposta il metodo, completo URL, e le intestazioni dalla scheda operativa in questa pagina.
Utilizza GET https://api.7loc.com/cards-api/templates come prima richiesta. La sua risposta positiva dimostra che la chiave funziona senza modificare i dati del cliente.
Per i percorsi POST, seleziona application/json e incolla la forma del corpo da questa guida. Mappa una stalla External ID; aggiungi template_id solo se il profilo ha più modelli attivi.
Esegui con un contatto usa e getta, ispeziona l'output HTTP e solo allora mappa i suoi campi di risposta esatti nel successivo CRM, email o modulo di messaggistica.
Quando dovresti usare Make HTTP?
Usa HTTP per 7stamp ora: è il percorso documentato e pronto per la produzione, non un fallback ridotto. Sceglilo ogni volta che hai bisogno di un'operazione 7stamp, di un nuovo percorso API o di una connessione POS/ERP personalizzata. Il riferimento OpenAPI è la fonte di verità per il metodo, il percorso completo, il corpo e lo schema di risposta; la chiave al portatore e la base URL rimangono le stesse.
Ricevi eventi 7stamp in Make
Per uno scenario basato sugli eventi, aggiungi Webhooks → Custom webhook e crea un webhook. Copia il suo URL, apri API & Integrations → Webhooks nel profilo 7stamp, incolla URL, seleziona i tipi di evento, salva e invia un evento di prova reale. Il profilo 7stamp possiede quell'abbonamento; l'attuale API non espone gli endpoint automatici di sottoscrizione del webhook/unsubscribe.
Non è richiesto alcun connettore pubblico Make
Le istruzioni in questa pagina utilizzano i moduli Make disponibili per ogni account Make. Se desideri un futuro modulo nativo 7stamp anziché HTTP, inviaci il flusso di lavoro di cui hai bisogno; fino ad allora, HTTP e Custom webhook coprono ogni operazione 7stamp documentata.
Domande frequenti
Non riesco a trovare 7stamp in Make. Posso ancora automatizzarlo?
Sì. Oggi non esiste un'app 7stamp pubblica in Make. Aggiungi HTTP > Make una richiesta, utilizza l'endpoint 7stamp completo URL e invia Authorization: Bearer seguito dalla tua chiave 7stamp API. HTTP può chiamare ogni endpoint documentato.
Dove trovo il token per la connessione Make?
In 7stamp Admin, apri API Integrazioni, quindi API Keys, quindi Add API Key. La chiave ha come ambito il luogo di lavoro/profile che l'ha creata, quindi utilizza un profilo di test per scenari di test quando possibile.
Quale identificatore dovrei mappare come External ID?
Utilizza l'identificatore stabile dal sistema di origine, preferibilmente un contatto CRM ID o un cliente UUID. Non utilizzare un nome visualizzato. Un numero di telefono o un'e-mail possono funzionare, ma possono cambiare e devono essere gestiti in modo coerente.
Come posso inserire gli eventi 7stamp in Make?
Crea un webhook > Custom webhook in Make, quindi incolla il URL generato nelle impostazioni del webhook del profilo 7stamp. Utilizza un filtro o un router Make dopo la consegna per gestire il event_type in entrata.
Passaggio successivo
Pronto per automatizzare la prima azione fedeltà?
Crea la chiave API, prova List Templates e crea uno scenario di invito o scansione con un contatto usa e getta. Aggiungi router e messaggistica solo dopo che il flusso semplice è affidabile.