Integració de desenvolupadors
Envieu tots els esdeveniments de fidelitat des de 7stamp als vostres propis sistemes en temps real. No hi ha enquesta ni trucades programades al API. Els esdeveniments arriben com a sol·licituds HTTPS POST en qüestió de segons.
Utilitzeu els webhooks per mantenir el vostre CRM, ERP o el vostre backend personalitzat sincronitzat amb el que està passant pel costat de la lleialtat: qui es va unir, qui va rebre un segell, qui va bescanviar un val, qui va activar un regal d'aniversari i qui es va quedar inactiu. Aleshores, els vostres sistemes decideixen què fer amb aquestes dades.
Els webhooks són el costat de sortida de la pila d'integració. Reflecteixen l'activitat dels clients i recompensen als sistemes en què ja confieu per a vendes, servei, anàlisi i missatgeria.
Cada segell, val, aniversari i activador d'inactivitat arriba al registre del client al vostre CRM. Veu la cronologia de fidelització completa al costat de vendes, trucades i entrades sense iniciar sessió a 7stamp.
Quan un client bescanvi un val, envieu un agraïment SMS des de la vostra passarel·la SMS existent. Quan un client aconsegueix l'objectiu, publica una celebració a Slack. Quan algú es torna inactiu, envieu el cas al vostre gestor de comptes.
Transmet els esdeveniments a la vostra eina BI, magatzem o canalització de conciliació. Relaciona els bescanvis de vals amb els rebuts POS i calcula la fidelitat ROI amb les teves pròpies mètriques.
El vostre punt final hauria d'acceptar HTTPS POST, validar la forma de sol·licitud, persistir o posar en cua l'esdeveniment i, a continuació, retornar una resposta 2xx correcta. No feu una trucada lenta CRM o de missatgeria abans de l'avís si es pot posar a la cua de manera segura.
Tots els esdeveniments relacionats poden incloure el External ID i el External Source opcional que heu utilitzat en crear o escanejar la targeta. Utilitzeu aquest parell per actualitzar el vostre propi CRM, POS o el registre de la comanda sense endevinar el nom o el correu electrònic.
Emmagatzemeu una clau de processament duradora o una empremta digital d'esdeveniment abans d'activar efectes secundaris. Si el vostre destinatari torna a veure el mateix lliurament, no hauria d'afegir cap nota, val o missatge duplicat CRM. Tracta el punt final URL com un secret.
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"
}Creeu un punt final HTTPS al vostre backend, CRM capa d'integració, CRM o Make496. Catch Hook. Make assegureu-vos que controleu la destinació abans de copiar-ne el URL.
A 7stamp Admin, obre Stamp Cards → API & Integrations → Webhooks.
Afegiu el punt final URL i seleccioneu només els tipus d'esdeveniments que realment necessita el flux de treball receptor.
Deseu la configuració del perfil i, a continuació, activeu una prova d'exploració d'un sol ús o una acció de targeta per produir un esdeveniment.
Inspeccioneu la càrrega útil rebuda. Relacioneu External ID i External Source amb el registre esperat i confirmeu que el receptor retorna una resposta correcta.
Habiliteu CRM, el val o els efectes secundaris de missatgeria només després d'haver gestionat i supervisat els errors amb seguretat per a la reproducció.
A Make, utilitzeu Webhooks → Custom webhook per generar un URL de recepció i enganxeu-lo al perfil 7stamp. A Zapier, utilitzeu Webhooks by Zapier → Catch Hook amb el mateix propòsit. El perfil 7stamp és el propietari de la subscripció perquè el API actual no exposa els punts finals de registre automàtic del webhook.
Utilitzeu la secció Webhooks de la referència pública OpenAPI com a font per a l'esquema de càrrega útil actual i el significat del camp. Exigir HTTPS, mantenir el receptor URL fora dels registres públics i fer que el processament sigui idempotent. Confirmeu el procediment de sol·licitud d'autenticació/signature per al vostre perfil 7stamp durant la incorporació abans d'aplicar un nom de capçalera específic o una política de reintentar en producció.
Sí. Seleccioneu els tipus d'esdeveniments a la configuració del webhook del perfil 7stamp perquè el receptor només rebi els esdeveniments importants per al seu flux de treball.
Creeu el webhook receptor a Make o un Catch Hook a Zapier, copieu el URL generat, després enganxeu-lo a la configuració del webhook del perfil 7stamp i envieu un esdeveniment de prova.
Utilitzeu External ID i, quan estigui present, External Source. Aquests són els identificadors que va proporcionar la vostra integració quan es va crear o escanejar la targeta.
No. Utilitzeu el contracte de lliurament actual OpenAPI/profile i confirmeu el procediment d'autenticació del vostre perfil durant la incorporació abans de codificar una capçalera o tornar a intentar-ho.
Pàgines relacionades
Següent pas
Creeu un receptor, enganxeu el seu HTTPS URL al perfil, feu una exploració d'un sol ús i valideu el External ID coincident abans d'habilitar l'automatització posterior.