Integracja programistów

7stamp Webhooki

Dostępny

Przekaż każde zdarzenie lojalnościowe z 7stamp do swoich własnych systemów w czasie rzeczywistym. Brak odpytywania i brak zaplanowanych połączeń API. Zdarzenia pojawiają się jako żądania HTTPS POST w ciągu kilku sekund od zdarzenia.

Użyj webhooków, aby synchronizować swój CRM, ERP lub niestandardowy backend z tym, co dzieje się po stronie lojalnościowej: kto dołączył, kto otrzymał pieczątkę, kto zrealizował kupon, kto uruchomił prezent urodzinowy i kto stał się nieaktywny. Następnie Twoje systemy decydują, co zrobić z tymi danymi.

Co można zrobić z webhookami

Webhooki to wychodząca strona stosu integracji. Odzwierciedlają one aktywność klientów i nagród w systemach, którym już ufasz w zakresie sprzedaży, obsługi, analiz i przesyłania wiadomości.

Odbij historię lojalnościową na swoim CRM

Każdy znaczek, kupon, urodziny i brak aktywności trafiają do rekordu klienta w Twoim CRM. Pełny harmonogram lojalności widzisz obok sprzedaży, połączeń i biletów bez konieczności logowania się do 7stamp.

Uruchom własny stos wiadomości

Kiedy klient zrealizuje kupon, wyślij podziękowanie SMS z istniejącej bramy SMS. Kiedy klient osiągnie cel, opublikuj wiadomość w Slack. Gdy ktoś stanie się nieaktywny, skieruj sprawę do menedżera konta.

Analiza mocy i uzgadnianie

Przesyłaj strumieniowo zdarzenia do swojego BI narzędzia, magazynu lub potoku uzgadniania. Dopasuj wykorzystanie kuponów do POS wpływów i oblicz lojalność ROI według własnych wskaźników.

Typy zdarzeń karty

SCAN — Karta otrzymała akcję skanowania/stamp.
REWARD_EARNED — Na karcie została zdobyta nagroda.
VOUCHER_ISSUED — Wystawiono kupon.
VOUCHER_REDEEMED — Kupon został zrealizowany.
LOTTERY_WIN — Loteria zakończyła się wygraną.
DELIVERY_INSERT — Zarejestrowano przepływ dostawa-wkładka.
CARD_JOINED — Klient dołączył do karty.
CARD_CAMPAIGN — Wystąpiło wydarzenie w kampanii kart.
BIRTHDAY_GREETING — Wystąpiło wydarzenie z życzeniami urodzinowymi.
ADMIN_VOUCHER_ISSUE — Administrator wystawił kupon.
CARD_ADDED_TO_WALLET — Klient dodał kartę do swojego portfela.
CARD_REMOVED_FROM_WALLET — Klient wyjął kartę ze swojego portfela.

Zbuduj bezpieczny odbiornik webhooka

Potwierdź po trwałej obsłudze

Twój punkt końcowy powinien zaakceptować HTTPS POST, zatwierdź kształt żądania, utrwal lub umieść zdarzenie w kolejce, a następnie zwróć pomyślną odpowiedź 2xx. Nie wykonuj powolnego połączenia CRM ani wiadomości tekstowych przed potwierdzeniem, jeśli można je bezpiecznie ustawić w kolejce.

Koreluje z External ID

Każde powiązane zdarzenie może zawierać External ID i opcjonalne External Source, których użyłeś podczas tworzenia lub skanowania karty. Użyj tej pary, aby zaktualizować swój własny rekord CRM, POS lub zamówienia bez zgadywania na podstawie nazwiska lub adresu e-mail.

Make idempotent dostarczania

Przechowuj trwały klucz przetwarzania lub odcisk palca zdarzenia przed wywołaniem efektów ubocznych. Jeśli odbiorca ponownie zobaczy tę samą dostawę, nie powinien dodawać duplikatu CRM notatki, kuponu ani wiadomości. Traktuj punkt końcowy URL jako sekret.

Przykładowy kształt ładunku zdarzenia

Skopiuj to do swojego kroku automatyzacji 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"
}

Skonfiguruj i przetestuj webhook

01

Utwórz HTTPS punkt końcowy w swoim backendzie, CRM warstwę integracji, Make webhook lub Zapier Catch Hook. Make upewnij się, że kontrolujesz miejsce docelowe przed skopiowaniem jego URL.

02

W 7stamp Admin otwórz Stamp Cards → API & Integrations → Webhooks.

03

Dodaj punkt końcowy URL i wybierz tylko typy zdarzeń, których faktycznie potrzebuje odbierający przepływ pracy.

04

Zapisz ustawienia profilu, a następnie uruchom jednorazowy skan testowy lub akcję karty, aby wygenerować zdarzenie.

05

Sprawdź otrzymany ładunek. Dopasuj External ID i External Source do oczekiwanego rekordu i potwierdź, że odbiorca zwrócił pomyślną odpowiedź.

06

Włącz efekty uboczne CRM, kuponu lub wiadomości dopiero po zapewnieniu bezpiecznej obsługi i monitorowania błędów.

Opcje bez kodu: Make i Zapier

W Make użyj Webhooks → Custom webhook, aby wygenerować odbiorczy URL i wklej go do profilu 7stamp. W Zapier użyj Webhooks by Zapier → Catch Hook w tym samym celu. Profil 7stamp jest właścicielem subskrypcji, ponieważ bieżący API nie udostępnia punktów końcowych automatycznej rejestracji elementu webhook.

Umowa o zabezpieczeniu i dostawie

Użyj sekcji Webhooks w publicznym odnośniku OpenAPI jako źródła bieżącego schematu ładunku i znaczenia pola. Wymagaj HTTPS, trzymaj odbiornik URL poza dziennikami publicznymi i spraw, aby przetwarzanie było idempotentne. Potwierdź procedurę żądania-uwierzytelniania/signature dla swojego profilu 7stamp podczas wdrażania, zanim wymusisz określoną nazwę nagłówka lub zasady ponawiania prób w środowisku produkcyjnym.

Często zadawane pytania

Czy mogę wybrać tylko określone zdarzenia webhooka?

Tak. Wybierz typy zdarzeń w ustawieniach webhooka profilu 7stamp, aby odbiorca otrzymywał tylko zdarzenia istotne dla jego przepływu pracy.

Jak podłączyć webhooki do Make lub Zapier?

Utwórz odbiorczy webhook w Make lub Catch Hook w Zapier, skopiuj wygenerowany URL, następnie wklej go do ustawień webhooka profilu 7stamp i wyślij zdarzenie testowe.

Jak mam dopasować wydarzenie do mojego kontaktu CRM?

Użyj External ID i, jeśli jest obecny, External Source. Są to identyfikatory dostarczone przez integrację podczas tworzenia lub skanowania karty.

Czy powinienem przyjąć nagłówek podpisu, czy też określić czas ponownej próby?

Nie. Skorzystaj z aktualnej umowy dostawy OpenAPI/profile i potwierdź procedurę uwierzytelniania swojego profilu podczas wdrażania przed zakodowaniem nagłówka na stałe lub założeniem ponownej próby.

Następny krok

Gotowy do wysłania pierwszego zdarzenia karty?

Utwórz odbiornik, wklej jego HTTPS URL do profilu, uruchom jednorazowe skanowanie i zatwierdź dopasowanie External ID przed włączeniem dalszej automatyzacji.