Przejdź do treści
Centrum pomocy Webhooki leadów: Zapier, Make i własny system
Leady i kontakt

Webhooki leadów: Zapier, Make i własny system

Każdy nowy lead może automatycznie trafiać do Twojego CRM, arkusza albo powiadomienia. Konfiguracja webhooka, format danych i podpis HMAC.

Do czego to służy

Webhook to adres w Twoim systemie, pod który platforma wysyła każdy nowy lead od razu po zgłoszeniu. Dzięki temu zapytania z formularzy lądują automatycznie tam, gdzie pracujesz: w CRM, arkuszu Google, na Slacku albo w dowolnej automatyzacji.

Funkcja planów Pro i wyższych. Znajdziesz ją w panelu strony, w sekcji Leady → Webhooki / Zapier.

Zapier i Make w trzy kroki

  1. W Zapierze utwórz Zap z wyzwalaczem Webhooks by Zapier → Catch Hook (w Make: moduł Webhooks → Custom webhook). Skopiuj wygenerowany adres.
  2. W panelu strony wklej adres w Leady → Webhooki / Zapier i kliknij Dodaj. Możesz ograniczyć webhook do jednego formularza albo zostawić „wszystkie formularze".
  3. Kliknij Wyślij test. W Zapierze/Make zobaczysz przykładowy lead i na jego polach zmapujesz dalsze kroki (wiersz w arkuszu, kontakt w CRM, wiadomość na Slacku).

Format danych

Wysyłamy żądanie POST z treścią JSON. Najważniejsze pola:

  • event: lead.created (test z panelu wysyła lead.test),
  • lead: imię i nazwisko, e-mail, telefon, wiadomość, źródło, punktacja, adres strony, z której przyszło zgłoszenie, oraz parametry UTM kampanii,
  • lead.fields: odpowiedzi z dodatkowych pól formularza (kluczem jest etykieta pola z edytora),
  • form i website: który formularz i która strona.

Podpis i bezpieczeństwo

Każde żądanie ma nagłówek X-Kompasfirm-Signature z podpisem HMAC SHA-256 treści, liczonym sekretem webhooka (widocznym w panelu). Jeśli odbierasz leady własnym systemem, porównaj podpis, zanim zaufasz danym. Zapier i Make mogą ten nagłówek po prostu zignorować.

Nieudane dostawy ponawiamy, a licznik błędów widzisz przy webhooku. Po 20 nieudanych próbach z rzędu webhook wyłącza się sam; po naprawie endpointu włączysz go jednym kliknięciem.

Potrzebujesz więcej szczegółów? Zajrzyj do dokumentacji albo napisz na kontakt@kompasfirm.pl.