Webhooki
Webhooki pozwalają automatycznie powiadamiać zewnętrzne systemy o zdarzeniach w Twoim koncie — np. gdy powstanie nowe zadanie, zostanie wysłany e-mail lub zmieni się status klienta CRM.
Jak działają?
Gdy w systemie wystąpi skonfigurowane zdarzenie, system wysyła żądanie HTTP POST z danymi obiektu (w formacie JSON) na podany adres URL.
Konfiguracja webhooka
Przy tworzeniu webhooka ustawiasz:
- URL — adres endpointu, na który mają być wysyłane powiadomienia
- Typ zasobu — jaki rodzaj obiektu ma być monitorowany (np. zadanie, e-mail, klient)
- Zdarzenie — jakie akcje mają wyzwalać webhook: utworzenie (create), edycja (update), usunięcie (destroy)
- Token API — token uwierzytelniający dołączany do żądania
- Tryb JWT — opcjonalnie zamiast tokena API, webhook może używać podpisu JWT
- Status — aktywny/nieaktywny
Unikalność
Każda kombinacja URL + typ zasobu + zdarzenie musi być unikalna — nie można utworzyć dwóch identycznych webhooków.
Zastosowanie
- Integracja z zewnętrznymi CRM, ERP lub narzędziami automatyzacji
- Powiadomienia na Slacka, Discorda lub inne komunikatory
- Synchronizacja danych z innymi systemami
- Automatyzacja procesów biznesowych (np. utworzenie faktury po zamknięciu transakcji)