Webhooki Thulium to mechanizm powiadamiania zewnętrznych systemów o zdarzeniach zachodzących na platformie contact center: nowym połączeniu przychodzącym, odebraniu rozmowy, zakończeniu połączenia, zmianie statusu agenta, nowej wiadomości czatowej i wielu innych. W przeciwieństwie do pollingu API (regularnego odpytywania „czy coś się zmieniło?"), webhooki działają w modelu push — Thulium sam wysyła żądanie HTTP do skonfigurowanego adresu URL w momencie zdarzenia, co eliminuje opóźnienia i oszczędza zasoby. Prawidłowa obsługa webhooków jest fundamentem reaktywnych integracji Thulium z CRM, ERP i innymi systemami.
Serwis Wiatraczna konfiguruje webhooki Thulium i pomaga implementować endpointy odbierające zdarzenia w zewnętrznych systemach. Jeżeli Twoje webhooki nie działają, zdarzenia giną lub integracja nie reaguje na połączenia — skontaktuj się z naszym zespołem technicznym.
Webhooki Thulium — reaktywne integracje oparte na zdarzeniach
Wyobraź sobie, że zamiast sprawdzać co minutę, czy przyszła nowa wiadomość (polling), dostajesz powiadomienie natychmiast gdy ona pojawia się — to właśnie webhooki. Dla integracji Thulium z zewnętrznymi systemami webhooki są zazwyczaj wydajniejszym i prostszym rozwiązaniem niż ciągłe odpytywanie API.
Typy zdarzeń obsługiwanych przez webhooki Thulium
Thulium obsługuje webhooki dla szerokiego zakresu zdarzeń: `call.started` (nowe połączenie przychodzące — idealny moment na screen pop), `call.answered` (agent odebrał połączenie), `call.ended` (zakończenie rozmowy z danymi podsumowania: czas, agent, kolejka), `call.missed` (nieodebrane połączenie — trigger do callbacku), `agent.status_changed` (zmiana statusu agenta), `chat.new_message` (nowa wiadomość czatowa), `campaign.contact_updated` (aktualizacja rekordu w kampanii outbound). Pełna lista zdarzeń jest dostępna w dokumentacji API Thulium i może się różnić między wersjami platformy.
Konfiguracja endpointu webhookowego
W panelu Thulium administrator definiuje endpoint webhookowy: URL adresu, pod który platforma wyśle żądanie HTTP POST z danymi zdarzenia, tajny klucz (webhook secret) używany do weryfikacji autentyczności żądania i listę zdarzeń, które mają być wysyłane do tego endpointu. URL musi być publicznie dostępny (nie localhost), działać przez HTTPS z ważnym certyfikatem SSL i odpowiadać w ciągu kilku sekund kodem 200 OK — w przeciwnym razie Thulium uzna próbę za nieudaną i może powtórzyć żądanie.
Struktura payload webhookowego
Każde żądanie webhookowe Thulium zawiera w body JSON dane zdarzenia: typ zdarzenia (`event_type`), znacznik czasu (`timestamp`), identyfikator zdarzenia (`event_id`) i dane właściwe dla danego zdarzenia (np. dla `call.ended`: numer dzwoniącego, identyfikator agenta, czas trwania, URL nagrania, kod zakończenia). Nagłówek `X-Thulium-Signature` zawiera HMAC-SHA256 hash body żądania podpisany webhook secretem — endpoint powinien weryfikować ten podpis przed przetwarzaniem zdarzenia, co chroni przed fałszywymi żądaniami.
Implementacja endpointu webhookowego
Endpoint przyjmujący webhooki Thulium powinien: odpowiadać kodem 200 OK natychmiast po otrzymaniu żądania (nawet przed przetworzeniem), weryfikować podpis HMAC, kolejkować zdarzenie do asynchronicznego przetworzenia (aby nie przekroczyć timeoutu odpowiedzi) i być idempotentny — to samo zdarzenie może być wysłane wielokrotnie przy błędach sieci, więc przetworzenie dwa razy nie powinno powodować problemów. Takie podejście zapewnia niezawodność integracji nawet przy chwilowych problemach z siecią.
Monitorowanie i debugowanie webhooków
Thulium zazwyczaj prowadzi log wysłanych webhooków z możliwością podglądu: kiedy został wysłany, z jakim payloadem i jaką odpowiedź otrzymał od endpointu. To kluczowe narzędzie diagnostyczne przy problemach z integracją: można sprawdzić, czy Thulium w ogóle próbował wysłać zdarzenie i jaki był kod odpowiedzi endpointu. Warto też prowadzić logi po stronie endpointu, żeby mieć podwójną możliwość diagnozowania problemów.
Konfiguracja webhooków Thulium — Serwis Wiatraczna
Serwis Wiatraczna skonfiguruje webhooki Thulium i pomoże zaimplementować endpoint odbierający zdarzenia w Twoim systemie. Skontaktuj się z nami — reaktywne integracje oparte na webhookach Thulium działające niezawodnie.
