Integrácia vývojárov

7stamp Webhooky

Dostupné

Posuňte každú vernostnú udalosť od 7stamp do svojich systémov v reálnom čase. Žiadne hlasovanie a žiadne plánované API hovory. Udalosti prichádzajú ako požiadavky HTTPS POST v priebehu niekoľkých sekúnd od ich vzniku.

Použite webhooky na synchronizáciu vášho CRM, ERP alebo vlastného backendu s tým, čo sa deje na vernostnej strane: kto sa pridal, kto získal pečiatku, kto uplatnil poukážku, kto spustil darček k narodeninám a kto sa stal neaktívnym. Potom sa vaše systémy rozhodnú, čo s týmito údajmi urobia.

Čo môžete robiť s webhookmi

Webhooky sú odchádzajúcou stranou integračného zásobníka. Odrážajú aktivitu zákazníkov a odmeňovania do systémov, ktorým už dôverujete v oblasti predaja, služieb, analýz a správ.

Zrkadlite históriu lojality do svojho CRM

Každá známka, poukážka, narodeniny a spúšťač nečinnosti sa zobrazí v zázname zákazníka vo vašom CRM. Úplnú časovú os lojality vidíte vedľa predajov, hovorov a lístkov bez prihlásenia do 7stamp.

Spustite svoj vlastný zásobník správ

Keď zákazník uplatní kupón, pošlite mu poďakovanie SMS z vašej existujúcej brány SMS. Keď zákazník dosiahne cieľ, uverejnite oslavu na Slack. Keď sa niekto stane neaktívnym, pošlite prípad svojmu správcovi účtu.

Analytika výkonu a zosúlaďovanie

Streamujte udalosti do svojho nástroja BI, skladu alebo procesu vyrovnania. Porovnajte preplatenia kupónov s POS potvrdenkami a vypočítajte si vernosť ROI vo svojich vlastných metrikách.

Typy udalostí karty

SCAN — Karta prijala akciu skenovania/stamp.
REWARD_EARNED — Na karte bola získaná odmena.
VOUCHER_ISSUED — Bol vydaný poukaz.
VOUCHER_REDEEMED — Poukážka bola uplatnená.
LOTTERY_WIN — Výsledkom lotérie bola výhra.
DELIVERY_INSERT — Bol zaznamenaný tok dodávky a vložky.
CARD_JOINED — Zákazník sa pripojil ku karte.
CARD_CAMPAIGN — Vyskytla sa udalosť kartovej kampane.
BIRTHDAY_GREETING — Nastala udalosť blahoželania k narodeninám.
ADMIN_VOUCHER_ISSUE — Administrátor vydal poukaz.
CARD_ADDED_TO_WALLET — Zákazník si pridal kartu do svojej peňaženky.
CARD_REMOVED_FROM_WALLET — Zákazník vybral kartu zo svojej peňaženky.

Zostavte si bezpečný prijímač webhooku

Potvrdiť po trvanlivom zaobchádzaní

Váš koncový bod by mal akceptovať HTTPS POST, overiť tvar požiadavky, pretrvávať alebo zaradiť udalosť do frontu a potom vrátiť úspešnú odpoveď 2xx. Neuskutočňujte pomalé CRM alebo volanie správ pred potvrdením, ak sa dá bezpečne zaradiť do frontu.

Korelovať s External ID

Každá súvisiaca udalosť môže obsahovať External ID a voliteľné External Source, ktoré ste použili pri vytváraní alebo skenovaní karty. Pomocou tohto páru aktualizujte svoje vlastné CRM, POS alebo záznam objednávky bez hádania z mena alebo e-mailu.

Make dodávka idempotentná

Pred spustením vedľajších účinkov si uložte odolný kľúč spracovania alebo odtlačok udalosti. Ak váš príjemca znova uvidí tú istú dodávku, nemal by pridať duplikát CRM poznámky, poukazu alebo správy. S koncovým bodom URL zaobchádzajte ako s tajomstvom.

Príklad tvaru užitočného zaťaženia udalosti

Skopírujte to do svojho kroku automatizácie 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"
}

Nakonfigurujte a otestujte webhook

01

Vytvorte koncový bod HTTPS vo vašom backende, CRM integračnú vrstvu, ⟧82584 alebo 4584 webhook Catch Hook. Make uistite sa, že ovládate cieľ pred kopírovaním jeho URL.

02

V 7stamp Admin otvorte Stamp Cards → API & Integrations → Webhooks.

03

Pridajte koncový bod URL a vyberte iba typy udalostí, ktoré pracovný tok príjemcu skutočne potrebuje.

04

Uložte nastavenia profilu a potom spustite jednorazové testovacie skenovanie alebo akciu karty na vytvorenie udalosti.

05

Skontrolujte prijaté užitočné zaťaženie. Priraďte External ID a External Source k očakávanému záznamu a potvrďte, že prijímač vráti úspešnú odpoveď.

06

Povoľte CRM, poukážku alebo nežiaduce účinky správ len vtedy, keď budete mať zabezpečenú manipuláciu a monitorovanie zlyhaní.

Možnosti bez kódu: Make a Zapier

V Make použite Webhooks → Custom webhook na vygenerovanie prijímajúceho URL a vložte ho do profilu 7stamp. V Zapier použite Webhooks by Zapier → Catch Hook na rovnaký účel. Profil 7stamp vlastní predplatné, pretože aktuálny API nevystavuje automatické koncové body registrácie webhooku.

Zmluva o zabezpečení a dodaní

Použite sekciu Webhooks verejnej OpenAPI referencie ako zdroj pre aktuálnu schému užitočného zaťaženia a význam poľa. Vyžadujte HTTPS, držte prijímač URL mimo verejných protokolov a urobte spracovanie idempotentné. Potvrďte procedúru overenia žiadosti/signature pre váš profil 7stamp počas registrácie pred vynútením konkrétneho názvu hlavičky alebo politiky zopakovania v produkcii.

Často kladené otázky

Môžem vybrať iba určité udalosti webhooku?

Áno. Vyberte typy udalostí v nastaveniach webhooku profilu 7stamp, aby prijímač dostal iba udalosti, ktoré sú dôležité pre jeho pracovný tok.

Ako pripojím webhooky k Make alebo Zapier?

Vytvorte prijímajúci webhook v Make alebo Catch Hook v Zapier, skopírujte vygenerovaný URL, potom ho vložte do profilu 7stamp a odošlite nastavenia testovacieho webhooku.

Ako mám priradiť udalosť k môjmu kontaktu CRM?

Použite External ID a ak existuje, External Source. Toto sú identifikátory, ktoré vaša integrácia poskytla pri vytváraní alebo skenovaní karty.

Mám predpokladať hlavičku podpisu alebo opakovať načasovanie?

Nie. Použite aktuálnu zmluvu o dodaní OpenAPI/profile a potvrďte autentifikačnú procedúru pre svoj profil počas registrácie pred pevným kódovaním hlavičky alebo opakovaním predpokladu.

Ďalší krok

Ste pripravení odoslať prvú udalosť karty?

Vytvorte prijímač, vložte jeho HTTPS URL do profilu, spustite skenovanie na jedno použitie a overte zhodu External ID predtým, ako povolíte automatizáciu.