Webhook

Co to jest webhook

Webhook działa jak dzwonek do drzwi. Zamiast co chwilę sprawdzać, czy ktoś przyszedł, system czeka, aż ktoś zadzwoni. Gdy w jednym programie wydarzy się coś ważnego, ten program sam wysyła wiadomość pod wskazany adres internetowy. Wiadomość zawiera dane o zdarzeniu, najczęściej w formacie JSON: kto wypełnił formularz, jaki numer ma zamówienie, jaka kwota wpłynęła.

Drugi system odbiera tę wiadomość i od razu coś z nią robi. Może założyć klienta w CRM, wysłać powiadomienie do zespołu albo uruchomić cały przepływ pracy. Dlatego webhook jest jednym z najczęstszych wyzwalaczy automatyzacji.

Webhook a API

Oba pojęcia dotyczą wymiany danych między systemami, ale działają w przeciwnych kierunkach. Przez API to my pytamy system o dane albo prosimy go o wykonanie operacji. Webhook to sytuacja odwrotna: system sam nas informuje, że coś się zmieniło.

W praktyce oba mechanizmy pracują razem. Webhook informuje, że przyszło nowe zamówienie, a automatyzacja przez API pobiera jego szczegóły i zapisuje je w innym systemie.

Jak to wygląda w praktyce

To przykład ilustracyjny. Klient wypełnia formularz kontaktowy na stronie firmy. Formularz wysyła webhook do narzędzia automatyzacji, na przykład n8n albo Make. Przepływ sprawdza, czy firma klienta jest już w CRM, zakłada nową szansę sprzedaży w Pipedrive, przypisuje handlowca według regionu i wysyła mu powiadomienie. Całość trwa kilka sekund, a handlowiec dzwoni do klienta, zanim ten zdąży wysłać zapytanie do konkurencji. Cały proces opisujemy na stronie obsługa zapytań i leadów.

Na co uważać

• Bezpieczeństwo adresu. Adres webhooka powinien być trudny do odgadnięcia i najlepiej zabezpieczony podpisem albo tokenem, żeby nikt nie mógł wysłać fałszywych danych.
• Powtórzenia. Niektóre systemy wysyłają tę samą wiadomość ponownie, gdy nie dostaną potwierdzenia. Automatyzacja musi rozpoznać duplikat, żeby nie założyć dwóch takich samych rekordów.
• Brak odbiorcy. Jeśli serwer odbierający nie działa, wiadomość może przepaść. Dobre wdrożenie zapisuje błędy i pozwala ponowić obsługę.
• Zmiany po stronie dostawcy. Gdy dostawca zmieni format danych, przepływ trzeba poprawić. Monitoring pozwala wyłapać to od razu.

Jak zacząć z webhookami

Najpierw warto sprawdzić, które z używanych systemów potrafią wysyłać webhooki. Informację zwykle znajdziecie w ustawieniach integracji albo w dokumentacji dostawcy, pod hasłami „webhook”, „powiadomienia” lub „zdarzenia”. Potem wybieracie jedno zdarzenie, na którym dziś ktoś traci czas, na przykład nowe zapytanie z formularza, i budujecie dla niego pierwszy przepływ. Po kilku tygodniach widać, czy działa stabilnie, i można dokładać kolejne zdarzenia.

Kiedy warto się tym zająć

Webhooki przydają się wszędzie tam, gdzie liczy się szybka reakcja na zdarzenie: nowe zapytanie, płatność, podpisana umowa, zmiana statusu zamówienia. Jeśli dziś ktoś w firmie co kilka godzin sprawdza skrzynkę lub panel i przepisuje dane dalej, to dobry kandydat na automatyzację opartą na webhooku. Łączeniem systemów w ten sposób zajmujemy się w usłudze integracje systemów.