Co to jest webhook? Przewodnik dla nieprogramistów: jak połączyć chatbota z resztą narzędzi
Webhook to automatyczna wiadomość, którą jedna aplikacja wysyła do drugiej w chwili, gdy coś się wydarzy. Zobacz, jak działają webhooki chatbota, czym różnią się od API i jak je…

W tym artykule
Co to jest webhook? To automatyczna wiadomość, którą jedna aplikacja wysyła do drugiej w chwili, gdy coś się wydarzy, np. gdy twój chatbot pozyska nowego leada. Zamiast tego, żeby inne narzędzia co kilka minut pytały „jest coś nowego?”, chatbot od razu je o tym informuje.
To jak różnica między chodzeniem co godzinę do skrzynki pocztowej a dzwonkiem do drzwi. Dzwonek dzwoni tylko wtedy, gdy ktoś naprawdę stoi pod drzwiami.
Poniżej wyjaśniamy, jak działają webhooki chatbota, czym różnią się od API, jakie zdarzenia warto wysyłać i jak je zabezpieczyć.
Najważniejsze wnioski
- Webhook wypycha dane do innego systemu, gdy wydarzy się zdarzenie. API to zwykle coś, co sam wywołujesz, żeby pobrać dane.
- Przydatne webhooki chatbota uruchamiają się przy zdarzeniach biznesowych, takich jak nowy lead, przekazanie rozmowy człowiekowi czy zamknięcie rozmowy.
- Podpisy HMAC dowodzą, że wiadomość jest autentyczna, a ponowne próby sprawiają, że krótka awaria nie powoduje utraty danych.
Co to jest webhook? Wyjaśnienie bez technicznego żargonu
Webhook składa się z trzech elementów:
- Zdarzenie: coś dzieje się w aplikacji źródłowej, np. odwiedzający zostawia na czacie swój adres e-mail.
- Adres URL: adres systemu odbierającego, często nazywany endpointem. Wklejasz go w ustawieniach aplikacji źródłowej.
- Ładunek (payload): niewielka paczka danych, zwykle w formacie JSON, opisująca, co się wydarzyło.
Gdy zdarzenie następuje, aplikacja źródłowa wysyła ładunek na ten adres URL. System odbierający go odczytuje i robi coś przydatnego: tworzy kontakt, publikuje powiadomienie, dodaje wiersz do arkusza. Nikt nie musi naciskać przycisku ani pisać skryptu, który sprawdza zmiany.
Nie musisz też samodzielnie budować strony odbierającej. Platformy automatyzacji, takie jak Zapier, Make i n8n, wygenerują dla ciebie adres URL webhooka w kilku kliknięciach i właśnie dlatego z webhooków mogą korzystać osoby, które nie programują.
Webhook a API: czym się różnią?
Często traktuje się je jak konkurentów, ale działają w parze. API (interfejs programowania aplikacji) to zestaw drzwi do aplikacji, do których pukasz, żeby odczytać lub zmienić dane. Webhook to aplikacja, która puka do twoich drzwi, gdy coś się wydarzy.
Bez webhooków jedynym sposobem, by dowiedzieć się o nowych zdarzeniach, jest odpytywanie (polling), czyli ciągłe pytanie API, czy coś się zmieniło.
| Webhook (push) | Odpytywanie API (pull) | |
|---|---|---|
| Kto inicjuje | Aplikacja źródłowa, gdy wydarzy się zdarzenie | Twój system, według harmonogramu |
| Szybkość | Niemal w czasie rzeczywistym | Tak szybko, jak często odpytujesz |
| Najlepsze do | Powiadomień, synchronizacji nowych rekordów, uruchamiania procesów | Eksportów zbiorczych, raportów, wyszukiwania na żądanie |
| Konfiguracja | Wklej adres URL, wybierz zdarzenia | Napisz skrypt lub zaplanowane zadanie |
| Główne ryzyko | Utracone wiadomości, gdy odbiorca nie działa (rozwiązywane ponownymi próbami) | Opóźnienia, zbędne zapytania, limity zapytań |
Wiele integracji korzysta z obu. Webhook informuje, że „rozmowa 123 została właśnie przekazana konsultantowi”, a system odbierający wywołuje potem API, jeśli potrzebuje więcej szczegółów.
Webhooki chatbota: przykładowe zdarzenia, które warto wysyłać
Najlepsze webhooki chatbota odpowiadają momentom, na których twojemu zespołowi już zależy. Trzy typowe przykłady:
Pozyskano nowego leada
Odwiedzający podaje dane kontaktowe i odpowiada na jedno lub dwa pytania kwalifikujące. Typowe zastosowania: utworzenie lub aktualizacja kontaktu w CRM, powiadomienie na kanale działu sprzedaży albo dodanie leada do listy podtrzymującej kontakt (za zgodą). Ponieważ szybka odpowiedź na nowe leady wygrywa więcej transakcji, to zwykle pierwszy webhook, jaki konfigurują zespoły.
Rozmowa przekazana człowiekowi
Asystent uznał, że rozmowę powinien przejąć człowiek, albo klient o to poprosił. Typowe zastosowania: powiadomienie dyżurnego konsultanta, otwarcie zgłoszenia w help desku albo oznaczenie ważnego klienta. Ładunek powinien zawierać kontekst, na którym opiera się twój proces przekazywania rozmowy z chatbota do człowieka, np. intencję, tagi i dane kontaktowe.
Rozmowa zamknięta
Rozmowa się zakończyła, a sprawę rozwiązało AI lub konsultant. Typowe zastosowania: zapisanie jej na potrzeby raportów, aktualizacja panelu albo utworzenie zadania na później.
Prosta zasada: subskrybuj tylko te zdarzenia, na które zamierzasz reagować. Każdy włączony webhook to kolejna rzecz do monitorowania.
Bezpieczeństwo webhooków: podpisy, ponowne próby i śledzenie dostarczenia
Adres URL webhooka to po prostu adres w internecie. Co powstrzyma kogoś przed wysyłaniem na niego fałszywych wiadomości o „nowym leadzie”? I co się stanie, jeśli twój serwer nie będzie działał przez dziesięć minut? Na te pytania odpowiadają trzy zabezpieczenia.
Podpisy HMAC. Nadawca i odbiorca dzielą wspólny tajny klucz. Nadawca oblicza podpis na podstawie ładunku i klucza i dołącza go do każdego żądania. Odbiorca oblicza go ponownie i odrzuca wszystko, co się nie zgadza, więc sfałszowane lub zmienione wiadomości nie przechodzą.
Ponowne próby. Jeśli odbiorca nie potwierdzi dostarczenia, nadawca próbuje ponownie później, zwykle z coraz dłuższymi odstępami między próbami. Krótka awaria nie oznacza utraty danych.
Wyłączniki awaryjne (circuit breaker) i śledzenie dostarczenia. Jeśli endpoint ciągle zawodzi, wyłącznik awaryjny na jakiś czas wstrzymuje wysyłkę, zamiast zasypywać zepsuty serwer kolejnymi żądaniami. Logi dostarczenia pokazują, co zostało wysłane i czy dotarło, więc możesz szukać błędów bez zgadywania.
Po stronie odbierającej kilka nawyków zapobiega większości problemów:
- Zweryfikuj podpis, zanim użyjesz danych.
- Odpowiadaj szybko kodem sukcesu, a cięższą pracę wykonuj w tle.
- Licz się z duplikatami: ponowna próba może dostarczyć to samo zdarzenie dwukrotnie, więc używaj identyfikatora zdarzenia, żeby pomijać powtórzenia.
- Używaj wyłącznie endpointów HTTPS.
- Przekazuj tylko te dane osobowe, których potrzebuje narzędzie odbierające. Zasady RODO dla chatbotów AI nadal obowiązują, gdy dane opuszczą czat.
Jak Conviro obsługuje webhooki w czasie rzeczywistym
Conviro udostępnia webhooki w czasie rzeczywistym. Zdarzenia trafiają do twojego endpointu w chwili, gdy następują, są podpisane HMAC, więc możesz zweryfikować każde żądanie, w razie nieudanego dostarczenia są automatycznie ponawiane i chronione wyłącznikiem awaryjnym. Śledzenie dostarczenia pokazuje, co zostało wysłane i czy dotarło.
Możesz kierować webhooki do własnego kodu lub do narzędzia no-code: Conviro łączy się też z Zapier, Make i n8n oraz oferuje REST API z uwierzytelnianiem tokenem typu bearer i kluczami o ograniczonym zakresie uprawnień do pobierania danych na żądanie. Wszystko to jest dostępne w planie Pro i wyższych. Dokumentacja dla deweloperów opisuje ładunki i weryfikację podpisów, a strona integracji z narzędziami automatyzacji pokazuje ścieżki no-code.
Najczęściej zadawane pytania
Co to jest webhook w prostych słowach?
Webhook to automatyczne powiadomienie, które jedna aplikacja wysyła do drugiej, gdy wydarzy się określone zdarzenie. Podajesz aplikacji źródłowej adres URL, wybierasz zdarzenia, a ona za każdym razem wysyła na ten adres niewielką paczkę danych. Działa jak dzwonek do drzwi dla oprogramowania: system odbierający od razu dowiaduje się o zmianach, zamiast ciągle je sprawdzać.
Czy do korzystania z webhooków potrzebuję programisty?
Nie zawsze. Platformy automatyzacji, takie jak Zapier, Make i n8n, generują dla ciebie adres URL webhooka i pozwalają w edytorze wizualnym przypisać przychodzące dane do akcji. Programista przydaje się, gdy budujesz własny endpoint, weryfikujesz podpisy w kodzie albo łączysz wewnętrzny system, dla którego nie ma gotowego konektora.
Czy webhook jest szybszy niż API?
Jeśli chodzi o informowanie o nowych zdarzeniach, tak. Webhook dociera chwilę po zdarzeniu, a odpytywanie API jest tylko tak szybkie, jak często sprawdzasz. Do danych historycznych lub dodatkowych szczegółów właściwym narzędziem jest API. Większość dobrze zbudowanych integracji używa webhooków do powiadamiania, a API do wyszukiwania informacji.
Co się stanie, jeśli mój endpoint webhooka nie działa?
To zależy od nadawcy. Dobre systemy webhooków ponawiają nieudane dostarczenia przez pewien czas, więc krótkie awarie nie powodują utraty danych, a niektóre wstrzymują wysyłkę do endpointu, który ciągle zawodzi. Sprawdź, czy twój dostawca ponawia próby, i upewnij się, że twój endpoint bezpiecznie poradzi sobie z tym samym zdarzeniem dostarczonym dwukrotnie.
Kolejne kroki
Wybierz jedno zdarzenie, na które zareagowałbyś już dziś, zwykle nowe leady, i połącz je z narzędziem, w którym twój zespół już pracuje. Gdy będzie działać niezawodnie, dodaj przekazania rozmów i zamknięte rozmowy. Zacznij za darmo z Conviro, skonfiguruj asystenta, a gdy zechcesz podłączyć webhooki, przejdź na plan Pro.
Opublikowane przez
Conviro
Dzieli się wiedzą o obsłudze klienta opartej na AI, automatyzacji chatbotów i strategiach wzrostu SaaS.
Buduj na bazie Conviro
Połącz przepływy konwersacyjne ze swoim stosem technologicznym
Przejrzyj zasoby dla deweloperów i wzorce integracji, zanim zaprojektujesz wdrożenie.
Powiązane artykuły
Więcej wpisów


Engineering
7 sposobów na wykorzystanie API chatbota: jak budować na rozmowach z klientami
7 min czytania
Czytaj artykuł