Webhook to odwrotność tokenu API: zamiast Ty pytasz Intum, to Intum sam informuje inny system, że coś się wydarzyło - np. że powstał nowy klient albo zmieniło się zadanie.
Gdzie to znajdziesz
Co uruchamia webhook
Każdy webhook reaguje na jedną parę: Źródło (jaki rodzaj rekordu, np. klient, zadanie,
zgłoszenie) i Akcja (co się z nim stało - lista dostępnych akcji zmienia się razem ze
źródłem i bywa techniczna: create = powstanie, update = zmiana, destroy = usunięcie,
czasem dochodzą dodatkowe akcje właściwe dla danego modułu).
Dokąd trafia zdarzenie - pole „Cel”
- Zewnętrzny URL - najczęstszy wybór. Intum wysyła zapytanie POST z danymi zdarzenia pod adres, który wpiszesz w polu URL. Pole Token API (w „Więcej opcji”) jest opcjonalne - jeśli je wypełnisz, dorzucamy go do zapytania, żeby odbiorca mógł sprawdzić, że wiadomość faktycznie jest od Ciebie,
- Konektor - zamiast adresu URL wybierasz jeden z konektorów skonfigurowanych w module Connect - wygodne, gdy masz już gotowe połączenie z daną usługą, np. z Fakturownią,
- Flow - uruchamia zdefiniowany w Connect przepływ (flow) zamiast wysyłać zwykłe zapytanie - przydatne, gdy zdarzenie ma od razu przejść przez kilka kroków przetwarzania.
Uwaga
W liście „Cel” jest też opcja Reguła - nie wybieraj jej ręcznie. Takie webhooki tworzy sam system razem z automatyzacjami na akcję natychmiastową i formularz nie ma pola do wpisania potrzebnego tu kodu, więc ręcznie zapisany webhook tego typu zawsze zwróci błąd. Automatyzację twórz na liście Automatyzacje, a webhook powstanie sam.
Włączanie i wyłączanie
Checkbox Aktywny wyłącza webhook bez usuwania go - przydatne, gdy chcesz chwilowo wstrzymać wysyłkę, np. na czas prac po stronie odbiorcy.
Skąd wiadomo, że dotarł
Wysyłka pod zewnętrzny URL dzieje się w tle - jeśli odbiorca odpowie błędem albo w ogóle nie odpowie, system próbuje ponownie automatycznie. Nie ma osobnej listy „co się wysłało” - jeśli potrzebujesz dowodu dostarczenia, sprawdź logi po stronie odbiorcy albo dodaj tam własne potwierdzenie.
Informacja
Requesty to log ruchu przychodzącego do Intum (np. odpowiedzi innych systemów wysyłane do Ciebie) - nie zawierają wysyłek Twoich webhooków.
Webhook czy automatyzacja
Webhook wysyła każde zdarzenie danego rodzaju, bez wyjątków. Gdy powiadomienie ma iść tylko przy spełnionym warunku (np. klient z tagiem VIP, status zmieniony na „wygrany”), załóż automatyzację z akcją Wyślij webhook (POST na URL) - warunki odsieją resztę, a każde wysłanie trafi do jej logu wykonań.
Kto widzi webhooki
Pozycja Webhooki w menu Automatyzacji pokazuje się osobom z uprawnieniem Webhooki w roli (grupa Connect) - więcej w uprawnieniach modułu.
Gdy webhook nie dociera
Zobacz problemy z webhookami.