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.
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.
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 {
"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
}
}
}Nakonfigurujte a otestujte webhook
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.
V 7Stamp Admin otvorte Stamp Cards → API & Integrations → Webhooks.
Pridajte URL koncového bodu. Webhook prijíma všetky udalosti kariet profilu, preto filtrujte podľa data.event_type vo svojom prijímači.
Uložte nastavenia profilu a potom spustite jednorazové testovacie skenovanie alebo akciu karty na vytvorenie udalosti.
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ď.
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í
Ako zdroj aktuálnej schémy dát použite sekciu Webhooks vo verejnej referencii OpenAPI. Telo požiadavky je obálka: profile_id a profile_name označujú profil 7Stamp, event_id identifikuje udalosť a samotná udalosť karty je v data (pri URL z Make alebo Zapier je kľúčom card_event). Každé doručenie je podpísané v jednej hlavičke, X-Webhook-Signature: t=…,s=…. Vypočítajte HMAC-SHA256 z t spojeného so surovým telom požiadavky pomocou tajného kľúča webhooku, zakódujte výsledok do hex a porovnajte ho s hodnotou s; tajný kľúč nájdete na stránke webhooku v 7Stamp Admin. Pomocou X-Webhook-Event-Id zahadzujte opakované doručenia: opakovaný pokus sa podpisuje znova s novým t. Koncový bod môžete chrániť aj pomocou Basic Auth. Vyžadujte HTTPS a nedovoľte, aby sa URL prijímača dostala do verejných logov.
Často kladené otázky
Môžem vybrať iba určité udalosti webhooku?
Nie. Webhook 7Stamp prijíma všetky udalosti kariet profilu. Filtrujte podľa data.event_type vo svojom prijímači; v Make a Zapier prichádza udalosť v card_event, preto filtrujte podľa card_event.event_type.
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 data.external_id a, ak je k dispozícii, data.external_source: vracajú sa v každom webhooku pre karty, ktoré ste vydali cez API s vlastným ID. Zákazník, ktorý si kartu vzal sám, nemá External ID, preto ho priraďte podľa data.user.email. Adresa Apple „Hide My Email“ je preposielacia adresa, nie tá, ktorú máte v CRM.
Ako overím, že webhook prišiel od 7Stamp?
Rozdeľte hlavičku X-Webhook-Signature na t a s, vypočítajte HMAC-SHA256 z t spojeného so surovým telom požiadavky pomocou tajného kľúča webhooku z 7Stamp Admin, zakódujte výsledok do hex a porovnajte ho s hodnotou s. Hodnotu t použite presne tak, ako bola odoslaná, a telo ako prijaté surové bajty, ešte pred akýmkoľvek parsovaním JSON. Zahoďte doručenie, ktorého X-Webhook-Event-Id ste už spracovali: opakovaný pokus sa podpisuje znova s novým t.
Súvisiace stránky
Ď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.