Integrazione per sviluppatori
Invia ogni evento fedeltà da 7stamp ai tuoi sistemi in tempo reale. Nessun sondaggio e nessuna chiamata programmata API. Gli eventi arrivano come richieste HTTPS POST entro pochi secondi dall'accadimento.
Usa i webhook per mantenere il tuo CRM, ERP o il backend personalizzato sincronizzato con ciò che sta accadendo dal lato fedeltà: chi si è iscritto, chi ha ricevuto un timbro, chi ha riscattato un buono, chi ha attivato un regalo di compleanno e chi è diventato inattivo. Quindi i tuoi sistemi decidono cosa fare con quei dati.
I webhook sono il lato in uscita dello stack di integrazione. Rispecchiano l'attività dei clienti e dei premi nei sistemi di cui già ti fidi per vendite, assistenza, analisi e messaggistica.
Ogni timbro, voucher, compleanno e attivazione di inattività arriva sul record del cliente nel tuo CRM. Puoi vedere la cronologia completa del programma fedeltà accanto alle vendite, alle chiamate e ai biglietti senza accedere a 7stamp.
Quando un cliente riscatta un voucher, invia un ringraziamento SMS dal tuo gateway SMS esistente. Quando un cliente raggiunge l'obiettivo, pubblica un festeggiamento in Slack. Quando qualcuno diventa inattivo, inoltra il caso al tuo account manager.
Trasmetti eventi nel tuo strumento BI, nel magazzino o nella pipeline di riconciliazione. Confronta i riscatti dei voucher con le ricevute POS e calcola la fedeltà ROI secondo i tuoi parametri.
Il tuo endpoint dovrebbe accettare HTTPS POST, convalida la forma della richiesta, persiste o accoda l'evento, quindi restituisce una risposta 2xx riuscita. Non effettuare una chiamata lenta al CRM o un messaggio prima della conferma se è possibile metterla in coda in modo sicuro.
Ogni evento correlato può contenere External ID e External Source opzionale che hai utilizzato durante la creazione o la scansione della carta. Utilizza questa coppia per aggiornare il tuo CRM, POS o il record dell'ordine senza indovinare da un nome o da un'e-mail.
Memorizza una chiave di elaborazione durevole o un'impronta digitale dell'evento prima di attivare effetti collaterali. Se il destinatario vede di nuovo la stessa consegna, non dovrebbe aggiungere una nota, un voucher o un messaggio CRM duplicato. Tratta l'endpoint URL come un segreto.
json {
"event_type": "SCAN",
"scanned_at": "2026-07-23T12:34:56Z",
"user_card_id": 123,
"card_template_id": 42,
"card_template_name": "Coffee Loyalty",
"stamps_added": 1,
"stamps_before": 4,
"stamps_after": 5,
"amount": 24.5,
"external_order_id": "order_2048",
"external_id": "crm_contact_8821",
"external_source": "hubspot"
}Crea un endpoint HTTPS nel tuo backend, livello di integrazione CRM, webhook Make o Zapier Catch Hook. Make assicurati di controllare la destinazione prima di copiarne URL.
In 7stamp Admin, apri Stamp Cards → API & Integrations → Webhooks.
Aggiungi l'endpoint URL e seleziona solo i tipi di eventi effettivamente necessari al flusso di lavoro di ricezione.
Salva le impostazioni del profilo, quindi attiva una scansione di prova usa e getta o un'azione della scheda per produrre un evento.
Ispeziona il carico utile ricevuto. Abbina External ID e External Source al record previsto e conferma che il ricevitore restituisce una risposta positiva.
Abilita CRM, voucher o effetti collaterali dei messaggi solo dopo aver gestito e monitorato gli errori in modo replay-safe.
In Make, usa Webhooks → Custom webhook per generare una ricezione URL e incollala in 7stamp profilo. In Zapier, utilizzare Webhooks by Zapier → Catch Hook per lo stesso scopo. Il profilo 7stamp possiede la sottoscrizione perché l'attuale API non espone endpoint di registrazione automatica del webhook.
Utilizza la sezione Webhooks del riferimento pubblico OpenAPI come fonte per lo schema del payload corrente e il significato del campo. Richiedi HTTPS, mantieni il ricevitore URL fuori dai log pubblici e rendi l'elaborazione idempotente. Conferma la procedura di autenticazione della richiesta/signature per il tuo profilo 7stamp durante l'onboarding prima di applicare un nome di intestazione specifico o una policy di nuovo tentativo in produzione.
Sì. Seleziona i tipi di eventi nelle impostazioni del webhook del profilo 7stamp in modo che il destinatario riceva solo gli eventi importanti per il suo flusso di lavoro.
Crea il webhook ricevente in Make o un Catch Hook in Zapier, copia il URL generato, quindi incollalo nelle impostazioni del webhook del profilo 7stamp e invia un evento di prova.
Utilizzare External ID e, quando presente, External Source. Questi sono gli identificatori forniti dall'integrazione al momento della creazione o della scansione della carta.
No. Utilizza l'attuale contratto di consegna OpenAPI/profile e conferma la procedura di autenticazione per il tuo profilo durante l'onboarding prima di codificare un'intestazione o riprovare.
Pagine correlate
Passaggio successivo
Crea un ricevitore, incolla il suo HTTPS URL nel profilo, esegui una scansione usa e getta e convalida il External ID corrispondente prima di abilitare l'automazione a valle.