[Intum Pomoc](https://intum.pl/pomoc.md) / [Zastosowania](https://intum.pl/pomoc/konto/zastosowania.md)

# [Podłączenie własnego systemu przez API i webhook](https://intum.pl/pomoc/konto/konto-wlasny-system-przez-api.md)

Masz sklep, system ERP albo własną aplikację i chcesz, żeby dwukierunkowo wymieniała dane z
Intum - Twój system ma dopisywać klientów do Intum, a Intum ma informować Twój system, gdy coś
się zmieni po stronie Intum.

> [!PATH]
> [Konto → Integracje i dodatki](app:/account/apps)

## Plan

1. **Wygeneruj token API dla integracji** - osobny od tokenów osobistych użytkowników, żeby
   dało się go unieważnić bez wpływu na nikogo innego. Zawęź mu uprawnienia do tego, co
   integracja faktycznie ma robić (np. tylko odczyt i zapis klientów). Patrz [Tokeny
   API](konto/konto-tokeny-api#tworzenie).
2. **Skonfiguruj swój system, żeby wysyłał zapytania do Intum tym tokenem** - to kierunek
   „mój system → Intum": zakładanie, aktualizacja albo odczyt rekordów przez API.
3. **Załóż webhook na kierunek odwrotny** - „Intum → mój system": wybierz źródło (np. Klient) i
   akcję (np. powstanie), a w polu **Cel** wpisz **Zewnętrzny URL** prowadzący do punktu
   odbiorczego w Twoim systemie. Patrz [Webhooki](app:/automation/help/webhooki/webhooki#cel).
4. **Zabezpiecz odbiór webhooka po swojej stronie** - wypełnij pole **Token API** przy
   webhooku i sprawdzaj go po stronie swojego systemu, żeby odrzucać zapytania, które nie
   pochodzą od Intum.
5. **Przetestuj oba kierunki osobno** - najpierw jedno zapytanie API z Twojego systemu, potem
   jedna zmiana w Intum, która ma odpalić webhook. Łatwiej znaleźć problem, gdy sprawdzasz
   jeden kierunek na raz.

## Po czym poznać, że działa

- Zapytanie wysłane z Twojego systemu do Intum kończy się oczekiwaną odpowiedzią, a rekord
  faktycznie pojawia się/zmienia się w Intum.
- Zmiana zrobiona w Intum (np. nowy klient) w krótkim czasie pojawia się w Twoim systemie -
  jeśli nie, sprawdź [problemy z webhookami](app:/automation/help/szybka_pomoc/webhook_nie_dociera) i
  [problemy z dostępem API](konto/konto-problemy-api-dostep-odrzucony).
- Token użyty w integracji ma zawężone uprawnienia - widać to po liście uprawnień na jego
  karcie, a nie po pustym polu sugerującym pełny dostęp.