Vývojářská integrace
Přeneste každou věrnostní událost z 7Stamp do svých vlastních systémů v reálném čase. Žádné dotazování a žádná naplánovaná volání API. Události přicházejí jako požadavky HTTPS POST během několika sekund poté, co se staly.
Pomocí webhooků udržujte své CRM, ERP nebo vlastní backend v synchronizaci s tím, co se děje na věrnostní straně: kdo se připojil, kdo získal razítko, kdo uplatnil voucher, kdo spustil narozeninový dárek a kdo se stal neaktivním. Potom se vaše systémy rozhodnou, co s těmito daty udělat.
Webhooky jsou odchozí stranou integračního zásobníku. Odrážejí aktivity zákazníků a odměňování do systémů, kterým již důvěřujete v oblasti prodeje, služeb, analýz a zasílání zpráv.
Každé razítko, voucher, narozeniny a spouštěč nečinnosti se objeví v záznamu zákazníka ve vašem CRM. Úplnou časovou osu věrnosti vidíte vedle prodejů, hovorů a vstupenek, aniž byste se museli přihlašovat na 7Stamp.
Když zákazník uplatní voucher, pošlete mu poděkování SMS z vaší stávající brány SMS. Když zákazník dosáhne cíle, zveřejněte oslavu na Slack. Když se někdo stane neaktivním, předejte případ svému správci účtu.
Streamujte události do vašeho nástroje BI, skladu nebo kanálu pro odsouhlasení. Porovnejte uplatnění voucherů s účtenkami POS a vypočítejte si věrnost ROI ve svých vlastních metrikách.
Váš koncový bod by měl přijmout HTTPS POST, ověřit tvar požadavku, přetrvat nebo zařadit událost do fronty a poté vrátit úspěšnou odpověď 2xx. Před potvrzením neprovádějte pomalé CRM nebo zasílání zpráv, pokud je lze bezpečně zařadit do fronty.
Každá související událost může nést External ID a volitelné External Source, které jste použili při vytváření nebo skenování karty. Pomocí tohoto páru můžete aktualizovat své vlastní CRM, POS nebo záznam objednávky, aniž byste museli hádat ze jména nebo e-mailu.
Před spuštěním vedlejších efektů si uložte odolný klíč pro zpracování nebo otisk události. Pokud váš příjemce znovu uvidí stejnou dodávku, neměl by přidat duplikát CRM poznámky, poukazu nebo zprávy. Považujte koncový bod URL za tajný.
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
}
}
}Create an HTTPS endpoint in your backend, CRM integration layer, Make webhook, or Zapier Catch Hook. Make ujistěte se, že před zkopírováním jeho URL ovládáte cíl.
V 7Stamp Admin otevřete Stamp Cards → API & Integrations → Webhooks.
Přidejte URL endpointu. Webhook přijímá všechny události karet v profilu, proto filtrujte podle data.event_type ve svém přijímači.
Uložte nastavení profilu a poté spusťte jednorázové testovací skenování nebo akci karty k vytvoření události.
Zkontrolujte přijaté užitečné zatížení. Porovnejte External ID a External Source s očekávaným záznamem a potvrďte, že přijímač vrátí úspěšnou odpověď.
Povolte vedlejší efekty CRM, poukázky nebo zasílání zpráv pouze poté, co budete mít k dispozici bezpečnou manipulaci a sledování chyb.
V Make použijte Webhooks → Custom webhook k vygenerování přijímajícího URL a vložte jej do profilu 7Stamp. V Zapier použijte Webhooks by Zapier → Catch Hook pro stejný účel. Profil 7Stamp vlastní předplatné, protože aktuální API nevystavuje koncové body automatické registrace webhooku.
Jako zdroj aktuálního schématu payloadu použijte sekci Webhooks ve veřejné referenci OpenAPI. Tělo je obálka: profile_id a profile_name určují profil 7Stamp, event_id identifikuje událost a samotná událost karty je v data (u URL z Make nebo Zapier je klíčem card_event). Každé doručení je podepsané v jediné hlavičce, X-Webhook-Signature: t=…,s=…. Pomocí tajného klíče svého webhooku vypočítejte HMAC-SHA256 z t spojeného s nezpracovaným tělem požadavku, zakódujte ho do hex a porovnejte s hodnotou s; tajný klíč najdete na stránce webhooku v 7Stamp Admin. Pomocí X-Webhook-Event-Id zahazujte opakovaná doručení: opakovaný pokus je znovu podepsán s novým t. Endpoint můžete chránit také pomocí Basic Auth. Vyžadujte HTTPS a nepouštějte URL přijímače do veřejných logů.
Ne. Webhook 7Stamp přijímá všechny události karet v profilu. Filtrujte podle data.event_type ve svém přijímači; v Make a Zapier přichází událost pod card_event, proto filtrujte podle card_event.event_type.
Vytvořte přijímající webhook v Make nebo Catch Hook v Zapier, zkopírujte vygenerovaný URL, vložte jej do profilu nastavení události 7Stamp a test.
Použijte data.external_id a, pokud je k dispozici, i data.external_source: vracejí se v každém webhooku u karet, které jste vydali přes API s vlastním ID. Zákazník, který si kartu vzal sám, External ID nemá, proto ho párujte podle data.user.email. Adresa „Hide My Email“ od Apple je přesměrovací adresa, ne ta, kterou máte v CRM.
Rozdělte hlavičku X-Webhook-Signature na t a s, pomocí tajného klíče webhooku z 7Stamp Admin vypočítejte HMAC-SHA256 z t spojeného s nezpracovaným tělem požadavku, zakódujte ho do hex a porovnejte s hodnotou s. Hodnotu t použijte přesně tak, jak byla odeslána, a tělo jako nezpracované přijaté bajty, ještě před jakýmkoli parsováním JSON. Zahoďte doručení, jehož X-Webhook-Event-Id jste už zpracovali: opakovaný pokus je znovu podepsán s novým t.
Související stránky
Další krok
Vytvořte příjemce, vložte jeho HTTPS URL do profilu, spusťte skenování na jedno použití a ověřte odpovídající External ID, než povolíte automatizaci po proudu.