Atvaizduokite lojalumo istoriją į savo CRM
Kiekvienas antspaudas, kuponas, gimtadienis ir neveiklumo aktyviklis patenka į kliento įrašą jūsų CRM. Šalia pardavimų, skambučių ir bilietų matote visą lojalumo laiko juostą neprisijungę prie 7Stamp.
Kūrėjų integracija
7Stamp Žiniatinklio kabliukai
YraPush every loyalty event from 7Stamp to your own systems in real time. Jokių apklausų ir suplanuotų skambučių API. Įvykiai pateikiami kaip HTTPS POST užklausos per kelias sekundes nuo įvykių.
Naudokite žiniatinklio kabliukus, kad CRM, ERP arba tinkinta vidinė programa būtų sinchronizuojama su tuo, kas vyksta lojalumo srityje: kas prisijungė, kas gavo antspaudą, kas išpirko kuponą, kas suaktyvino gimtadienio dovaną ir kas tapo neaktyvus. Tada jūsų sistemos nusprendžia, ką daryti su tais duomenimis.
Ką galite padaryti naudodami žiniatinklio kabliukus
„Webhooks“ yra išorinė integravimo krūvos pusė. Jie atspindi klientų veiklą ir apdovanoja jų veiklą sistemose, kuriomis jau pasitikite dėl pardavimo, aptarnavimo, analizės ir pranešimų siuntimo.
Suaktyvinkite savo žinučių paketą
Kai klientas išperka kuponą, iš savo esamo SMS šliuzo išsiųskite padėkos laišką SMS. Kai klientas pasiekia tikslą, paskelbkite šventę adresu Slack. Kai kas nors tampa neaktyvus, nukreipkite atvejį savo paskyros valdytojui.
Galios analizė ir suderinimas
Perduokite įvykius į savo BI įrankį, sandėlį arba derinimo vamzdyną. Suderinkite kuponų išpirkimą su POS kvitais ir apskaičiuokite lojalumą ROI pagal savo metriką.
Kortelės įvykių tipai
SCAN – kortelė gavo nuskaitymo/stamp veiksmą.
REWARD_EARNED – kortele buvo gautas atlygis.
VOUCHER_ISSUED – buvo išduotas kuponas.
VOUCHER_REDEEMED – kuponas buvo išpirktas.
LOTTERY_WIN – loterijoje buvo laimėta.
DELIVERY_INSERT – buvo užfiksuotas pristatymo ir įdėklo srautas.
CARD_JOINED – klientas prisijungė prie kortelės.
CARD_CAMPAIGN – įvyko kortelių kampanijos įvykis.
BIRTHDAY_GREETING – įvyko gimtadienio sveikinimo įvykis.
ADMIN_VOUCHER_ISSUE – administratorius išdavė kvitą.
CARD_ADDED_TO_WALLET – klientas įdėjo kortelę į savo piniginę.
CARD_REMOVED_FROM_WALLET – klientas išėmė kortelę iš savo piniginės.
Sukurkite saugų „Webhook“ imtuvą
Patvirtinkite po ilgalaikio tvarkymo
Jūsų galutinis taškas turėtų priimti HTTPS POST, patvirtinti užklausos formą, išlikti arba įrašyti įvykį į eilę, tada grąžinti sėkmingą 2xx atsakymą. Neskambinkite lėtai CRM ar susirašinėdami žinutėmis prieš patvirtinimą, jei jį galima saugiai įrašyti į eilę.
Koreliuoti su External ID
Kiekvienas susijęs įvykis gali turėti External ID ir pasirenkamą External Source, kuriuos naudojote kurdami arba nuskaitydami kortelę. Naudokite šią porą norėdami atnaujinti savo CRM, POS arba užsisakyti įrašą neatspėdami iš vardo ar el. pašto.
Make pristatymas idempotentas
Prieš sukeldami šalutinį poveikį, išsaugokite patvarų apdorojimo raktą arba įvykio piršto atspaudą. Jei gavėjas vėl matys tą patį pristatymą, jis neturėtų pridėti 25664⟧ užrašo, kupono ar pranešimo dublikato. Galutinį tašką URL laikykite paslaptyje.
Įvykio naudingosios apkrovos formos pavyzdys
Nukopijuokite tai į automatizavimo veiksmą
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
}
}
}Sukonfigūruokite ir patikrinkite žiniatinklio kabliuką
Sukurkite HTTPS galinį tašką vidinėje programoje, CRM integravimo sluoksnyje, CRM, webhook⟧⟦⟦25616. Zapier Catch Hook. Make įsitikinkite, kad valdote paskirties vietą prieš nukopijuodami jos URL.
Skiltyje 7Stamp Admin atidarykite Stamp Cards → API & Integrations → Webhooks.
Pridėkite galinio taško URL. Webhook gauna visus profilio kortelių įvykius, todėl filtruokite pagal data.event_type savo gavėjo pusėje.
Išsaugokite profilio nustatymus, tada suaktyvinkite vienkartinį bandomąjį nuskaitymą arba kortelės veiksmą, kad būtų sukurtas įvykis.
Patikrinkite gautą naudingą krovinį. Suderinkite External ID ir External Source su laukiamu įrašu ir patvirtinkite, kad gavėjas grąžins sėkmingą atsakymą.
Įgalinkite CRM, kuponų ar pranešimų šalutinį poveikį tik tada, kai saugiai elgsitės ir stebėsite, ar nėra gedimų.
Be kodo parinktys: Make ir Zapier
Skiltyje Make naudokite Webhooks → Custom webhook, kad sugeneruotumėte priėmimo numerį URL ir įklijuokite jį į 7Stamp profilį. Zapier naudokite Webhooks by Zapier → Catch Hook tuo pačiu tikslu. Prenumerata priklauso profiliui 7Stamp, nes dabartinis API neatskleidžia automatinės „Webhook“ registracijos galinių taškų.
Saugos ir pristatymo sutartis
Kaip dabartinės naudingosios apkrovos schemos šaltinį naudokite viešosios OpenAPI dokumentacijos skyrių Webhooks. Turinys yra vokas: profile_id ir profile_name nurodo 7Stamp profilį, event_id identifikuoja įvykį, o pats kortelės įvykis yra lauke data (Make arba Zapier URL atveju raktas yra card_event). Kiekvienas pristatymas pasirašomas vienoje antraštėje, X-Webhook-Signature: t=…,s=…. Su savo webhook slaptuoju raktu apskaičiuokite HMAC-SHA256 iš t ir neapdoroto užklausos turinio sujungimo, užkoduokite rezultatą šešioliktainiu formatu ir palyginkite su s; slaptasis raktas yra webhook puslapyje 7Stamp Admin. Naudokite X-Webhook-Event-Id pasikartojantiems pristatymams atmesti: pakartotinis bandymas pasirašomas iš naujo su nauju t. Galinį tašką taip pat galite apsaugoti naudodami Basic Auth. Reikalaukite HTTPS ir neleiskite gavėjo URL patekti į viešuosius žurnalus.
Dažnai užduodami klausimai
Ar galiu pasirinkti tik tam tikrus „Webhook“ įvykius?
Ne. 7Stamp webhook gauna visus profilio kortelių įvykius. Filtruokite pagal data.event_type savo gavėjo pusėje; Make ir Zapier įvykis pateikiamas lauke card_event, todėl filtruokite pagal card_event.event_type.
Kaip prijungti žiniatinklio kabliukus prie Make arba Zapier?
Sukurkite gavimo Webhook Make arba Catch Hook Zapier, nukopijuokite sugeneruotą URL, tada įklijuokite jį į 7Stamp bandomojo įvykio profilį.
Kaip susieti įvykį su savo CRM kontaktu?
Naudokite data.external_id ir, jei yra, data.external_source: jie grąžinami kiekviename webhook kortelėms, kurias išdavėte per API su savo ID. Klientas, pats pasiėmęs kortelę, neturi External ID, todėl jį susiekite pagal data.user.email. Apple „Hide My Email“ adresas yra persiuntimo adresas, o ne tas, kuris yra jūsų CRM.
Kaip patikrinti, ar webhook tikrai atsiųstas iš 7Stamp?
Padalykite X-Webhook-Signature antraštę į t ir s, su webhook slaptuoju raktu iš 7Stamp Admin apskaičiuokite HMAC-SHA256 iš t ir neapdoroto užklausos turinio sujungimo, užkoduokite šešioliktainiu formatu ir palyginkite su s. Imkite t tiksliai tokį, koks atsiųstas, o turinį – kaip gautus neapdorotus baitus, prieš bet kokį JSON analizavimą. Atmeskite pristatymą, kurio X-Webhook-Event-Id jau apdorojote: pakartotinis bandymas pasirašomas iš naujo su nauju t.
Susiję puslapiai
Kitas žingsnis
Pasiruošę išsiųsti pirmąjį kortelės įvykį?
Sukurkite imtuvą, įklijuokite jo HTTPS URL į profilį, atlikite vienkartinį nuskaitymą ir patvirtinkite atitikimą External ID prieš įjungdami paskesnį automatizavimą.