Arendaja integreerimine
Edastage kõik lojaalsussündmused numbrilt 7Stamp oma süsteemidesse reaalajas. Ei küsitlemist ega plaanitud API kõnesid. Sündmused saabuvad HTTPS POST päringutena mõne sekundi jooksul pärast toimumist.
Kasutage veebihaake, et hoida oma CRM, ERP või kohandatud taustaprogramm sünkroonis lojaalsuspoolel toimuvaga: kes liitus, kes sai templi, kes lunastas vautšeri, kes käivitas sünnipäevakingituse ja kes muutus passiivseks. Seejärel otsustavad teie süsteemid, mida nende andmetega teha.
Veebihaagid on integratsioonivirna väljaminev pool. Need peegeldavad kliendi- ja tasustamistegevust süsteemidesse, mida te juba usaldate müügi, teeninduse, analüütika ja sõnumivahetuse osas.
Iga tempel, vautšer, sünnipäev ja passiivsuse päästikud kantakse teie numbri CRM kliendikirjesse. Näete täielikku püsikliendi ajaskaala müügi, kõnede ja piletite kõrval ilma numbrile 7Stamp sisse logimata.
Kui klient lunastab vautšeri, saatke oma olemasolevast SMS lüüsist tänusõnum SMS. Kui klient lööb eesmärgi, postitage tähistamine numbrile Slack. Kui keegi muutub passiivseks, suunake juhtum oma kontohaldurile.
Voogesitage sündmusi oma BI tööriista, lattu või kooskõlastuskonveierisse. Sobitage vautšeri lunastamine kviitungitega POS ja arvutage lojaalsus ROI oma mõõdikutes.
Teie lõpp-punkt peaks aktsepteerima HTTPS POST, kinnitama päringu kuju, säilitama või asetama sündmuse järjekorda ja seejärel tagastama eduka 2xx vastuse. Ärge tehke aeglast numbrit CRM või sõnumsidekõnet enne kinnitust, kui seda saab turvaliselt järjekorda panna.
Igal seotud sündmusel võib olla External ID ja valikuline External Source, mida kasutasite kaardi loomisel või skannimisel. Kasutage seda paari oma numbrite CRM, POS värskendamiseks või tellimiseks ilma nime või e-posti aadressi järgi arvamata.
Enne kõrvalmõjude käivitamist salvestage vastupidav töötlemisvõti või sündmuse sõrmejälg. Kui teie saaja näeb sama saadetist uuesti, ei tohiks ta lisada CRM märkuse, vautšeri või sõnumi duplikaati. Käsitlege lõpp-punkti URL saladusena.
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
}
}
}Looge oma taustaprogrammis HTTPS lõpp-punkt, CRM integratsioonikiht, ⟦9364, 6 või ⟦9364,3 Catch Hook. Make kontrollige kindlasti sihtkohta, enne kui kopeerite selle URL.
Avage failis 7Stamp Admin Stamp Cards → API & Integrations → Webhooks.
Lisage lõpp-punkti URL. Veebihaak saab kätte profiili iga kaardisündmuse, seega filtreerige vastuvõtjas data.event_type järgi.
Salvestage profiili sätted, seejärel käivitage sündmuse loomiseks ühekordselt kasutatav testskannimine või kaarditoiming.
Kontrollige vastuvõetud koormust. Sobitage External ID ja External Source oodatud kirjega ja kinnitage, et vastuvõtja tagastab eduka vastuse.
Lubage CRM, vautšeri või sõnumite saatmise kõrvalmõjud alles pärast seda, kui teil on taasesituse ohutu käsitsemine ja tõrgete jälgimine.
Dokumendis Make kasutage vastuvõtva numbri URL loomiseks numbrit Webhooks → Custom webhook ja kleepige see profiili 7Stamp. Dokumendis Zapier kasutage samal eesmärgil numbrit Webhooks by Zapier → Catch Hook. Profiil 7Stamp omab tellimust, kuna praegune API ei avalda veebihaagi automaatse registreerimise lõpp-punkte.
Kasutage praeguse andmeskeemi (payload) allikana avaliku OpenAPI viite jaotist Webhooks. Päringu sisu on ümbrik: profile_id ja profile_name määravad 7Stamp profiili, event_id tuvastab sündmuse ning kaardisündmus ise on väljas data (Make'i või Zapieri URL-i puhul on võti card_event). Iga edastus on allkirjastatud ühes päises, X-Webhook-Signature: t=…,s=…. Arvutage veebihaagi saladusega HMAC-SHA256 väärtusest t, millele järgneb päringu töötlemata sisu, kodeerige tulemus kuueteistkümnendsüsteemi ja võrrelge seda väärtusega s; saladus on veebihaagi lehel 7Stamp Admin keskkonnas. Kasutage päist X-Webhook-Event-Id korduvate edastuste kõrvaldamiseks: korduskatse allkirjastatakse uuesti uue t-ga. Lõpp-punkti saab kaitsta ka Basic Auth abil. Nõudke HTTPS-i ja hoidke vastuvõtja URL avalikest logidest eemal.
Ei. 7Stamp veebihaak saab kätte profiili iga kaardisündmuse. Filtreerige vastuvõtjas data.event_type järgi; Make'is ja Zapieris tuleb sündmus välja card_event all, seega filtreerige card_event.event_type järgi.
Looge vastuvõttev veebihaak dokumendis Make või Catch Hook numbris Zapier, kopeerige loodud URL, seejärel kleepige see profiili 7Stamp veebihaagi seadetesse ja saatke testsündmus.
Kasutage välja data.external_id ja olemasolu korral välja data.external_source: need tulevad tagasi igas veebihaagis kaartide puhul, mille väljastasite API kaudu oma ID-ga. Kliendil, kes võttis kaardi ise, ei ole External ID-d, seega leidke ta data.user.email järgi. Apple'i „Hide My Email“ aadress on edastusaadress, mitte see, mis on teie CRM-is.
Jagage päis X-Webhook-Signature osadeks t ja s, arvutage 7Stamp Admin keskkonnast saadud veebihaagi saladusega HMAC-SHA256 väärtusest t, millele järgneb päringu töötlemata sisu, kodeerige tulemus kuueteistkümnendsüsteemi ja võrrelge seda väärtusega s. Võtke t täpselt sellisena, nagu see saadeti, ja sisu töötlemata vastuvõetud baitidena, enne mis tahes JSON-i parsimist. Jätke kõrvale edastus, mille X-Webhook-Event-Id olete juba töödelnud: korduskatse allkirjastatakse uuesti uue t-ga.
Seotud leheküljed
Järgmine samm
Looge vastuvõtja, kleepige selle HTTPS URL profiili, käivitage ühekordne skannimine ja kinnitage sobiv External ID enne allavoolu automatiseerimise lubamist.