Izstrādātāju integrācija
Pārsūtiet katru lojalitātes notikumu no 7Stamp uz savām sistēmām reāllaikā. Nav aptauju un nav ieplānotu zvanu API. Notikumi tiek saņemti kā HTTPS POST pieprasījumi dažu sekunžu laikā pēc notikuma.
Izmantojiet tīmekļa aizķeres, lai saglabātu savu CRM, ERP vai pielāgoto aizmugursistēmu sinhronizācijā ar to, kas notiek lojalitātes pusē: kurš pievienojās, kurš ieguva zīmogu, kurš izmantoja kuponu, kurš aktivizēja dzimšanas dienas dāvanu un kurš kļuva neaktīvs. Pēc tam jūsu sistēmas izlemj, ko darīt ar šiem datiem.
Tīmekļa aizķeres ir integrācijas steka izejošā puse. Tie atspoguļo klientu un atlīdzības aktivitātes sistēmās, kurām jau uzticaties attiecībā uz pārdošanu, apkalpošanu, analīzi un ziņojumapmaiņu.
Katrs zīmogs, kupons, dzimšanas diena un neaktivitātes aktivizētājs tiek iekļauts klienta ierakstā jūsu CRM. Jūs redzat pilnu lojalitātes laika skalu blakus izpārdošanai, zvaniem un biļetēm, nepiesakoties 7Stamp.
Kad klients izmanto kuponu, nosūtiet pateicības ziņojumu SMS no esošās vārtejas SMS. Kad klients sasniedz mērķi, ievietojiet svinības Slack. Ja kāds kļūst neaktīvs, pārsūtiet lietu savam konta pārzinim.
Straumējiet notikumus savā BI rīkā, noliktavā vai saskaņošanas konveijerā. Salīdziniet kuponu izpirkšanu ar kvītīm POS un aprēķiniet lojalitāti ROI savos rādītājos.
Jūsu galapunktam ir jāpieņem HTTPS POST, jāapstiprina pieprasījuma forma, jāpatur vai jāievieto notikums rindā un pēc tam jāatgriež veiksmīga 2xx atbilde. Neveiciet lēnu CRM vai ziņojumapmaiņas zvanu pirms apstiprinājuma, ja to var droši ievietot rindā.
Katrs saistītais notikums var saturēt External ID un izvēles External Source, ko izmantojāt, veidojot vai skenējot karti. Izmantojiet šo pāri, lai atjauninātu savu CRM, POS vai pasūtītu ierakstu, neuzminot pēc vārda vai e-pasta.
Pirms blakusparādību aktivizēšanas uzglabājiet noturīgu apstrādes atslēgu vai notikuma pirkstu nospiedumu. Ja saņēmējs atkal redz to pašu piegādi, tam nevajadzētu pievienot piezīmes, kupona vai ziņojuma dublikātu. Uztveriet galapunktu URL kā noslēpumu.
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
}
}
}Izveidojiet galapunktu HTTPS savā aizmugursistēmā, CRM, integrācijas slānī, CRM, tīmekļa hook72⟦ vai 265. Zapier Catch Hook. Make pārliecinieties, ka kontrolējat galamērķi pirms tā kopēšanas URL.
Laukā 7Stamp Admin atveriet Stamp Cards → API & Integrations → Webhooks.
Pievienojiet galapunkta URL. Tīmekļa aizķere saņem visus profila kartes notikumus, tāpēc filtrējiet pēc data.event_type savā uztvērējā.
Saglabājiet profila iestatījumus, pēc tam aktivizējiet vienreizējās lietošanas pārbaudes skenēšanu vai kartītes darbību, lai izveidotu notikumu.
Pārbaudiet saņemto kravnesību. Saskaņojiet External ID un External Source ar paredzamo ierakstu un apstipriniet, ka saņēmējs atgriež veiksmīgu atbildi.
Iespējojiet CRM, kuponu vai ziņojumapmaiņas blakusparādības tikai pēc tam, kad ir nodrošināta atkārtota darbība un kļūmju kontrole.
Laukā Make izmantojiet Webhooks → Custom webhook, lai ģenerētu saņemšanas numuru URL un ielīmētu to profilā 7Stamp. Slejā Zapier izmantojiet Webhooks by Zapier → Catch Hook tam pašam mērķim. Profilam 7Stamp pieder abonements, jo pašreizējais API neatklāj automātiskās tīmekļa aizķeres reģistrācijas galapunktus.
Izmantojiet publiskās OpenAPI atsauces sadaļu Webhooks kā avotu pašreizējai lietderīgās slodzes shēmai. Pamatteksts ir aploksne: profile_id un profile_name norāda profilu 7Stamp, event_id identificē notikumu, bet pats kartes notikums atrodas atslēgā data (Make vai Zapier URL gadījumā atslēga ir card_event). Katra piegāde ir parakstīta vienā galvenē, X-Webhook-Signature: t=…,s=…. Aprēķiniet HMAC-SHA256 ar savas tīmekļa aizķeres noslēpumu no t kopā ar neapstrādātu pieprasījuma pamattekstu, kodējiet rezultātu hex formātā un salīdziniet to ar s; noslēpums ir atrodams tīmekļa aizķeres lapā rīkā 7Stamp Admin. Izmantojiet X-Webhook-Event-Id, lai atmestu atkārtotas piegādes: atkārtots mēģinājums tiek parakstīts no jauna ar jaunu t. Galapunktu var papildus aizsargāt ar Basic Auth. Pieprasiet HTTPS un neļaujiet uztvērēja URL nonākt publiskos žurnālos.
Nē. 7Stamp tīmekļa aizķere saņem visus profila kartes notikumus. Filtrējiet pēc data.event_type savā uztvērējā; Make un Zapier notikums pienāk zem card_event, tāpēc filtrējiet pēc card_event.event_type.
Izveidojiet saņemšanas tīmekļa aizķeri Make vai Catch Hook Zapier, kopējiet ģenerēto URL, pēc tam ielīmējiet to profila 7Stamp tīmekļa aizķeres iestatījumos un nosūtiet testa notikumu.
Izmantojiet data.external_id un, ja tas ir, data.external_source: tie atgriežas katrā tīmekļa aizķeres sūtījumā par kartēm, ko izsniedzāt, izmantojot API ar savu ID. Klientam, kurš karti paņēma pats, nav External ID, tāpēc sasaistiet viņu pēc data.user.email. Apple “Hide My Email” adrese ir pārsūtīšanas adrese, nevis tā, kas ir jūsu CRM.
Sadaliet galveni X-Webhook-Signature daļās t un s, aprēķiniet HMAC-SHA256 ar tīmekļa aizķeres noslēpumu no 7Stamp Admin no t kopā ar neapstrādātu pieprasījuma pamattekstu, kodējiet rezultātu hex formātā un salīdziniet to ar s. Ņemiet t tieši tādu, kāds tas nosūtīts, un pamattekstu kā saņemtos neapstrādātos baitus, pirms jebkādas JSON parsēšanas. Atmetiet piegādi, kuras X-Webhook-Event-Id jau esat apstrādājis: atkārtots mēģinājums tiek parakstīts no jauna ar jaunu t.
Saistītās lapas
Nākamais solis
Izveidojiet uztvērēju, ielīmējiet tā HTTPS URL profilā, veiciet vienreizējo skenēšanu un apstipriniet atbilstošo External ID, pirms iespējojat pakārtoto automatizāciju.