Odbij historię lojalnościową na swoim CRM
Każda pieczątka, voucher i życzenia urodzinowe trafiają do rekordu klienta w Twoim CRM. Widzisz pełną historię lojalności obok sprzedaży, połączeń i zgłoszeń bez logowania do 7Stamp.
Integracja programistów
Wysyłaj każde zdarzenie lojalnościowe z 7Stamp do własnych systemów w czasie rzeczywistym. Bez odpytywania i planowanych wywołań API. Zdarzenia przychodzą jako żądania HTTPS POST w ciągu kilku sekund od ich wystąpienia. Webhooks wymagają dodatku Webhooks & Events.
Używaj webhooków, aby Twój CRM, ERP lub własny backend były zsynchronizowane z tym, co dzieje się po stronie lojalności: kto dołączył, kto dostał pieczątkę, kto zrealizował voucher i kto otrzymał życzenia urodzinowe. Potem Twoje systemy decydują, co zrobić z tymi danymi.
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.
Każda pieczątka, voucher i życzenia urodzinowe trafiają do rekordu klienta w Twoim CRM. Widzisz pełną historię lojalności obok sprzedaży, połączeń i zgłoszeń bez logowania do 7Stamp.
Gdy klient zrealizuje voucher, wyślij podziękowanie SMS-em z istniejącej bramki SMS. Gdy klient osiągnie cel, opublikuj gratulacje w Slacku. Gdy zostaną wysłane życzenia urodzinowe, przekaż sprawę swojemu opiekunowi konta.
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.
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.
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.
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.
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
}
}
} Sprawdź, czy dodatek Webhooks & Events jest aktywny w Twoim płatnym planie. Utwórz endpoint HTTPS w swoim backendzie, warstwie integracji CRM, webhooku Make lub Catch Hook Zapier. Upewnij się, że kontrolujesz miejsce docelowe, zanim skopiujesz jego URL.
W 7Stamp Admin otwórz Stamp Cards → API & Integrations → Webhooks.
Dodaj adres URL endpointu. Webhook otrzymuje każde zdarzenie karty w profilu, więc filtruj po data.event_type w swoim odbiorniku.
Zapisz ustawienia profilu, a następnie uruchom jednorazowy skan testowy lub akcję karty, aby wygenerować zdarzenie.
Sprawdź otrzymany ładunek. Dopasuj External ID i External Source do oczekiwanego rekordu i potwierdź, że odbiorca zwrócił pomyślną odpowiedź.
Włącz efekty uboczne CRM, kuponu lub wiadomości dopiero po zapewnieniu bezpiecznej obsługi i monitorowania błędów.
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.
Jako źródło aktualnego schematu payloadu traktuj sekcję Webhooks w publicznej dokumentacji OpenAPI. Treść żądania to koperta: profile_id i profile_name wskazują profil 7Stamp, event_id identyfikuje zdarzenie, a samo zdarzenie karty znajduje się w data (dla adresu URL z Make lub Zapier klucz to card_event). Każde doręczenie jest podpisane w jednym nagłówku, X-Webhook-Signature: t=…,s=…. Oblicz HMAC-SHA256 sekretem webhooka z t połączonego z surową treścią żądania, zakoduj wynik szesnastkowo i porównaj go z s; sekret znajdziesz na stronie webhooka w 7Stamp Admin. Używaj X-Webhook-Event-Id, aby odrzucać powtórzone doręczenia: ponowna próba jest podpisywana od nowa z nowym t. Endpoint możesz też zabezpieczyć za pomocą Basic Auth. Wymagaj HTTPS i nie umieszczaj adresu URL odbiornika w publicznych logach.
Nie. Webhook 7Stamp otrzymuje każde zdarzenie karty w profilu. Filtruj po data.event_type w swoim odbiorniku; w Make i Zapier zdarzenie przychodzi w card_event, więc filtruj po card_event.event_type.
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.
Używaj data.external_id oraz, jeśli jest obecne, data.external_source: wracają w każdym webhooku dla kart wydanych przez API z własnym ID. Klient, który sam pobrał kartę, nie ma External ID, więc dopasuj go po data.user.email. Adres Apple „Hide My Email” to adres przekierowujący, a nie ten, który masz w CRM.
Rozdziel nagłówek X-Webhook-Signature na t i s, oblicz HMAC-SHA256 sekretem webhooka z 7Stamp Admin z t połączonego z surową treścią żądania, zakoduj wynik szesnastkowo i porównaj go z s. Weź t dokładnie w takiej postaci, w jakiej zostało wysłane, a treść jako surowe odebrane bajty, przed jakimkolwiek parsowaniem JSON. Odrzucaj doręczenie z X-Webhook-Event-Id, który został już przetworzony: ponowna próba jest podpisywana od nowa z nowym t.
Powiązane strony
Następny krok
Utwórz odbiornik, wklej jego HTTPS URL do profilu, uruchom jednorazowe skanowanie i zatwierdź dopasowanie External ID przed włączeniem dalszej automatyzacji.