Spejl loyalitetshistorik ind i din CRM
Hver stempel-, kupon-, fødselsdags- og inaktivitetsudløser lander på kunderegistreringen i din CRM. Du kan se den fulde loyalitetstidslinje ud for salg, opkald og billetter uden at logge ind på 7Stamp.
Udviklerintegration
7Stamp Webhooks
TilgængeligSkub enhver loyalitetsbegivenhed fra 7Stamp til dine egne systemer i realtid. Ingen afstemning og ingen planlagte API-opkald. Begivenheder ankommer som HTTPS POST anmodninger inden for få sekunder efter, at de har fundet sted.
Brug webhooks til at holde din CRM, ERP eller brugerdefinerede backend synkroniseret med, hvad der sker på loyalitetssiden: Hvem deltog, hvem fik et stempel, hvem indløste en voucher, hvem udløste en fødselsdagsgave, og hvem blev inaktiv. Derefter beslutter dine systemer, hvad de skal gøre med disse data.
Hvad du kan gøre med webhooks
Webhooks er den udgående side af integrationsstakken. De afspejler kunde- og belønningsaktivitet i de systemer, du allerede har tillid til til salg, service, analyser og meddelelser.
Udløs din egen beskedstak
Når en kunde indløser en kupon, skal du sende en tak SMS fra din eksisterende SMS-gateway. Når en kunde rammer målet, skal du poste en fejring i Slack. Når nogen bliver inaktiv, skal du videresende sagen til din kontoadministrator.
Strømanalyse og afstemning
Stream begivenheder ind i dit BI-værktøj, lager eller afstemningspipeline. Match kuponindløsninger mod POS-kvitteringer, og beregn loyalitet ROI i dine egne metrics.
Korthændelsestyper
SCAN — Et kort modtog en scanningshandling/stamp.
REWARD_EARNED — En belønning blev optjent på kortet.
VOUCHER_ISSUED — En voucher blev udstedt.
VOUCHER_REDEEMED — En kupon blev indløst.
LOTTERY_WIN — Et lotteri resulterede i en gevinst.
DELIVERY_INSERT — Et leveringsindsatsflow blev registreret.
CARD_JOINED — En kunde tilsluttede sig et kort.
CARD_CAMPAIGN — En kortkampagnebegivenhed fandt sted.
BIRTHDAY_GREETING — En fødselsdagshilsen fandt sted.
ADMIN_VOUCHER_ISSUE — En administrator udstedte en voucher.
CARD_ADDED_TO_WALLET — En kunde føjede kortet til deres pung.
CARD_REMOVED_FROM_WALLET — En kunde fjernede kortet fra deres pung.
Byg en sikker webhook-modtager
Anerkend efter holdbar håndtering
Dit slutpunkt skal acceptere HTTPS POST, validere anmodningsformen, fortsætte eller sætte begivenheden i kø, og derefter returnere et vellykket 2xx-svar. Foretag ikke et langsomt CRM eller beskedopkald før bekræftelsen, hvis det kan stilles sikkert i kø.
Korreler med External ID
Enhver relateret begivenhed kan bære External ID og valgfri External Source, som du brugte, da du oprettede eller scannede kortet. Brug dette par til at opdatere din egen CRM, POS eller ordrepost uden at gætte fra et navn eller en e-mail.
Make levering idempotent
Gem en holdbar behandlingsnøgle eller begivenhedsfingeraftryk, før du udløser bivirkninger. Hvis din modtager ser den samme levering igen, bør den ikke tilføje en dublet CRM note, voucher eller besked. Behandl slutpunktet URL som en hemmelighed.
Eksempel på hændelsesnyttelastform
Kopier dette til dit automatiseringstrin
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
}
}
}Konfigurer og test en webhook
Opret et HTTPS-slutpunkt i din backend, CRM integrationslag, ⟦2 webhook,⟧2274hook,⟧ Zapier Catch Hook. Make sørg for, at du kontrollerer destinationen, før du kopierer dens URL.
I 7Stamp Admin, åben Stamp Cards → API & Integrations → Webhooks.
Tilføj slutpunktets URL. Webhooken modtager alle profilens korthændelser, så filtrér på data.event_type i din modtager.
Gem profilindstillingerne, og udløs derefter en engangstestscanning eller korthandling for at producere en begivenhed.
Undersøg den modtagne nyttelast. Match External ID og External Source til den forventede post, og bekræft, at modtageren returnerer et vellykket svar.
Aktiver kun CRM, voucher eller meddelelsesbivirkninger, når du har genafspilningssikker håndtering og overvågning for fejl.
Indstillinger uden kode: Make og Zapier
I Make skal du bruge Webhooks → Custom webhook til at generere en modtagende URL og indsætte den i 7Stamp-profilen. I Zapier skal du bruge Webhooks by Zapier → Catch Hook til samme formål. 7Stamp-profilen ejer abonnementet, fordi den nuværende API ikke afslører automatiske webhook-registreringsslutpunkter.
Sikkerheds- og leveringskontrakt
Brug Webhooks-sektionen i den offentlige OpenAPI-reference som kilde til det aktuelle nyttelastskema. Brødteksten er en konvolut: profile_id og profile_name angiver 7Stamp-profilen, event_id identificerer hændelsen, og selve korthændelsen ligger i data (for en Make- eller Zapier-URL er nøglen card_event). Hver levering signeres i én header, X-Webhook-Signature: t=…,s=…. Beregn HMAC-SHA256 med din webhook-hemmelighed over t plus den rå anmodningsbrødtekst, hex-kod resultatet, og sammenlign det med s; hemmeligheden står på webhookens side i 7Stamp Admin. Brug X-Webhook-Event-Id til at frasortere gentagne leveringer: et genforsøg signeres igen med et nyt t. Du kan også beskytte slutpunktet med Basic Auth. Kræv HTTPS, og hold modtagerens URL ude af offentlige logfiler.
Ofte stillede spørgsmål
Kan jeg kun vælge bestemte webhook-begivenheder?
Nej. En 7Stamp-webhook modtager alle profilens korthændelser. Filtrér på data.event_type i din modtager; i Make og Zapier kommer hændelsen under card_event, så filtrér på card_event.event_type.
Hvordan forbinder jeg webhooks til Make eller Zapier?
Opret den modtagende webhook i Make eller en Catch Hook i Zapier, kopier den genererede URL, indsæt den derefter i 7Stamp profilens webhook-indstillinger og send en testbegivenhed.
Hvordan skal jeg matche en begivenhed med min CRM-kontakt?
Brug data.external_id og, når det findes, data.external_source: de kommer med i hver webhook for kort, du har udstedt via API'en med dit eget ID. En kunde, der selv har taget kortet, har intet External ID, så match dem på data.user.email. En Apple “Hide My Email”-adresse er en videresendelsesadresse, ikke den, der står i dit CRM.
Hvordan tjekker jeg, at en webhook kommer fra 7Stamp?
Del headeren X-Webhook-Signature op i t og s, beregn HMAC-SHA256 med webhook-hemmeligheden fra 7Stamp Admin over t plus den rå anmodningsbrødtekst, hex-kod resultatet, og sammenlign det med s. Brug t præcis som sendt og brødteksten som de rå bytes, der er modtaget, før nogen JSON-parsing. Frasortér en levering, hvis X-Webhook-Event-Id du allerede har behandlet: et genforsøg signeres igen med et nyt t.
Relaterede sider
Næste skridt
Klar til at sende den første kortbegivenhed?
Opret en modtager, indsæt dens HTTPS URL i profilen, kør en engangsscanning og valider den matchende External ID, før du aktiverer downstream-automatisering.