Przejdź do treści
Intum Pomoc
Aktualizacja: 4 min czytania
Na tej stronie

Webhook to odwrotność tokenu API: zamiast pytać Intum, to Intum sam informuje inny system, że coś się wydarzyło - np. że powstał nowy klient albo zmieniło się zadanie.

W aplikacji

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 wpisany w polu URL. Pole Token API (w „Więcej opcji”) jest opcjonalne - gdy jest wypełnione, dorzucamy go do zapytania, żeby odbiorca mógł sprawdzić, że wiadomość faktycznie jest od Ciebie,
  • Konektor - zamiast adresu URL wybiera się jeden z konektorów skonfigurowanych w module Connect - wygodne, gdy jest 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ą (Automatyzacje) 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 trzeba 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” - gdy potrzebny jest dowód dostarczenia, trzeba sprawdzić logi po stronie odbiorcy albo dodać 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 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”), lepsza jest automatyzacja 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 Toolkit pokazuje się osobom z uprawnieniem Webhooki w roli (grupa Connect w edycji ról użytkowników). Bez tego uprawnienia pozycji w menu nie ma, ale akcja Wyślij webhook (POST na URL) w automatyzacji go nie wymaga - wystarczy uprawnienie Automatyzacja.

Gdy webhook nie dociera

Zdarzenie w Intum się wydarzyło (np. powstał klient), a zewnętrzny system, który miał dostać powiadomienie, nic nie pokazuje. Sprawdź po kolei:

  1. Webhook jest aktywny. Wyłączony checkboxem Aktywny webhook nie wysyła niczego.
  2. Źródło i akcja pasują do tego, co się wydarzyło. Webhook z akcją „powstanie” nie odpali się na zmianę rekordu, a webhook podpięty pod klienta nie zareaguje na zadanie.
  3. Pole „Cel” to Reguła, choć nie powinno. Webhook z celem Reguła nie da się zapisać ręcznie z działającym celem - taki wpis zawsze kończy się błędem przy zapisie. Automatyzację zakładaj na liście Automatyzacje, webhook powstanie sam - patrz ostrzeżenie o polu Cel.
  4. Adres URL jest poprawny i publicznie dostępny. Literówka w adresie albo serwer dostępny tylko z wewnętrznej sieci sprawi, że Intum nie dobije do niego z zewnątrz.
  5. Odbiorca faktycznie odrzuca albo ignoruje zapytanie. Sprawdź logi po stronie systemu, który ma odbierać webhooka - czasem to on odrzuca zapytanie (np. przez zły format danych), a nie brak wysyłki.

Nieudane wysyłki system próbuje ponowić automatycznie kilka razy w rosnących odstępach, więc chwilowa awaria po stronie odbiorcy zwykle naprawia się sama. Jeśli po kilkunastu minutach nadal nic nie dotarło, warto zgłosić się do wsparcia technicznego Intum z nazwą webhooka i adresem URL.

Czy ten wpis był pomocny?

Komentarze