Arendaja integreerimine

7stamp Veebihaagid

Saadaval

Edastage kõik lojaalsussündmused numbrilt 7stamp oma süsteemidesse reaalajas. Ei küsitlemist ega plaanitud API kõnesid. Sündmused saabuvad HTTPS POST päringutena mõne sekundi jooksul pärast toimumist.

Kasutage veebihaake, et hoida oma CRM, ERP või kohandatud taustaprogramm sünkroonis lojaalsuspoolel toimuvaga: kes liitus, kes sai templi, kes lunastas vautšeri, kes käivitas sünnipäevakingituse ja kes muutus passiivseks. Seejärel otsustavad teie süsteemid, mida nende andmetega teha.

Mida saate veebihaagidega teha

Veebihaagid on integratsioonivirna väljaminev pool. Need peegeldavad kliendi- ja tasustamistegevust süsteemidesse, mida te juba usaldate müügi, teeninduse, analüütika ja sõnumivahetuse osas.

Peegeldage lojaalsuse ajalugu oma numbrile CRM

Iga tempel, vautšer, sünnipäev ja passiivsuse päästikud kantakse teie numbri CRM kliendikirjesse. Näete täielikku püsikliendi ajaskaala müügi, kõnede ja piletite kõrval ilma numbrile 7stamp sisse logimata.

Käivitage oma sõnumite virn

Kui klient lunastab vautšeri, saatke oma olemasolevast SMS lüüsist tänusõnum SMS. Kui klient lööb eesmärgi, postitage tähistamine numbrile Slack. Kui keegi muutub passiivseks, suunake juhtum oma kontohaldurile.

Võimsusanalüütika ja vastavusseviimine

Voogesitage sündmusi oma BI tööriista, lattu või kooskõlastuskonveierisse. Sobitage vautšeri lunastamine kviitungitega POS ja arvutage lojaalsus ROI oma mõõdikutes.

Kaardi sündmuste tüübid

SCAN — kaart sai skannimistoimingu/stamp.
REWARD_EARNED – kaardiga teeniti preemia.
VOUCHER_ISSUED — väljastati vautšer.
VOUCHER_REDEEMED – vautšer lunastati.
LOTTERY_WIN – loterii tulemuseks oli võit.
DELIVERY_INSERT – registreeriti kohaletoimetamise ja sisestuse voog.
CARD_JOINED – klient liitus kaardiga.
CARD_CAMPAIGN — toimus kaardikampaania sündmus.
BIRTHDAY_GREETING – toimus sünnipäeva õnnitlusüritus.
ADMIN_VOUCHER_ISSUE – administraator väljastas vautšeri.
CARD_ADDED_TO_WALLET — klient lisas kaardi oma rahakotti.
CARD_REMOVED_FROM_WALLET — klient võttis kaardi rahakotist välja.

Looge turvaline veebihaagi vastuvõtja

Kinnitage pärast vastupidavat käsitsemist

Teie lõpp-punkt peaks aktsepteerima HTTPS POST, kinnitama päringu kuju, säilitama või asetama sündmuse järjekorda ja seejärel tagastama eduka 2xx vastuse. Ärge tehke aeglast numbrit CRM või sõnumsidekõnet enne kinnitust, kui seda saab turvaliselt järjekorda panna.

Korreleeruge numbriga External ID

Igal seotud sündmusel võib olla External ID ja valikuline External Source, mida kasutasite kaardi loomisel või skannimisel. Kasutage seda paari oma numbrite CRM, POS värskendamiseks või tellimiseks ilma nime või e-posti aadressi järgi arvamata.

Make tarne idempotentne

Enne kõrvalmõjude käivitamist salvestage vastupidav töötlemisvõti või sündmuse sõrmejälg. Kui teie saaja näeb sama saadetist uuesti, ei tohiks ta lisada CRM märkuse, vautšeri või sõnumi duplikaati. Käsitlege lõpp-punkti URL saladusena.

Näidissündmuse kasuliku koormuse kuju

Kopeerige see oma automatiseerimisetappi 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"
}

Veebihaagi konfigureerimine ja testimine

01

Looge oma taustaprogrammis HTTPS lõpp-punkt, CRM integratsioonikiht, ⟦9364, 6 või ⟦9364,3 Catch Hook. Make kontrollige kindlasti sihtkohta, enne kui kopeerite selle URL.

02

Avage failis 7stamp Admin Stamp Cards → API & Integrations → Webhooks.

03

Lisage lõpp-punkt URL ja valige ainult need sündmusetüübid, mida vastuvõttev töövoog tegelikult vajab.

04

Salvestage profiili sätted, seejärel käivitage sündmuse loomiseks ühekordselt kasutatav testskannimine või kaarditoiming.

05

Kontrollige vastuvõetud koormust. Sobitage External ID ja External Source oodatud kirjega ja kinnitage, et vastuvõtja tagastab eduka vastuse.

06

Lubage CRM, vautšeri või sõnumite saatmise kõrvalmõjud alles pärast seda, kui teil on taasesituse ohutu käsitsemine ja tõrgete jälgimine.

Koodita valikud: Make ja Zapier

Dokumendis Make kasutage vastuvõtva numbri URL loomiseks numbrit Webhooks → Custom webhook ja kleepige see profiili 7stamp. Dokumendis Zapier kasutage samal eesmärgil numbrit Webhooks by Zapier → Catch Hook. Profiil 7stamp omab tellimust, kuna praegune API ei avalda veebihaagi automaatse registreerimise lõpp-punkte.

Turva- ja tarneleping

Kasutage avaliku OpenAPI viite jaotist Veebihaagid praeguse kasuliku koormuse skeemi ja välja tähenduse allikana. Nõua HTTPS, hoidke vastuvõtja URL avalikest logidest eemal ja muutke töötlemine idempotentseks. Enne konkreetse päise nime või uuesti proovimise poliitika jõustamist tootmisprotsessis kinnitage oma profiili 7stamp autentimise päringu protseduur /signature.

Korduma kippuvad küsimused

Kas ma saan valida ainult teatud veebihaagi sündmused?

Jah. Valige profiili 7stamp veebihaagi seadetes sündmuste tüübid, et vastuvõtja saaks ainult need sündmused, mis on tema töövoo jaoks olulised.

Kuidas ühendada veebihaake numbritega Make või Zapier?

Looge vastuvõttev veebihaak dokumendis Make või Catch Hook numbris Zapier, kopeerige loodud URL, seejärel kleepige see profiili 7stamp veebihaagi seadetesse ja saatke testsündmus.

Kuidas peaksin sündmuse sobitama oma CRM kontaktiga?

Kasutage External ID ja olemasolu korral External Source. Need on identifikaatorid, mille teie integratsioon andis kaardi loomisel või skannimisel.

Kas ma peaksin eeldama allkirja päise või uuesti proovimise ajastust?

Ei. Kasutage praegust tarnelepingut OpenAPI/profile ja kinnitage liitumise ajal oma profiili autentimisprotseduur, enne kui päise kõvasti kodeerite või oletust uuesti proovite.

Järgmine samm

Kas olete valmis saatma esimest kaardisündmust?

Looge vastuvõtja, kleepige selle HTTPS URL profiili, käivitage ühekordne skannimine ja kinnitage sobiv External ID enne allavoolu automatiseerimise lubamist.