Vývojářská integrace

7stamp Webhooky

K dispozici

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.

Co můžete dělat s webhooky

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.

Přeneste historii věrnosti do svého CRM

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.

Spusťte svůj vlastní zásobník zpráv

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.

Analytika výkonu a odsouhlasení

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.

Typy událostí karty

SCAN — Karta obdržela akci skenování/stamp.
REWARD_EARNED — Na kartě byla získána odměna.
VOUCHER_ISSUED — Byl vydán poukaz.
VOUCHER_REDEEMED — Poukaz byl uplatněn.
LOTTERY_WIN — Výsledkem loterie je výhra.
DELIVERY_INSERT — Byl zaznamenán tok dodávky a vložky.
CARD_JOINED — Zákazník se připojil ke kartě.
CARD_CAMPAIGN — Došlo k události karetní kampaně.
BIRTHDAY_GREETING — Došlo k oslavě narozenin.
ADMIN_VOUCHER_ISSUE — Správce vydal voucher.
CARD_ADDED_TO_WALLET — Zákazník přidal kartu do své peněženky.
CARD_REMOVED_FROM_WALLET — Zákazník vyndal kartu ze své peněženky.

Sestavte si bezpečný webhook přijímač

Potvrďte po trvalém zacházení

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.

Korelovat s External ID

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.

Make doručení idempotentní

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

Example event payload shape

Zkopírujte to do vašeho kroku automatizace 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"
}

Configure and test a webhook

01

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.

02

V 7stamp Admin otevřete Stamp Cards → API & Integrations → Webhooks.

03

Přidejte koncový bod URL a vyberte pouze typy událostí, které pracovní postup příjemce skutečně potřebuje.

04

Uložte nastavení profilu a poté spusťte jednorázové testovací skenování nebo akci karty k vytvoření události.

05

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ěď.

06

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.

Možnosti bez kódu: Make a Zapier

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.

Security and delivery contract

Use the Webhooks section of the public OpenAPI reference as the source for the current payload schema and field meaning. Vyžadujte HTTPS, držte přijímač URL mimo veřejné protokoly a udělejte zpracování idempotentní. Confirm the request-authentication/signature procedure for your 7stamp profile during onboarding before enforcing a specific header name or retry policy in production.

Často kladené otázky

Mohu vybrat pouze určité události webhooku?

Ano. Vyberte typy událostí v nastavení webhooku profilu 7stamp, aby přijímač dostal pouze události, které jsou důležité pro jeho pracovní postup.

Jak připojím webhooky k Make nebo Zapier?

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.

Jak mám přiřadit událost ke svému kontaktu CRM?

Použijte External ID a pokud je přítomen, External Source. Toto jsou identifikátory, které vaše integrace poskytla při vytváření nebo skenování karty.

Mám předpokládat hlavičku podpisu nebo opakovat načasování?

Ne. Použijte současnou smlouvu o dodání OpenAPI/profile a potvrďte proceduru ověření pro svůj profil během registrace, než napevno zakódujete hlavičku nebo opakujte předpoklad.

Další krok

Jste připraveni odeslat první událost karty?

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.