[Intum Pomoc](https://intum.pl/pomoc.md) / [Toolkit](https://intum.pl/pomoc/toolkit.md)

# [Webhooki](https://intum.pl/pomoc/toolkit/toolkit-webhooki.md)

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.

> [!PATH]
> [Toolkit → Webhooki](app:/account/webhooks)

## Co uruchamia webhook {#zdarzenie}

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" {#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](app:/connect/help) - 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.

> [!WARNING]
> 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](app:/automation/help/automatyzacje/index)) 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](app:/automation/rules), a webhook powstanie
> sam.

## Włączanie i wyłączanie {#wlaczanie}

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ł {#dostarczanie}

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.

> [!NOTE]
> [Requesty](app:/account/help/api_i_webhooki/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-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](app:/automation/help/automatyzacje/index) z akcją
**Wyślij webhook (POST na URL)** - warunki odsieją resztę, a każde wysłanie trafi do jej logu
wykonań.

## Kto widzi webhooki {#uprawnienia}

Pozycja **Webhooki** w menu Toolkit pokazuje się osobom z uprawnieniem **Webhooki** w roli
(grupa Connect w edycji [ról użytkowników](app:/account/roles)). 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 {#gdy-cos-nie-dziala}

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](app:/automation/rules), webhook powstanie
   sam - patrz [ostrzeżenie o polu Cel](#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.