Fejlesztői integráció

7stamp Webhooks

Elérhető

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.

Mit tehet a webhookkal

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.

A hűségtörténet tükrözése a CRM számban

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.

Indítsa el saját üzenetküldési kötegét

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.

Teljesítményelemzés és egyeztetés

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.

Kártya eseménytípusai

SCAN — A kártya beolvasási/stamp műveletet kapott.
REWARD_EARNED — Jutalmat szereztek a kártyán.
VOUCHER_ISSUED — Utalványt bocsátottak ki.
VOUCHER_REDEEMED — Az utalványt beváltották.
LOTTERY_WIN — Egy lottó nyert.
DELIVERY_INSERT — Szállítási-betét áramlást rögzítettek.
CARD_JOINED — Egy ügyfél csatlakozott egy kártyához.
CARD_CAMPAIGN — Kártyakampány esemény történt.
BIRTHDAY_GREETING — Születésnapi üdvözlő esemény történt.
ADMIN_VOUCHER_ISSUE — Egy rendszergazda utalványt állított ki.
CARD_ADDED_TO_WALLET — Egy ügyfél hozzáadta a kártyát a pénztárcájához.
CARD_REMOVED_FROM_WALLET — Egy ügyfél kivette a kártyát a pénztárcájából.

Készítsen biztonságos webhook-vevőt

Nyugtázás a tartós kezelés után

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ó.

Összefüggés a következővel: External ID

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.

Make szállítás idempotens

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.

Példa esemény hasznos adat alakzatára

Másolja ezt az automatizálási lépésbe 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"
}

Webhook konfigurálása és tesztelése

01

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.

02

A 7stamp Admin mappában nyissa meg a Stamp Cards → API & Integrations → Webhooks számot.

03

Adja hozzá a URL végpontot, és csak azokat az eseménytípusokat válassza ki, amelyekre a fogadó munkafolyamatnak ténylegesen szüksége van.

04

Mentse el a profilbeállításokat, majd indítson el eldobható tesztvizsgálatot vagy kártyaműveletet esemény létrehozásához.

05

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.

06

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.

Kód nélküli opciók: Make és Zapier

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.

Biztonsági és szállítási szerződés

Használja a nyilvános OpenAPI hivatkozás Webhooks szakaszát az aktuális hasznos terhelési séma és a mező jelentésének forrásaként. A HTTPS megkövetelése, a URL vevő ne kerüljön a nyilvános naplókba, és tegye idempotenssé a feldolgozást. Erősítse meg a kérés-hitelesítési/signature eljárást a 7stamp profiljához a csatlakozás során, mielőtt egy adott fejlécnév vagy újrapróbálkozási szabályzat érvényre juttatása éles környezetben történik.

Gyakran ismételt kérdések

Kiválaszthatok csak bizonyos webhook eseményeket?

Igen. Válassza ki az eseménytípusokat a 7stamp profil webhook-beállításaiban, hogy a fogadó csak azokat az eseményeket kapja meg, amelyek fontosak a munkafolyamat szempontjából.

Hogyan csatlakoztathatom a webhookot a Make vagy a Zapier számhoz?

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.

Hogyan társíthatok egy eseményt a CRM névjegyhez?

Használja a External ID és ha van, az External Source kódot. Ezek azok az azonosítók, amelyeket az integráció adott a kártya létrehozásakor vagy beolvasásakor.

Aláírás fejlécét feltételezzem, vagy újrapróbálkozzunk?

Nem. Használja a jelenlegi OpenAPI/profile szállítási szerződést, és erősítse meg a profil hitelesítési eljárását a beléptetés során, mielőtt kódolna egy fejlécet vagy próbálkozna újra.

Következő lépés

Készen áll az első kártyaesemény elküldésére?

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.