Integrarea dezvoltatorilor

7stamp Webhooks

Disponibil

Impinge fiecare eveniment de loialitate de la 7stamp către propriile sisteme în timp real. Fără sondaj și fără apeluri programate API. Evenimentele ajung ca solicitări HTTPS POST în câteva secunde de la producere.

Folosiți webhook-uri pentru a vă menține CRM, ERP sau backend-ul personalizat sincronizat cu ceea ce se întâmplă pe partea de loialitate: cine s-a alăturat, cine a primit o ștampilă, cine a răscumpărat un voucher, cine a declanșat un cadou de ziua de naștere și cine a devenit inactiv. Apoi sistemele dumneavoastră decid ce să facă cu acele date.

Ce puteți face cu webhook-urile

Webhook-urile sunt partea de ieșire a stivei de integrare. Ele reflectă activitatea clienților și recompensează în sistemele în care aveți deja încredere pentru vânzări, servicii, analize și mesagerie.

Oglindiți istoricul de loialitate în CRM

Fiecare ștampilă, voucher, zi de naștere și declanșator de inactivitate aterizează în evidența clientului din CRM. Veți vedea cronologia completă a fidelității lângă vânzări, apeluri și bilete fără să vă conectați la 7stamp.

Declanșați-vă propria stivă de mesagerie

Când un client valorifică un voucher, trimiteți un mesaj de mulțumire SMS de la gateway-ul dvs. existent SMS. Când un client atinge obiectivul, postați o sărbătoare în Slack. Când cineva devine inactiv, trimiteți cazul către managerul de cont.

Analiza puterii și reconciliere

Transmiteți evenimente în fluxul dvs. de instrumente BI, depozit sau conductă de reconciliere. Potriviți răscumpărările de voucher cu chitanțele POS și calculați loialitatea ROI în propriile valori.

Tipuri de evenimente card

SCAN — Un card a primit o acțiune de scanare/stamp.
REWARD_EARNED — O recompensă a fost câștigată pe card.
VOUCHER_ISSUED — A fost emis un voucher.
VOUCHER_REDEEMED — A fost valorificat un voucher.
LOTTERY_WIN — O loterie a dus la un câștig.
DELIVERY_INSERT — A fost înregistrat un flux de livrare-inserție.
CARD_JOINED — Un client s-a alăturat unui card.
CARD_CAMPAIGN — A avut loc un eveniment de campanie de carduri.
BIRTHDAY_GREETING — A avut loc un eveniment de felicitare pentru ziua de naștere.
ADMIN_VOUCHER_ISSUE — Un administrator a emis un voucher.
CARD_ADDED_TO_WALLET — Un client a adăugat cardul în portofel.
CARD_REMOVED_FROM_WALLET — Un client a scos cardul din portofel.

Construiți un receptor webhook sigur

Confirmați după o manipulare durabilă

Your endpoint should accept HTTPS POST, validate the request shape, persist or queue the event, then return a successful 2xx response. Do not make a slow CRM or messaging call before the acknowledgement if it can be queued safely.

Corelați cu External ID

Fiecare eveniment asociat poate conține External ID și External Source opțional pe care le-ați folosit la crearea sau scanarea cardului. Folosiți această pereche pentru a vă actualiza propria înregistrare CRM, POS sau pentru a comanda fără a ghici dintr-un nume sau e-mail.

Make livrare idempotent

Stocați o cheie de procesare durabilă sau o amprentă digitală pentru eveniment înainte de a declanșa efecte secundare. Dacă destinatarul vede din nou aceeași livrare, nu ar trebui să adauge o notă, un voucher sau un mesaj duplicat CRM. Tratați punctul final URL ca pe un secret.

Exemplu de formă de sarcină utilă a evenimentului

Copiați acest lucru în pasul dvs. de automatizare 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"
}

Configurați și testați un webhook

01

Create an HTTPS endpoint in your backend, CRM integration layer, Make webhook, or Zapier Catch Hook. Make sure you control the destination before copying its URL.

02

În 7stamp Admin, deschideți Stamp Cards → API & Integrations → Webhooks.

03

Adăugați punctul final URL și selectați numai tipurile de evenimente de care fluxul de lucru de recepție are de fapt nevoie.

04

Salvați setările profilului, apoi declanșați o scanare de testare de unică folosință sau o acțiune de card pentru a produce un eveniment.

05

Inspectați sarcina utilă primită. Potriviți External ID și External Source cu înregistrarea așteptată și confirmați că receptorul returnează un răspuns de succes.

06

Activați CRM, voucherul sau efectele secundare ale mesajelor numai după ce aveți o manipulare și monitorizare sigură pentru reluare pentru erori.

Opțiuni fără cod: Make și Zapier

In Make, use Webhooks → Custom webhook to generate a receiving URL and paste it into the 7stamp profile. In Zapier, use Webhooks by Zapier → Catch Hook for the same purpose. The 7stamp profile owns the subscription because the current API does not expose automatic webhook registration endpoints.

Contract de securitate și livrare

Utilizați secțiunea Webhooks din referința publică OpenAPI ca sursă pentru schema curentă de încărcare utilă și semnificația câmpului. Solicitați HTTPS, păstrați receptorul URL departe de jurnalele publice și faceți procesarea idempotent. Confirmați procedura de solicitare-autentificare/signature pentru profilul dvs. 7stamp în timpul integrării înainte de a aplica un anumit nume de antet sau a reîncerca politica în producție.

Întrebări frecvente

Pot selecta doar anumite evenimente webhook?

Da. Selectați tipurile de evenimente din setările de webhook ale profilului 7stamp, astfel încât receptorul să primească numai evenimentele care contează pentru fluxul său de lucru.

Cum conectez webhook-urile la Make sau Zapier?

Creați webhook-ul de primire în Make sau un Catch Hook în Zapier, copiați URL generat, apoi inserați-l în setările webhook-ului profilului 7stamp și trimiteți un eveniment de testare.

Cum ar trebui să potrivesc un eveniment cu persoana mea de contact CRM?

Folosiți External ID și, dacă este prezent, External Source. Acestea sunt identificatorii pe care i-a furnizat integrarea dvs. atunci când cardul a fost creat sau scanat.

Ar trebui să asum un antet de semnătură sau un timp de reîncercare?

Nu. Utilizați contractul de livrare actual OpenAPI/profile și confirmați procedura de autentificare pentru profilul dvs. în timpul integrării înainte de a codifica un antet sau a reîncerca presupunerea.

Următorul pas

Sunteți gata să trimiteți primul eveniment de card?

Creați un receptor, inserați-i HTTPS URL în profil, executați o scanare de unică folosință și validați External ID potrivit înainte de a activa automatizarea în aval.