Czym jest webhook?
Webhook to adres URL, który podajesz innemu systemowi, żeby w chwili, gdy coś się w nim wydarzy, wywołał Twój system i przesłał szczegóły w żądaniu. Nie musisz ciągle dopytywać, bo informacja sama do Ciebie przychodzi. Dlatego każda automatyzacja, która ma reagować w ciągu sekund, opiera się na webhooku.
Werdykt w skrócie
Jeśli dostawca mówi, że synchronizacja działa „co 15 minut”, to znaczy, że odpytuje. Przy formularzu z leadem to piętnastominutowa przewaga podarowana temu, kto odbierze pierwszy. Zanim zapytasz o cokolwiek innego, zapytaj o webhooki.
| Webhook | Odpytywanie (polling) | |
|---|---|---|
| Kto inicjuje połączenie | System, w którym zaszło zdarzenie | Twój, według harmonogramu |
| Typowe opóźnienie | Poniżej sekundy | Średnio połowa odstępu między odpytaniami |
| Koszt, gdy nic się nie dzieje | Zero | Każde puste sprawdzenie i tak kosztuje |
| Wymaga publicznego URL-a | Tak | Nie |
| Gdy Twój system nie działa | Zdarzenie przepada, chyba że nadawca ponowi wysyłkę, a nie każdy to robi | Nadrabia przy kolejnym odpytaniu |
| Dobre do | Szybkiej reakcji na zdarzenia | Synchronizacji masowej, systemów bez webhooków |
Co byśmy wybrali, scenariusz po scenariuszu
Formularz na stronie
Formularz wysyła dane na webhook, automatyzacja uzupełnia informacje i kieruje leada dalej, a pierwszy kontakt wychodzi, zanim człowiek zamknie kartę przeglądarki. Na tym polega cały mechanizm skracania czasu reakcji do sekund.
Zaksięgowana płatność
Operator płatności wywołuje Twój webhook i faktura, etap w CRM-ie oraz dokument wydania aktualizują się jednocześnie. Przy odpytywaniu księgowość jest poprawna średnio, a błędna w dowolnym momencie.
Przychodząca wiadomość WhatsApp
Meta dostarcza każdą wiadomość na zarejestrowany przez Ciebie webhook. Innej drogi nie ma, dlatego każde wdrożenie WhatsAppa zaczyna się od publicznego endpointu HTTPS i tokenu weryfikacyjnego.
Kiedy odpytywanie ma sens
Drugi system nie oferuje webhooków albo potrzebujesz nocnego uzgodnienia, które wyłapie to, co przepadło. Zwykle robimy jedno i drugie: webhooki dla szybkości, a zaplanowany przegląd dla kompletności.
Webhooki to najmniej efektowna część automatyzacji, a często to od nich zależy, czy projekt osiągnie zakładany wynik, bo cała wartość zwykle tkwi w czasie reakcji. Lead, do którego oddzwonisz po trzydziestu sekundach, i ten sam lead po czterdziestu minutach to dwa różne leady, a o tej różnicy często decyduje to, czy system dostaje zdarzenie od razu, czy sam co pięć minut sprawdza, czy coś się wydarzyło.
Dwie praktyczne uwagi z produkcji. Po pierwsze, traktuj endpoint jako publiczny i wrogi: weryfikuj podpis dołączany przez nadawcę i odrzucaj wszystko bez podpisu, bo adres webhooka to drzwi do Twojej automatyzacji. Po drugie, załóż, że nadawca w końcu się podda. Część dostawców ponawia wysyłkę przez jakiś czas, a potem porzuca zdarzenie, inni nie ponawiają wcale. Dlatego wszystko, co nie może zginąć, obejmujemy nocnym przeglądem, który porównuje obie strony i uzupełnia braki. Dokładnie tego połączenia użyliśmy w projekcie, w którym skróciliśmy pierwszy kontakt z 4,5 godziny do 30 sekund, i stosujemy je w każdej automatyzacji procesów, którą wdrażamy.
Źródła
Częste pytania
Czym jest webhook w prostych słowach?
To jak numer telefonu, który dajesz innemu systemowi, żeby zadzwonił, gdy coś się wydarzy, zamiast żebyś Ty dzwonił do niego co kilka minut z pytaniem. W tej rozmowie od razu przekazuje szczegóły zdarzenia.
Czym różni się webhook od API?
Kierunkiem. Przy API to Ty wywołujesz drugi system, kiedy czegoś potrzebujesz. Przy webhooku to drugi system wywołuje Ciebie, kiedy ma coś nowego. Większość integracji korzysta z obu: webhook informuje o zdarzeniu, a wywołania API pozwalają na nie zareagować.
Czy webhooki są bezpieczne?
Na tyle, na ile je zabezpieczysz. Endpoint jest publiczny, więc potrzebuje HTTPS, weryfikacji podpisu wspólnym sekretem i odrzucania wszystkiego, co tej weryfikacji nie przejdzie. Niezweryfikowany endpoint to otwarte drzwi, więc bez tego zabezpieczenia nie oddajemy wdrożenia.
Co się stanie, jeśli mój system nie działa, gdy przyjdzie webhook?
Część nadawców ponawia wysyłkę przez jakiś czas, a potem rezygnuje, a niektórzy, jak GitHub, w ogóle nie ponawiają automatycznie, więc zdarzenie może przepaść na dobre. Przy wszystkim, co ma znaczenie, dodajemy zaplanowane uzgodnienie, które porównuje oba systemy i uzupełnia to, czego nie dostarczyły ponowienia.
Czy bot na WhatsAppie potrzebuje webhooka?
Tak. Meta dostarcza przychodzące wiadomości WhatsApp, wywołując zarejestrowany i zweryfikowany przez Ciebie adres URL. Odpytywanie nie wchodzi w grę, więc w każdym projekcie z WhatsAppem najpierw konfigurujemy publiczny endpoint HTTPS.
Który proces kosztuje Cię najwięcej?
Trzydzieści minut, bezpłatnie. Wychodzisz z konkretnym planem naprawy i kwotą, jaką ten proces kosztuje. Plan zostaje u Ciebie, nawet jeśli wdrożysz go bez nas.
Zamów bezpłatny audyt