Integrering av utvecklare

7stamp Webhooks

Tillgänglig

Överför varje lojalitetshändelse från 7stamp till dina egna system i realtid. Ingen omröstning och inga schemalagda API samtal. Händelser anländer som HTTPS POST begär inom några sekunder efter att de hänt.

Använd webhooks för att hålla din CRM, ERP eller anpassade backend i synk med vad som händer på lojalitetssidan: vem som gick med, vem fick en stämpel, vem som löste in en kupong, vem utlöste en födelsedagspresent och vem blev inaktiv. Sedan bestämmer dina system vad de ska göra med den datan.

Vad du kan göra med webhooks

Webhooks är den utgående sidan av integrationsstacken. De speglar kund- och belöningsaktivitet i de system du redan litar på för försäljning, service, analys och meddelanden.

Spegla lojalitetshistoriken i din CRM

Varje stämpel, kupong, födelsedag och inaktivitetsutlösare hamnar på kundposten i din CRM. Du ser hela lojalitetstidslinjen bredvid försäljning, samtal och biljetter utan att logga in på 7stamp.

Utlösa din egen meddelandestack

När en kund löser in en kupong, skicka ett tack SMS från din befintliga SMS-gateway. När en kund når målet, lägg upp ett firande Slack. När någon blir inaktiv skickar du ärendet till din kontoansvariga.

Kraftanalys och avstämning

Streama händelser till ditt BI verktyg, lager eller avstämningspipeline. Matcha inlösen av kuponger mot POS-kvitton och beräkna lojalitet ROI i dina egna mätvärden.

Korthändelsetyper

SCAN — Ett kort fick en skanning/stamp-åtgärd.
REWARD_EARNED — En belöning tjänades på kortet.
VOUCHER_ISSUED — En kupong utfärdades.
VOUCHER_REDEEMED — En kupong har lösts in.
LOTTERY_WIN ​​— Ett lotteri resulterade i en vinst.
DELIVERY_INSERT — Ett leverans-insatsflöde registrerades.
CARD_JOINED — En kund gick med i ett kort.
CARD_CAMPAIGN — En kortkampanj inträffade.
BIRTHDAY_GREETING — En födelsedagshälsning inträffade.
ADMIN_VOUCHER_ISSUE — En administratör utfärdade en verifikation.
CARD_ADDED_TO_WALLET — En kund lade till kortet i sin plånbok.
CARD_REMOVED_FROM_WALLET — En kund tog bort kortet från sin plånbok.

Bygg en säker webhook-mottagare

Bekräfta efter hållbar hantering

Din slutpunkt bör acceptera HTTPS POST, validera förfrågningsformen, bestå eller köa händelsen och sedan returnera ett lyckat 2xx-svar. Ring inte ett långsamt CRM eller meddelandesamtal före bekräftelsen om det kan köas säkert.

Korrelera med External ID

Varje relaterad händelse kan bära External ID och valfria External Source som du använde när du skapade eller skannade kortet. Använd det här paret för att uppdatera din egen CRM, POS eller beställningspost utan att gissa från ett namn eller e-post.

Make leverans idempotent

Förvara en hållbar bearbetningsnyckel eller händelsefingeravtryck innan du utlöser biverkningar. Om din mottagare ser samma leverans igen bör den inte lägga till en dubblett av CRM-anteckningen, kupongen eller meddelandet. Behandla slutpunkten URL som en hemlighet.

Exempel på händelsenyttolastform

Kopiera detta till ditt automatiseringssteg json
{
  "event_type": "SCAN",
  "scanned_at": "2026-07-23T12:34:56Z",
  "user_card_id": 123,
  "card_template_id": 42,
  "card_template_name": "Coffee Loyalty",
  "stamps_added": 1,
  "stamps_before": 4,
  "stamps_after": 5,
  "amount": 24.5,
  "external_order_id": "order_2048",
  "external_id": "crm_contact_8821",
  "external_source": "hubspot"
}

Konfigurera och testa en webhook

01

Skapa en HTTPS-slutpunkt i din backend, CRM integrationslager, ⟦19888 eller ⟦19880 Zapier Catch Hook. Make se till att du kontrollerar destinationen innan du kopierar dess URL.

02

I 7stamp Admin, öppet Stamp Cards → API & Integrations → Webhooks.

03

Lägg till slutpunkten URL och välj endast de händelsetyper som det mottagande arbetsflödet faktiskt behöver.

04

Spara profilinställningarna och utlös sedan en engångstestskanning eller kortåtgärd för att producera en händelse.

05

Inspektera den mottagna nyttolasten. Matcha External ID och External Source till den förväntade posten och bekräfta att mottagaren returnerar ett framgångsrikt svar.

06

Aktivera CRM, kuponger eller meddelandebiverkningar först efter att du har återuppspelningssäker hantering och övervakning av fel.

Alternativ utan kod: Make och Zapier

I Make, använd Webhooks → Custom webhook för att generera en mottagande URL och klistra in den i profilen 7stamp. I Zapier, använd Webhooks by Zapier → Catch Hook för samma ändamål. Profilen 7stamp äger prenumerationen eftersom den nuvarande API inte visar slutpunkter för automatisk webhook-registrering.

Säkerhets- och leveranskontrakt

Använd avsnittet Webhooks i den offentliga OpenAPI referensen som källa för det aktuella nyttolastschemat och fältets betydelse. Kräv HTTPS, håll mottagaren URL borta från offentliga loggar och gör behandlingen idempotent. Bekräfta proceduren för begäran-autentisering/signature för din 7stamp-profil under onboarding innan du tillämpar ett specifikt rubriknamn eller försök igen i produktion.

Vanliga frågor

Kan jag bara välja vissa webhook-evenemang?

Ja. Välj händelsetyper i 7stamp-profilens webhook-inställningar så att mottagaren bara får de händelser som har betydelse för dess arbetsflöde.

Hur ansluter jag webhooks till Make eller Zapier?

Skapa den mottagande webhook i Make eller en Catch Hook i Zapier, kopiera den genererade URL, klistra sedan in den i ⟦19899's web⟧-event och skicka inställningarna för ⟦19899 web⟧.

Hur ska jag matcha ett evenemang med min CRM-kontakt?

Använd External ID och, när det finns, External Source. Dessa är de identifierare som din integration tillhandahöll när kortet skapades eller skannades.

Ska jag anta en signaturrubrik eller försöka tajming igen?

Nej. Använd det nuvarande leveranskontraktet OpenAPI/profile och bekräfta autentiseringsproceduren för din profil under introduktionen innan du hårdkodar en rubrik eller gör ett nytt antagande.

Nästa steg

Redo att skicka den första korthändelsen?

Skapa en mottagare, klistra in dess HTTPS URL i profilen, kör en engångsskanning och validera matchningen External ID innan du aktiverar nedströmsautomatisering.