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.
Integracija za razvijalce
7Stamp Webhooks
Na voljoPotisnite 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.
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 {
"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
}
}
}Konfigurirajte in preizkusite webhook
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.
V 7Stamp Admin odprite Stamp Cards → API & Integrations → Webhooks.
Dodajte URL končne točke. Webhook prejme vsak dogodek kartice v profilu, zato v svojem prejemniku filtrirajte po data.event_type.
Shranite nastavitve profila, nato sprožite testno skeniranje za enkratno uporabo ali dejanje kartice, da ustvarite dogodek.
Preglejte prejeti tovor. Povežite External ID in External Source s pričakovanim zapisom in potrdite, da prejemnik vrne uspešen odgovor.
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
Kot vir za trenutno shemo vsebine (payload) uporabite razdelek Webhooks v javni referenci OpenAPI. Telo zahteve je ovojnica: profile_id in profile_name označujeta profil 7Stamp, event_id identificira dogodek, sam dogodek kartice pa je v data (za URL iz Make ali Zapier je ključ card_event). Vsaka dostava je podpisana v eni glavi, X-Webhook-Signature: t=…,s=…. Izračunajte HMAC-SHA256 s skrivnim ključem webhooka nad t, ki mu sledi neobdelano telo zahteve, rezultat kodirajte v šestnajstiški zapis in ga primerjajte z vrednostjo s; skrivni ključ je na strani webhooka v 7Stamp Admin. Z X-Webhook-Event-Id zavrzite ponovljene dostave: ponovni poskus je znova podpisan z novim t. Končno točko lahko zaščitite tudi z Basic Auth. Zahtevajte HTTPS in URL prejemnika hranite zunaj javnih dnevnikov.
Pogosto zastavljena vprašanja
Ali lahko izberem samo določene dogodke webhook?
Ne. Webhook 7Stamp prejme vsak dogodek kartice v profilu. V svojem prejemniku filtrirajte po data.event_type; v Make in Zapier dogodek pride v card_event, zato filtrirajte po card_event.event_type.
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 data.external_id in, če je prisoten, data.external_source: vrneta se v vsakem webhooku za kartice, ki ste jih izdali prek API z lastnim ID. Stranka, ki je kartico prevzela sama, nima External ID, zato jo poiščite po data.user.email. Naslov Apple „Hide My Email“ je posredovalni naslov, ne tisti iz vašega CRM.
Kako preverim, da je webhook prišel iz 7Stamp?
Glavo X-Webhook-Signature razdelite na t in s, izračunajte HMAC-SHA256 s skrivnim ključem webhooka iz 7Stamp Admin nad t, ki mu sledi neobdelano telo zahteve, rezultat kodirajte v šestnajstiški zapis in ga primerjajte z vrednostjo s. Vrednost t uporabite natanko tako, kot je bila poslana, telo pa kot neobdelane prejete bajte, še pred kakršnim koli razčlenjevanjem JSON. Zavrzite dostavo, katere X-Webhook-Event-Id ste že obdelali: ponovni poskus je znova podpisan z novim t.
Sorodne strani
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.