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.
W aplikacji
Gdzie to znajdziesz
Plan
- 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.
- 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.
- 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.
- 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.
- 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 i problemy z dostępem API.
- 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.