[Intum](https://intum.fr/aide.md) / [Konto](https://intum.fr/aide/konto.md)

# [Webhooki](https://intum.fr/aide/konto/webhooki.md) | [API](#api)

## 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)

---

## API

### Ogólne API

# Intum API

Dokumentacja API platformy [Intum](https://intum.pl) - system operacyjny firmy.

## Host

Host jest zawsze taki sam jak adres konta: `xxxx.intum.com` lub `xxx.intum.pl` (w zależności od ustawień konta)

## Autoryzacja

Wszystkie requesty API wymagają `api_token`:
- header: `Authorization: Bearer TOKEN`

Token możesz wygenerować w **Ustawienia Konta** → **Tokeny API**

## API — Webhooki

### Lista webhooków

```
GET /account/webhooks.json
```

### Pobranie webhooka

```
GET /account/webhooks/:id.json
```

### Tworzenie webhooka

```
POST /account/webhooks.json
```

**Parametry:**

- `webhook[url]` — adres URL endpointu
- `webhook[kind]` — zdarzenie: `create`, `update`, `destroy`
- `webhook[source_type]` — typ zasobu (nazwa modelu)
- `webhook[api_token]` — token uwierzytelniający (szyfrowany)
- `webhook[active]` — boolean

Kombinacja `url` + `source_type` + `kind` musi być unikalna.

### Aktualizacja webhooka

```
PATCH /account/webhooks/:id.json
```

### Usunięcie webhooka

```
DELETE /account/webhooks/:id.json
```

### Format payloadu

Webhook wysyła `POST` z JSON body zawierającym dane zmienionego obiektu. Nagłówek `Authorization: Bearer TOKEN` (lub JWT jeśli skonfigurowany).