[Intum Pomoc](https://intum.pl/pomoc.md) / [Webhooki](https://intum.pl/pomoc/automatyzacja/webhooki.md)

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

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.

> [!PATH]
> [Automatyzacja → 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, 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](app:/connect/help) - 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.

> [!WARNING]
> W liście „Cel" jest też opcja **Reguła** - nie wybieraj jej ręcznie. Takie webhooki
> tworzy sam system razem z [automatyzacjami](automatyzacja/automatyzacja-automatyzacje) 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](app:/automation/rules), a webhook powstanie sam.

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

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ł {#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" -
jeśli potrzebujesz dowodu dostarczenia, sprawdź logi po stronie odbiorcy albo dodaj 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 Twoich
> 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"), załóż
[automatyzację](automatyzacja/automatyzacja-automatyzacje) 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 Automatyzacji pokazuje się osobom z uprawnieniem **Webhooki**
w roli (grupa Connect) - więcej w [uprawnieniach modułu](automatyzacja/automatyzacja-uprawnienia#webhooki).

## Gdy webhook nie dociera {#gdy-cos-nie-dziala}

Zobacz [problemy z webhookami](automatyzacja/automatyzacja-webhook-nie-dociera).