Fejlesztői integráció
A 7Stamp számról minden hűségeseményt valós időben küldjön saját rendszerére. Nincs lekérdezés és nincs ütemezett API hívás. Az események HTTPS POST kérésként érkeznek a megtörténést követő másodperceken belül.
Webhook használatával tartsa szinkronban CRM, ERP vagy egyéni hátterét a hűségoldalon zajló eseményekkel: ki csatlakozott, ki kapott bélyeget, ki váltott be utalványt, ki váltott ki születésnapi ajándékot és ki vált inaktívvá. Ezután a rendszer dönti el, hogy mit tegyen ezekkel az adatokkal.
A webhookok az integrációs verem kimenő oldalát jelentik. Ezek tükrözik az ügyfelek és a jutalmazási tevékenységeket azokban a rendszerekben, amelyekben már megbízik az értékesítés, a szolgáltatás, az elemzés és az üzenetküldés terén.
Minden bélyeg, utalvány, születésnap és inaktivitási aktiváló a CRM ügyfélrekordban landol. A teljes hűségidővonalat az értékesítések, hívások és jegyek mellett láthatja, anélkül, hogy bejelentkezne a 7Stamp címre.
Amikor egy ügyfél bevált egy utalványt, küldjön egy köszönetet SMS a meglévő SMS átjáróról. Amikor egy ügyfél eléri a célt, tegyen közzé ünneplést a Slack címen. Ha valaki inaktívvá válik, irányítsa az ügyet a fiókkezelőhöz.
Streamelje az eseményeket BI eszközébe, raktárába vagy egyeztetési folyamatába. Párosítsa az utalvány beváltásait az POS nyugtákkal, és számítsa ki a ROI hűséget a saját mutatóiban.
A végpontnak el kell fogadnia a HTTPS POST kódot, érvényesítenie kell a kérés alakját, meg kell őriznie vagy sorba kell helyeznie az eseményt, majd sikeres 2xx választ kell visszaküldenie. Ne kezdeményezzen lassú CRM vagy üzenetküldő hívást a nyugtázás előtt, ha az biztonságosan sorba állítható.
Minden kapcsolódó esemény hordozhatja a External ID és az opcionális External Source azonosítót, amelyet a kártya létrehozásakor vagy beolvasásakor használt. Ezzel a párral frissítheti saját CRM, POS számát vagy megrendelheti rekordját anélkül, hogy névből vagy e-mailből tippelne.
A mellékhatások kiváltása előtt tároljon tartós feldolgozási kulcsot vagy eseményujjlenyomatot. Ha a címzett ismét ugyanazt a kézbesítést látja, ne vegyen fel ismétlődő CRM jegyzetet, utalványt vagy üzenetet. Kezelje titokként a URL végpontot.
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
}
}
}Hozzon létre egy HTTPS végpontot a háttérben, CRM integrációs rétegben, ⟦16056 vagy webhook-ban Zapier Catch Hook. Make győződjön meg róla, hogy Ön szabályozza a célhelyet, mielőtt másolja a URL-t.
A 7Stamp Admin mappában nyissa meg a Stamp Cards → API & Integrations → Webhooks számot.
Adja hozzá a végpont URL-jét. A webhook a profil minden kártyaeseményét megkapja, ezért a fogadó oldalon szűrjön data.event_type szerint.
Mentse el a profilbeállításokat, majd indítson el eldobható tesztvizsgálatot vagy kártyaműveletet esemény létrehozásához.
Vizsgálja meg a kapott hasznos terhet. Illessze a External ID és External Source számokat a várt rekordhoz, és ellenőrizze, hogy a vevő sikeres választ ad-e vissza.
Csak azután engedélyezze a CRM, utalvány vagy üzenetküldési mellékhatásokat, miután az újrajátszást biztonságosan kezeli és figyeli a hibákat.
A Make mezőben használja a Webhooks → Custom webhook jelet egy fogadó URL létrehozásához, és illessze be a 7Stamp profilba. A Zapier esetén használja a Webhooks by Zapier → Catch Hook kódot ugyanerre a célra. A 7Stamp profil birtokolja az előfizetést, mert a jelenlegi API nem teszi közzé az automatikus webhook regisztrációs végpontokat.
A hasznos adatok aktuális sémájának forrásaként a nyilvános OpenAPI referencia Webhooks szakaszát használja. A törzs egy boríték: a profile_id és a profile_name a 7Stamp profilt nevezi meg, az event_id az eseményt azonosítja, maga a kártyaesemény pedig a data mezőben van (Make vagy Zapier URL esetén a kulcs card_event). Minden kézbesítés egyetlen fejlécben van aláírva, X-Webhook-Signature: t=…,s=…. Számítson HMAC-SHA256 értéket a webhook titkos kulcsával a t és a nyers kéréstörzs összefűzéséből, kódolja hexadecimálisan, és vesse össze az s értékkel; a titkos kulcs a 7Stamp Admin felületén, a webhook oldalán található. Az ismételt kézbesítéseket az X-Webhook-Event-Id alapján dobja el: az újrapróbálkozás új t értékkel kap újra aláírást. A végpontot Basic Auth segítségével is védheti. Követelje meg a HTTPS-t, és ne engedje, hogy a fogadó URL-je nyilvános naplókba kerüljön.
Nem. A 7Stamp webhook a profil minden kártyaeseményét megkapja. A fogadó oldalon data.event_type szerint szűrjön; a Make-ben és a Zapier-ben az esemény a card_event alatt érkezik, ezért ott card_event.event_type szerint szűrjön.
Hozza létre a fogadó webhookot a Make vagy egy Catch Hook a Zapier helyen, másolja a generált URL-t, majd illessze be a 7Stamp profil webhook-beállításaiba, és küldjön egy teszteseményt.
Használja a data.external_id és – ha van – a data.external_source mezőt: ezek minden webhookban visszaérkeznek azoknál a kártyáknál, amelyeket saját azonosítóval az API-n keresztül adott ki. Annak az ügyfélnek, aki saját maga szerezte meg a kártyát, nincs External ID-ja, ezért őt a data.user.email alapján párosítsa. Egy Apple „Hide My Email” cím továbbító cím, nem az, amely a CRM-ben szerepel.
Bontsa az X-Webhook-Signature fejlécet t és s részre, számítson HMAC-SHA256 értéket a 7Stamp Admin felületéről kapott webhook titkos kulccsal a t és a nyers kéréstörzs összefűzéséből, kódolja hexadecimálisan, és vesse össze az s értékkel. A t értéket pontosan úgy használja, ahogy elküldték, a törzset pedig a fogadott nyers bájtokként, még bármilyen JSON-feldolgozás előtt. Dobja el azt a kézbesítést, amelynek X-Webhook-Event-Id azonosítóját már feldolgozta: az újrapróbálkozás új t értékkel kap újra aláírást.
Kapcsolódó oldalak
Következő lépés
Hozzon létre egy vevőt, illessze be a HTTPS URL számot a profilba, futtasson egy eldobható vizsgálatot, és érvényesítse a megfelelő External ID-t, mielőtt engedélyezné a downstream automatizálást.