Integracija za razvijalce

7stamp Webhooks

Na voljo

Potisnite vsak dogodek zvestobe iz 7stamp v svoje sisteme v realnem času. Brez glasovanja in brez načrtovanih klicev API. Dogodki prispejo kot zahteve HTTPS POST v nekaj sekundah po tem, ko se zgodijo.

Uporabite webhooks, da bo vaše CRM, ERP ali zaledje po meri sinhronizirano z dogajanjem na strani zvestobe: kdo se je pridružil, kdo je prejel žig, kdo je unovčil kupon, kdo je sprožil darilo za rojstni dan in kdo je postal nedejaven. Nato se vaši sistemi odločijo, kaj storiti s temi podatki.

Kaj lahko storite s spletnimi kavlji

Spletni kavlji so izhodna stran integracijskega sklada. Zrcalijo dejavnost strank in nagrajevanje v sisteme, ki jim že zaupate za prodajo, storitve, analitiko in sporočanje.

Zrcaljenje zgodovine zvestobe v vaš CRM

Vsak žig, kupon, rojstni dan in sprožilec nedejavnosti pristanejo v evidenci strank v vašem CRM. Brez prijave v 7stamp vidite celotno časovnico zvestobe poleg prodaje, klicev in vstopnic.

Sprožite svoj sklad sporočil

Ko stranka unovči kupon, pošljite zahvalo SMS z vašega obstoječega prehoda SMS. Ko stranka doseže cilj, objavite praznovanje v Slack. Ko nekdo postane nedejaven, usmerite primer svojemu upravitelju računa.

Analitika moči in usklajevanje

Pretakajte dogodke v svoje orodje BI, skladišče ali cevovod za usklajevanje. Povežite unovčitve kuponov s prejemki POS in izračunajte zvestobo ROI v lastnih meritvah.

Vrste dogodkov kartice

SCAN — Kartica je prejela dejanje skeniranja/stamp.
REWARD_EARNED — Na kartici je bila zaslužena nagrada.
VOUCHER_ISSUED — Bon je bil izdan.
VOUCHER_REDEEMED — Bon je bil unovčen.
LOTTERY_WIN — Rezultat loterije je bil dobitek.
DELIVERY_INSERT — Zabeležen je bil tok dostave-vstavitve.
CARD_JOINED — Stranka se je pridružila kartici.
CARD_CAMPAIGN — Zgodil se je dogodek kartične kampanje.
BIRTHDAY_GREETING — Zgodilo se je rojstnodnevno voščilo.
ADMIN_VOUCHER_ISSUE — Administrator je izdal kupon.
CARD_ADDED_TO_WALLET — Stranka je dodala kartico v svojo denarnico.
CARD_REMOVED_FROM_WALLET — Stranka je odstranila kartico iz svoje denarnice.

Zgradite varen sprejemnik webhook

Potrdite po trajnem ravnanju

Vaša končna točka bi morala sprejeti HTTPS POST, potrdite obliko zahteve, vztrajajte ali postavite dogodek v čakalno vrsto, nato vrnite uspešen odgovor 2xx. Ne izvajajte počasnega klica CRM ali sporočilnega klica pred potrditvijo, če ga je mogoče varno postaviti v čakalno vrsto.

Poveži z External ID

Vsak povezan dogodek lahko nosi External ID in neobvezno External Source, ki ste ju uporabili pri ustvarjanju ali skeniranju kartice. Uporabite ta par za posodobitev lastnega zapisa CRM, POS ali naročila, ne da bi ugibali po imenu ali e-pošti.

Make dostava idempotentna

Shranite trajen ključ za obdelavo ali prstni odtis dogodka, preden sprožite stranske učinke. Če vaš prejemnik ponovno vidi isto pošiljko, ne bi smel dodati dvojnika CRM bankovca, kupona ali sporočila. Končno točko URL obravnavajte kot skrivnost.

Primer oblike koristnega tovora dogodka

Kopirajte to v svoj korak avtomatizacije 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"
}

Konfigurirajte in preizkusite webhook

01

Ustvarite končno točko HTTPS v zaledju, CRM integracijski plasti, Make webhook ali Zapier Catch Hook. Make se prepričajte, da nadzorujete cilj, preden kopirate njegov URL.

02

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

03

Dodajte končno točko URL in izberite samo vrste dogodkov, ki jih potek dela prejemanja dejansko potrebuje.

04

Shranite nastavitve profila, nato sprožite testno skeniranje za enkratno uporabo ali dejanje kartice, da ustvarite dogodek.

05

Preglejte prejeti tovor. Povežite External ID in External Source s pričakovanim zapisom in potrdite, da prejemnik vrne uspešen odgovor.

06

Omogočite stranske učinke CRM, vavčerja ali sporočil šele, ko imate varno ravnanje pri ponovnem predvajanju in spremljanje napak.

Možnosti brez kode: Make in Zapier

V Make uporabite Webhooks → Custom webhook, da ustvarite sprejemni URL in ga prilepite v profil 7stamp. V Zapier uporabite Webhooks by Zapier → Catch Hook za isti namen. Profil 7stamp je lastnik naročnine, ker trenutni API ne izpostavlja končnih točk samodejne registracije webhooka.

Pogodba o varnosti in dostavi

Uporabite razdelek Webhooks javne reference OpenAPI kot vir za trenutno shemo koristnega tovora in pomen polja. Zahtevaj HTTPS, naj sprejemnik URL ne bo v javnih dnevnikih in naj bo obdelava idempotentna. Potrdite postopek preverjanja pristnosti zahteve /signature za svoj profil 7stamp med vkrcanjem, preden uveljavite določeno ime glave ali pravilnik za ponovni poskus v produkciji.

Pogosto zastavljena vprašanja

Ali lahko izberem samo določene dogodke webhook?

Da. Izberite vrste dogodkov v nastavitvah webhook profila 7stamp, tako da prejemnik prejme samo dogodke, ki so pomembni za njegov potek dela.

Kako povežem webhooks z Make ali Zapier?

Ustvarite sprejemni webhook v Make ali Catch Hook v Zapier, kopirajte ustvarjeni URL, nato ga prilepite v nastavitve webhook profila 7stamp in pošljite preizkusni dogodek.

Kako naj povežem dogodek s svojim stikom CRM?

Uporabite External ID in, če je prisoten, External Source. To so identifikatorji, ki jih je posredovala vaša integracija, ko je bila kartica ustvarjena ali skenirana.

Ali naj prevzamem glavo podpisa ali poskusim znova?

Ne. Uporabite trenutno dobavno pogodbo OpenAPI/profile in potrdite postopek preverjanja pristnosti za svoj profil med vkrcanjem, preden trdo kodirate glavo ali poskusite znova.

Naslednji korak

Ste pripravljeni poslati prvi dogodek kartice?

Ustvarite sprejemnik, prilepite njegov HTTPS URL v profil, zaženite optično branje za enkratno uporabo in potrdite ujemanje External ID, preden omogočite nadaljnjo avtomatizacijo.