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.
Integracija za razvojne programere
7Stamp Webhookovi
DostupnoPoš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.
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 {
"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
}
}
}Konfigurirajte i testirajte webhook
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.
U 7Stamp Admin otvorite Stamp Cards → API & Integrations → Webhooks.
Dodajte URL krajnje točke. Webhook prima svaki događaj kartice u profilu, pa filtrirajte po data.event_type u svom prijamniku.
Spremite postavke profila, a zatim pokrenite jednokratno probno skeniranje ili akciju kartice za stvaranje događaja.
Pregledajte primljeni teret. Uskladite External ID i External Source s očekivanim zapisom i potvrdite da je primatelj vratio uspješan odgovor.
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
Kao izvor za trenutačnu shemu sadržaja (payload) koristite odjeljak Webhooks javne reference OpenAPI. Tijelo zahtjeva je omotnica: profile_id i profile_name označavaju profil 7Stamp, event_id identificira događaj, a sam događaj kartice nalazi se u data (za URL iz Makea ili Zapiera ključ je card_event). Svaka je isporuka potpisana u jednom zaglavlju, X-Webhook-Signature: t=…,s=…. Izračunajte HMAC-SHA256 tajnim ključem webhooka nad t iza kojeg slijedi neobrađeno tijelo zahtjeva, rezultat kodirajte heksadecimalno i usporedite ga s vrijednošću s; tajni ključ nalazi se na stranici webhooka u 7Stamp Admin. Pomoću X-Webhook-Event-Id odbacujte ponovljene isporuke: ponovni pokušaj ponovno se potpisuje s novim t. Krajnju točku možete zaštititi i s Basic Auth. Zahtijevajte HTTPS i držite URL prijamnika izvan javnih zapisnika.
Često postavljana pitanja
Mogu li odabrati samo određene događaje web-dojavnika?
Ne. Webhook 7Stamp prima svaki događaj kartice u profilu. U svom prijamniku filtrirajte po data.event_type; u Makeu i Zapieru događaj dolazi pod card_event, pa filtrirajte po card_event.event_type.
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 data.external_id i, ako postoji, data.external_source: vraćaju se u svakom webhooku za kartice koje ste izdali putem API-ja s vlastitim ID-jem. Kupac koji je sam preuzeo karticu nema External ID, pa ga povežite prema data.user.email. Adresa Apple „Hide My Email“ adresa je za prosljeđivanje, a ne ona iz vašeg CRM-a.
Kako provjeriti je li webhook stigao od 7Stampa?
Rastavite zaglavlje X-Webhook-Signature na t i s, izračunajte HMAC-SHA256 tajnim ključem webhooka iz 7Stamp Admin nad t iza kojeg slijedi neobrađeno tijelo zahtjeva, rezultat kodirajte heksadecimalno i usporedite ga s vrijednošću s. Uzmite t točno onako kako je poslan, a tijelo kao neobrađene primljene bajtove, prije bilo kakvog parsiranja JSON-a. Odbacite isporuku čiji ste X-Webhook-Event-Id već obradili: ponovni pokušaj ponovno se potpisuje s novim t.
Povezane stranice
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.