Webhook wysyła dane na wybrany przez ciebie URL w chwili, gdy coś się wydarzy, np. gdy ktoś się zapisze lub wygra nagrodę. System, który je odbiera, konfiguruje twój deweloper. Webhooki są dostępne od planu Basic wzwyż.
Dodaj webhook
Webhooki możesz dodać do kampanii – w edytorze w Połącz > Webhooki – albo dla całego konta w Ustawienia > Webhooki.
- Kliknij Dodaj webhook.
- Wpisz Adres URL payloadu. Musi korzystać z HTTPS.
- Wybierz Typ zawartości: application/json lub application/x-www-form-urlencoded.
- Wybierz Metoda: POST lub GET. Używaj POST, chyba że twój system wymaga GET, który wysyła dane w adresie URL.
- Wpisz Sekret, aby podpisywać żądania (zalecane).
- Wybierz zdarzenia w sekcji Które zdarzenia mają wywoływać webhook?:
- „Gdy zostanie utworzony nowy lead” (na poziomie konta)
- „Za każdym razem, gdy lead weźmie udział w kampanii”
- „Gdy lead wygra nagrodę”
- Upewnij się, że opcja Aktywna jest włączona, i zapisz.
W edytorze kampanii możesz też wybrać Basic Auth w sekcji Uwierzytelnianie i użyć opcji Własny payload, aby samodzielnie ustalić nazwy pól.
Co jest wysyłane
Treść zawiera event i obiekt data z kampanią (id i nazwa), polami leada, kanałem, zgodami wraz z treścią, godziną i adresem IP, odpowiedziami z quizu, a w przypadku zwycięzców – nagrodą z kodem. Puste wartości są pomijane.
Sprawdź podpis
Jeśli ustawisz sekret, każde żądanie ma nagłówek X-Hub-Signature: sha1=, a po nim HMAC-SHA1 danych zakodowanych w JSON, z twoim sekretem jako kluczem. Oblicz to samo po swojej stronie i porównaj, aby mieć pewność, że żądanie pochodzi od Scratchera.
Dostarczenia i ponowienia
Jeśli twój URL nie odpowiada lub zwraca błąd, Scratcher próbuje ponownie dwa razy: po 5 sekundach i po minucie. Kliknij Pokaż dostarczenia (lub Zobacz dostarczenia), aby zobaczyć każde żądanie i odpowiedź, wyświetlić tylko nieudane i ponowić dostarczenie przyciskiem Spróbuj ponownie. Dostarczenia są przechowywane przez 60 dni.
Włącz Zapisuj treść odpowiedzi w logach, aby zapisywać także odpowiedź twojego systemu – to pomaga przy debugowaniu.