Integracija za razvojne programere

7stamp Webhookovi

Dostupno

Pošaljite svaki događaj vjernosti s 7stamp na svoje vlastite sustave u stvarnom vremenu. Nema glasanja i zakazanih API poziva. Događaji stižu kao zahtjevi HTTPS POST unutar nekoliko sekundi nakon što se dogode.

Upotrijebite web-dojavnike kako biste svoju CRM, ERP ili prilagođenu pozadinu uskladili s onim što se događa na strani vjernosti: tko se pridružio, tko je dobio pečat, tko je iskoristio vaučer, tko je pokrenuo rođendanski dar, a tko je postao neaktivan. Zatim vaši sustavi odlučuju što će učiniti s tim podacima.

Što možete učiniti s web-dojavnicima

Web-dojavnici su izlazna strana integracijskog stoga. Oni odražavaju aktivnosti korisnika i nagrađivanja u sustave kojima već vjerujete za prodaju, usluge, analitiku i slanje poruka.

Zrcalite povijest vjernosti u svoj CRM

Svaka markica, vaučer, rođendan i okidač neaktivnosti slijeću u evidenciju korisnika u vašem CRM. Vidjet ćete punu vremensku traku vjernosti pored prodaje, poziva i ulaznica bez prijave na 7stamp.

Pokrenite vlastiti skup poruka

Kada korisnik iskoristi vaučer, pošaljite zahvalu SMS sa svog postojećeg pristupnika SMS. Kada kupac postigne cilj, objavite slavlje u Slack. Kada netko postane neaktivan, proslijedite slučaj svom upravitelju računa.

Analitika napajanja i usklađivanje

Prenesite događaje u svoj BI alat, skladište ili cjevovod za usklađivanje. Usporedite iskorištenja vaučera s računima od POS i izračunajte lojalnost ROI u vlastitoj metrici.

Vrste događaja kartice

SCAN — Kartica je primila akciju skeniranja/stamp.
REWARD_EARNED — Na kartici je osvojena nagrada.
VOUCHER_ISSUED — Vaučer je izdan.
VOUCHER_REDEEMED — Vaučer je iskorišten.
LOTTERY_WIN — Lutrija je rezultirala dobitkom.
DELIVERY_INSERT — Zabilježen je tijek isporuke-umetanja.
CARD_JOINED — Korisnik se pridružio kartici.
CARD_CAMPAIGN — Dogodio se događaj kartične kampanje.
BIRTHDAY_GREETING — Desila se rođendanska čestitka.
ADMIN_VOUCHER_ISSUE — Administrator je izdao vaučer.
CARD_ADDED_TO_WALLET — Korisnik je dodao karticu u svoj novčanik.
CARD_REMOVED_FROM_WALLET — Kupac je izvadio karticu iz svog novčanika.

Izgradite siguran webhook prijemnik

Potvrdite nakon dugotrajnog rukovanja

Vaša bi krajnja točka trebala prihvatiti HTTPS POST, potvrdite oblik zahtjeva, ustrajte ili stavite događaj u red čekanja, zatim vratite uspješan odgovor 2xx. Nemojte upućivati ​​spori CRM ili poziv s porukama prije potvrde ako se može sigurno staviti u red.

Poveži s External ID

Svaki povezani događaj može nositi External ID i opcijski External Source koje ste koristili prilikom izrade ili skeniranja kartice. Upotrijebite ovaj par za ažuriranje vlastitog zapisa CRM, POS ili narudžbe bez nagađanja iz imena ili e-pošte.

Make isporuka idempotentna

Pohranite trajni ključ za obradu ili otisak prsta događaja prije nego što izazovete nuspojave. Ako vaš primatelj ponovo vidi istu isporuku, ne bi trebao dodati duplikat CRM bilješke, vaučera ili poruke. Tretirajte krajnju točku URL kao tajnu.

Primjer korisnog oblika događaja

Kopirajte ovo u svoj korak automatizacije 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"
}

Konfigurirajte i testirajte webhook

01

Stvorite HTTPS krajnju točku u svojoj pozadini, CRM integracijskom sloju, Make webhooku ili Zapier Catch Hook. Make svakako kontrolirajte odredište prije kopiranja njegovog URL.

02

U 7stamp Admin otvorite Stamp Cards → API & Integrations → Webhooks.

03

Dodajte krajnju točku URL i odaberite samo one vrste događaja koje tijek rada primanja zapravo treba.

04

Spremite postavke profila, a zatim pokrenite jednokratno probno skeniranje ili akciju kartice za stvaranje događaja.

05

Pregledajte primljeni teret. Uskladite External ID i External Source s očekivanim zapisom i potvrdite da je primatelj vratio uspješan odgovor.

06

Omogućite CRM, vaučer ili neželjene efekte slanja poruka tek nakon što imate sigurno rukovanje i praćenje kvarova.

Opcije bez koda: Make i Zapier

U Make, koristite Webhooks → Custom webhook za generiranje primanja URL i zalijepite ga u 7stamp profil. U Zapier, koristite Webhooks by Zapier → Catch Hook za istu svrhu. Profil 7stamp posjeduje pretplatu jer trenutni API ne izlaže automatske krajnje točke registracije webhooka.

Ugovor o sigurnosti i isporuci

Koristite odjeljak Webhooks javne reference OpenAPI kao izvor za trenutnu shemu nosivosti i značenje polja. Zahtijevajte HTTPS, držite primatelja URL izvan javnih dnevnika i učinite obradu idempotentnom. Potvrdite proceduru provjere autentičnosti zahtjeva/signature za svoj profil 7stamp tijekom integracije prije nego što nametnete određeni naziv zaglavlja ili ponovno pokušate politiku u proizvodnji.

Često postavljana pitanja

Mogu li odabrati samo određene događaje web-dojavnika?

Da. Odaberite vrste događaja u postavkama webhooka profila 7stamp tako da primatelj dobiva samo one događaje koji su važni za njegov tijek rada.

Kako mogu spojiti webhookove na Make ili Zapier?

Stvorite prijemni web-dojavnik u Make ili Catch Hook u Zapier, kopirajte generirani URL, zatim ga zalijepite u postavke web-dojavnika profila 7stamp i pošaljite testni događaj.

Kako da povežem događaj sa svojim CRM kontaktom?

Koristite External ID i, ako postoji, External Source. Ovo su identifikatori koje je vaša integracija dala kada je kartica izrađena ili skenirana.

Trebam li pretpostaviti zaglavlje potpisa ili vrijeme ponovnog pokušaja?

Ne. Upotrijebite trenutni ugovor o isporuci OpenAPI/profile i potvrdite proceduru provjere autentičnosti za svoj profil tijekom uključivanja prije tvrdog kodiranja zaglavlja ili pokušaja ponovno.

Sljedeći korak

Jeste li spremni poslati prvi događaj kartice?

Napravite prijemnik, zalijepite njegov HTTPS URL u profil, pokrenite skeniranje za jednokratnu upotrebu i potvrdite odgovarajući External ID prije nego što omogućite automatizaciju nizvodno.