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 {
"entity": "card_event",
"action": "created",
"entity_id": 707,
"event_id": "8f05e58decec48e09d328f0edebbacf6",
"profile_id": 2,
"profile_name": "Your Business",
"profile_lang": "en",
"data": {
"event_type": "SCAN",
"scanned_at": "2026-10-01T09:19:24.179424",
"user_card_id": 10,
"card_template_id": 14,
"card_template_name": "Collect your stamps!",
"stamps_added": 3,
"stamps_before": 1,
"stamps_after": 4,
"amount": null,
"external_order_id": "ORDER-1001",
"workplace": { "id": 4, "name": "Bar Counter" },
"device_type": null,
"external_id": "odoo_contact_8821",
"external_source": "odoo",
"issued_vouchers": [
{
"id": 174,
"unique_code": "100425813507",
"stamp_number": 4,
"issued_at": "2026-10-01T09:19:24.191836",
"expires_at": "2027-01-01T23:59:59",
"status": "ACTIVE",
"voucher_template_id": 58,
"voucher_description": "Free coffee",
"voucher_image_url": "https://..."
}
],
"achieved_goals": [],
"user": {
"id": 2,
"name": "Anna",
"full_name": "Anna Smith",
"email": "anna@example.com",
"telegram_chat_id": null,
"telegram_username": null,
"whatsapp_phone": null,
"birth_date": null
}
}
}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 l'URL de l'endpoint. El webhook rep tots els esdeveniments de targeta del perfil, així que filtreu per data.event_type al vostre 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 d'OpenAPI com a font de l'esquema actual de la càrrega útil. El cos és un sobre: profile_id i profile_name indiquen el perfil de 7Stamp, event_id identifica l'esdeveniment i l'esdeveniment de targeta en si és a data (per a un URL de Make o Zapier, la clau és card_event). Cada lliurament va signat en una sola capçalera, X-Webhook-Signature: t=…,s=…. Calculeu l'HMAC-SHA256 amb el secret del vostre webhook sobre t més el cos brut de la sol·licitud, codifiqueu-lo en hexadecimal i compareu-lo amb s; el secret és a la pàgina del webhook a 7Stamp Admin. Utilitzeu X-Webhook-Event-Id per descartar lliuraments repetits: un reintent es torna a signar amb un t nou. També podeu protegir l'endpoint amb Basic Auth. Exigiu HTTPS i mantingueu l'URL del receptor fora dels registres públics.
No. Un webhook de 7Stamp rep tots els esdeveniments de targeta del perfil. Filtreu per data.event_type al vostre receptor; a Make i Zapier l'esdeveniment arriba dins de card_event, així que filtreu per card_event.event_type.
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 data.external_id i, quan hi sigui, data.external_source: tornen en cada webhook de les targetes que heu emès a través de l'API amb el vostre propi ID. Un client que ha obtingut la targeta pel seu compte no té External ID, així que identifiqueu-lo per data.user.email. Una adreça «Hide My Email» d'Apple és una adreça de reenviament, no la que teniu al CRM.
Separeu la capçalera X-Webhook-Signature en t i s, calculeu l'HMAC-SHA256 amb el secret del webhook de 7Stamp Admin sobre t més el cos brut de la sol·licitud, codifiqueu-lo en hexadecimal i compareu-lo amb s. Preneu t exactament tal com s'ha enviat i el cos com els bytes bruts rebuts, abans de qualsevol anàlisi del JSON. Descarteu un lliurament amb un X-Webhook-Event-Id que ja hàgiu processat: un reintent es torna a signar amb un t nou.
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.