Utviklerintegrasjon

7stamp Webhooks

Tilgjengelig

Send alle lojalitetsbegivenheter fra 7stamp til dine egne systemer i sanntid. Ingen avstemning og ingen planlagte API-anrop. Hendelser kommer som HTTPS POST forespørsler innen sekunder etter at de har skjedd.

Bruk webhooks for å holde CRM, ERP eller egendefinerte backend synkronisert med det som skjer på lojalitetssiden: hvem som ble med, hvem som fikk et stempel, hvem som løste inn en kupong, hvem som utløste en bursdagsgave og hvem som ble inaktiv. Deretter bestemmer systemene dine hva de skal gjøre med disse dataene.

Hva du kan gjøre med webhooks

Webhooks er den utgående siden av integrasjonsstakken. De speiler kunde- og belønningsaktivitet inn i systemene du allerede stoler på for salg, service, analyser og meldinger.

Speil lojalitetshistorikk inn i CRM

Hvert stempel, kupong, bursdag og inaktivitetsutløser lander på kundeposten i CRM. Du ser hele lojalitetstidslinjen ved siden av salg, anrop og billetter uten å logge på 7stamp.

Utløs din egen meldingsstabel

Når en kunde løser inn en kupong, send en takk SMS fra din eksisterende SMS-gateway. Når en kunde når målet, legg inn en feiring i Slack. Når noen blir inaktive, sender du saken til din kontoadministrator.

Strømanalyse og avstemming

Strøm hendelser inn i BI-verktøyet, lageret eller avstemmingspipelinen. Match kuponginnløsninger mot POS-kvitteringer og beregn lojalitet ROI i dine egne beregninger.

Korthendelsestyper

SCAN — Et kort mottok en skanning/stamp-handling.
REWARD_EARNED — En belønning ble opptjent på kortet.
VOUCHER_ISSUED — En kupong ble utstedt.
VOUCHER_REDEEMED — En kupong ble innløst.
LOTTERY_WIN — Et lotteri resulterte i en gevinst.
DELIVERY_INSERT — En levering-innsatsflyt ble registrert.
CARD_JOINED — En kunde ble med på et kort.
CARD_CAMPAIGN — En kortkampanjehendelse skjedde.
BIRTHDAY_GREETING — En bursdagshilsen skjedde.
ADMIN_VOUCHER_ISSUE — En administrator utstedte en kupong.
CARD_ADDED_TO_WALLET — En kunde la til kortet i lommeboken sin.
CARD_REMOVED_FROM_WALLET — En kunde fjernet kortet fra lommeboken.

Bygg en sikker webhook-mottaker

Bekreft etter varig håndtering

Endepunktet ditt bør godta HTTPS POST, validere forespørselsformen, vedvare eller sette hendelsen i kø, og deretter returnere et vellykket 2xx-svar. Ikke foreta en sakte CRM eller meldingsanrop før bekreftelsen hvis den kan settes i kø på en sikker måte.

Korreler med External ID

Hver relatert hendelse kan ha External ID og valgfri External Source som du brukte da du opprettet eller skannet kortet. Bruk dette paret til å oppdatere din egen CRM, POS, eller bestille post uten å gjette fra navn eller e-post.

Make levering idempotent

Oppbevar en holdbar prosesseringsnøkkel eller hendelsesfingeravtrykk før du utløser bivirkninger. Hvis mottakeren ser den samme leveringen igjen, skal den ikke legge til en duplikat CRM-notat, kupong eller melding. Behandle endepunktet URL som en hemmelighet.

Eksempel på hendelsesnyttelastform

Kopier dette inn i automatiseringstrinnet 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"
}

Konfigurer og test en webhook

01

Opprett et HTTPS endepunkt i din backend, CRM integrasjonslag, ⟦23700 eller ⟦23703 Zapier Catch Hook. Make sørg for at du kontrollerer destinasjonen før du kopierer dens URL.

02

I 7stamp Admin, åpne Stamp Cards → API & Integrations → Webhooks.

03

Legg til endepunktet URL og velg bare hendelsestypene mottaksarbeidsflyten faktisk trenger.

04

Lagre profilinnstillingene, og utløs deretter en engangstestskanning eller korthandling for å produsere en hendelse.

05

Inspiser den mottatte nyttelasten. Match External ID og External Source til den forventede posten og bekreft at mottakeren returnerer et vellykket svar.

06

Aktiver CRM, kuponger eller meldingsbivirkninger bare etter at du har replay-sikker håndtering og overvåking for feil.

Alternativer uten kode: Make og Zapier

I Make, bruk Webhooks → Custom webhook for å generere en mottaker URL og lim den inn i 7stamp-profilen. I Zapier, bruk Webhooks by Zapier → Catch Hook til samme formål. 7stamp-profilen eier abonnementet fordi gjeldende API ikke viser endepunkter for automatisk webhook-registrering.

Sikkerhets- og leveringskontrakt

Bruk Webhooks-delen av den offentlige OpenAPI-referansen som kilde for gjeldende nyttelastskjema og feltbetydning. Krev HTTPS, hold mottakeren URL unna offentlige logger, og gjør behandlingen idempotent. Bekreft forespørsel-autentiseringsprosedyren/signature for 7stamp-profilen din under onboarding før du håndhever et spesifikt overskriftsnavn eller prøv på nytt i produksjon.

Vanlige spørsmål

Kan jeg velge bare visse webhook-hendelser?

Ja. Velg hendelsestypene i 7stamp-profilens webhook-innstillinger slik at mottakeren bare får hendelsene som betyr noe for arbeidsflyten.

Hvordan kobler jeg webhooks til Make eller Zapier?

Opprett den mottakende webhook i Make eller en Catch Hook i Zapier, kopier den genererte URL, lim den inn i Make og send en test-innstilling for ⟦23723 på nett⟧.

Hvordan skal jeg matche et arrangement med min CRM-kontakt?

Bruk External ID og, når tilstede, External Source. Dette er identifikatorene din integrasjon leverte da kortet ble opprettet eller skannet.

Bør jeg anta en signaturoverskrift eller prøve timing på nytt?

Nei. Bruk gjeldende OpenAPI/profile leveringskontrakt og bekreft autentiseringsprosedyren for profilen din under onboarding før du hardkoder en overskrift eller prøver på nytt.

Neste trinn

Klar til å sende den første kortbegivenheten?

Opprett en mottaker, lim inn HTTPS URL i profilen, kjør en engangsskanning og valider samsvarende External ID før du aktiverer nedstrømsautomatisering.