[Intum Pomoc](https://intum.pl/pomoc.md) # InConnector InConnector to miejsce, w którym system rozmawia z usługami z zewnątrz: sklepem, programem księgowym, bankiem, bramką SMS, własnym urządzeniem w hali. Każde takie połączenie opisuje jeden **konektor** - trzyma adres usługi, dane do logowania i listę wywołań, których system może na niej użyć. Konektory łączą się we **flow** (przepływy), flow zostawia po sobie **procesy** z historią przebiegu, a odebrane i wysyłane dane trzymają **obiekty danych**. Osobną częścią modułu są **Connect Apps** - gotowe widżety i mini-aplikacje instalowane na koncie. > [!PATH] > [InConnector](app:/connect) > [!NOTE] > Integracje gotowe do kliknięcia dla zwykłego użytkownika (Fakturownia, Meta, SMSAPI, Google > Calendar, GitHub...) włącza się w Koncie, w [Integracjach i > dodatkach](app:/account/apps) - to inny ekran niż opisany tu moduł Connect. Tu jest miejsce dla > osoby, która sama buduje albo dopina integrację: zna pojęcia API, webhook, JSON. ## [Własny konektor](inconnector/connect-wlasny-konektor) Połączenie z usługą, której nie ma na liście gotowych rodzajów: adres, wywołania opisane w polu Metody i sprawdzenie, czy odpowiada. ## [Klucze API i hasła w konektorze](inconnector/connect-klucze-i-hasla) Gdzie wpisać klucz API, żeby nie stał otwartym tekstem w konfiguracji konektora, i jak się do niego odwołać w wywołaniu. ## [Gotowe konektory](inconnector/connect-gotowe-konektory) Rodzaje konektorów pisanych przez nas (Fakturownia, banki, KSeF, e-commerce, AI...) i czym różnią się od konektora własnego. ## [Uruchamianie i sprawdzanie konektora](inconnector/connect-uruchamianie-i-testowanie) Sprawdzenie połączenia, ręczne uruchomienie pojedynczej metody i podgląd żądań, które przyszły do konektora. ## [Zabezpieczenia i uprawnienia](inconnector/connect-bezpieczenstwo-i-uprawnienia) Hasło chroniące konektor przed zmianą, konektor współdzielony między kontami, limit równoległych wywołań (semafor) i to, kto w ogóle widzi moduł Connect. ## [Dokumentacja integracji](inconnector/connect-dokumentacja-integracji) Wbudowana lista opisanych integracji, dostępna w samej aplikacji. ## [Flow](inconnector/connect-flow) Przepływ, który łączy konektory, warunek uruchomienia i to, co dzieje się z danymi po drodze. ## [Procesy i dane](inconnector/connect-procesy-flow) Historia uruchomień flow - statusy, etapy, dane po drodze - i obiekty danych, w których trzymamy to, co przyszło z zewnątrz albo wychodzi na zewnątrz. ## [Connect Apps](inconnector/connect-apps) Widżety i mini-aplikacje instalowane na koncie z gotowych przepisów. ## [Zastosowania](inconnector/connect-zastosowania) Przykłady krok po kroku: zamówienia ze sklepu jako faktury i klienci, własny system podłączony przez webhook. ## [Dobre praktyki](inconnector/connect-dobre-praktyki) Nazewnictwo, sprzątanie nieużywanych konektorów i bezpieczne testowanie na koncie produkcyjnym. ## [Szybka pomoc](inconnector/connect-szybka-pomoc) Proces utknął, faktura powstała dwa razy, webhook nie dochodzi, stary proces nie ma pełnych danych - objawy i kolejność sprawdzania przyczyn. - [Dokumentacja integracji dla agenta AI](https://intum.pl/pomoc/inconnector/connect-dokumentacja-integracji.md) — Obok tego przewodnika Connect ma drugi zestaw dokumentów - w czystym Markdown, pisany nie dla człowieka klikającego w ekrany, tylko do wklejenia agent... - [Zabezpieczenia i uprawnienia](https://intum.pl/pomoc/inconnector/connect-bezpieczenstwo-i-uprawnienia.md) — Konektor, który pilnuje ważnej integracji (płatności, sterowanie urządzeniem, wystawianie faktur), warto chronić przed przypadkową albo niepowołaną zm... - [Uruchamianie i sprawdzanie konektora](https://intum.pl/pomoc/inconnector/connect-uruchamianie-i-testowanie.md) — Zanim konektor zacznie pracować sam, w tle albo z flow, warto sprawdzić ręcznie, że odpowiada - i mieć jak sprawdzić później, co właściwie do niego pr... - [Gotowe konektory](https://intum.pl/pomoc/inconnector/connect-gotowe-konektory.md) — Obok własnego konektora, który opisujesz sam, system ma gotowe rodzaje napisane przez nas dla konkretnych usług - wystarczy wybrać rodzaj i wpisać dan... - [Klucze API i hasła w konektorze](https://intum.pl/pomoc/inconnector/connect-klucze-i-hasla.md) — Prawie każda usługa z zewnątrz wpuszcza system dopiero po okazaniu klucza API, tokenu albo hasła. Wpisany wprost w pole Metody (JSON) taki klucz zosta... - [Własny konektor](https://intum.pl/pomoc/inconnector/connect-wlasny-konektor.md) — Większość popularnych usług ma w systemie gotowy rodzaj konektora - wybierasz go z listy, wpisujesz dane do logowania i tyle. Własny konektor jest dla... ## [Flow](https://intum.pl/pomoc/inconnector/flow.md) - [Uruchamianie i powiązania](https://intum.pl/pomoc/inconnector/connect-flow-uruchamianie-i-powiazania.md) — Flow rzadko uruchamia się samo z ekranu - najczęściej wystartuje je coś innego: konektor w trakcie działania, harmonogram, aplikacja Noe albo zdarzeni... - [Pierwszy flow](https://intum.pl/pomoc/inconnector/connect-flow-pierwszy-flow.md) — Flow prawie zawsze zakłada się z gotowego szablonu - wybierasz Rodzaj, a cała logika przetwarzania (co z czego wyciągnąć, gdzie wysłać) jest już w sys... - [Flow](https://intum.pl/pomoc/inconnector/connect-flow.md) — Konektor wie, jak zapytać usługę - flow decyduje, kiedy to zrobić i co dalej z odpowiedzią. Flow to zapisany przepis przetwarzania: dane wejściowe (na... ## [Procesy i dane](https://intum.pl/pomoc/inconnector/procesy-i-dane.md) - [Obiekty danych](https://intum.pl/pomoc/inconnector/connect-procesy-flow-obiekty-danych.md) — Obiekt danych (Data Object) to zapisany kawałek danych, na którym pracuje albo pracował proces - zamówienie ze sklepu, faktura, wiadomość, dowolna pac... - [Karta procesu](https://intum.pl/pomoc/inconnector/connect-procesy-flow-karta-procesu.md) — Proces (Flow Process) to jedno uruchomienie flow - od danych wejściowych, przez kolejne kroki, do wyniku albo błędu. Lista procesów jest zwykle długa ... - [Procesy i dane](https://intum.pl/pomoc/inconnector/connect-procesy-flow.md) — Każde uruchomienie flow zostawia ślad: proces, który pokazuje, co się stało krok po kroku, i zwykle też obiekt danych - dane, na których proces pracow... ## [Connect Apps](https://intum.pl/pomoc/inconnector/connect-apps.md) - [Connect Apps](https://intum.pl/pomoc/inconnector/connect-apps.md) — Konektor rozmawia z usługą, flow przetwarza dane - Connect App to trzeci element: gotowy widget z własnym interfejsem (na przykład panel płatności osa... ## [Zastosowania](https://intum.pl/pomoc/inconnector/zastosowania.md) - [Webhook niezależny od domeny konta (Globalny kod dostępu)](https://intum.pl/pomoc/inconnector/connect-zastosowania-wlasny-system-przez-webhook.md) — Zwykły adres wywołania konektora (opisany w Uruchamianie i sprawdzanie konektora) leży pod domeną twojego konta. Część usług zewnętrznych (bramki płat... - [Zamówienia ze sklepu jako faktury i klienci](https://intum.pl/pomoc/inconnector/connect-zastosowania-sklep-do-faktury.md) — Najczęstszy scenariusz w Connect: sklep internetowy (WooCommerce, Shoper, Shopify, Shoptet, Allegro) zgłasza nowe zamówienie, a system sam zakłada z n... - [Zastosowania](https://intum.pl/pomoc/inconnector/connect-zastosowania.md) — Poprzednie artykuły opisują poszczególne ekrany - konektor, flow, proces, obiekt danych. Tu widać, jak te elementy łączą się w praktyce, na dwóch typo... ## [Dobre praktyki](https://intum.pl/pomoc/inconnector/dobre-praktyki.md) - [Dobre praktyki](https://intum.pl/pomoc/inconnector/connect-dobre-praktyki.md) — Kilka zasad, które oszczędzają czas przy pracy z Connect na dłuższą metę - zwłaszcza gdy z kontem pracuje więcej niż jedna osoba. Ustal kod, zanim co... ## [Szybka pomoc](https://intum.pl/pomoc/inconnector/szybka-pomoc.md) - [Limit równoległości (semafor) zajęty](https://intum.pl/pomoc/inconnector/connect-problemy-limit-rownoleglosci-semafor.md) — Wywołanie konektora kończy się błędem o treści zawierającej “zajęty semafor”, albo proces flow staje z takim błędem w polu debug. Co to jest semafor ... - [Konektor zablokowany hasłem](https://intum.pl/pomoc/inconnector/connect-problemy-konektor-zablokowany-haslem.md) — Edycja albo usunięcie konektora domaga się hasła, którego nikt w zespole nie zna - albo hasła po prostu nikt nie pamięta. Ustal, kto ustawił hasło H... - [Błąd autoryzacji albo sekretu w konektorze](https://intum.pl/pomoc/inconnector/connect-problemy-blad-autoryzacji-lub-sekretu.md) — Wywołanie kończy się odmową dostępu, błędem 401/403 albo komunikatem o braku wartości sekretu - zanim usługa w ogóle zdążyła cokolwiek zrobić. Komuni... - [Webhook nie dochodzi](https://intum.pl/pomoc/inconnector/connect-problemy-webhook-nie-dochodzi.md) — Usługa zewnętrzna (sklep, bank, operator płatności) miała wysłać zdarzenie do Connect, ale nic się nie pojawiło - żadnego nowego obiektu danych, żadne... - [Duplikat faktury albo klienta](https://intum.pl/pomoc/inconnector/connect-problemy-duplikat-faktury-lub-klienta.md) — To samo zamówienie wygenerowało dwie faktury, albo ten sam klient pojawił się w systemie docelowym dwa razy. Najczęstsza przyczyna: podwójne uruchomi... - [Proces utknął albo ma błąd](https://intum.pl/pomoc/inconnector/connect-problemy-proces-utknal-lub-ma-blad.md) — Zamówienie przyszło, ale faktura się nie pojawiła - a na liście procesów widać jeden, który stoi w miejscu albo skończył się błędem. Najpierw sprawdź... - [Stary proces albo obiekt nie ma pełnych danych](https://intum.pl/pomoc/inconnector/connect-problemy-stary-proces-bez-danych.md) — Obiekt danych sprzed roku, który wcześniej działał bez zarzutu, nagle nie daje się przetworzyć ponownie - dane wyglądają na okrojone albo próba ponowi... - [Szybka pomoc](https://intum.pl/pomoc/inconnector/connect-szybka-pomoc.md) — Stary proces albo obiekt nie ma pełnych danych Proces utknął albo ma błąd Duplikat faktury albo klienta Webhook nie dochodzi Błąd autoryzacji albo sek...