# FLOWii: podłączenie

Asystent czyta z FLOWii, kto do niego pisze: kontakt i partnera, sprawy
handlowe, zamówienia oraz zdarzenia i zadania. Do FLOWii nigdy nic nie
zapisuje. Co dokładnie może czytać, ustalasz osobno dla każdej skrzynki. Jak
połączenia działają w draften ogólnie, opisuje strona
[Integracje](/pl/admin/integrations).

## Czego potrzebujesz

- FLOWii z **płatną licencją** – licencja FREE nie ma API.
- **Administratora FLOWii** – tylko on ustawi użytkownikowi prawa dostępu.
- W draften **właściciela lub menedżera organizacji**.

## W FLOWii

FLOWii loguje się przez API **e-mailem i hasłem użytkownika**, a do tego
kluczem API. draften potrzebuje więc hasła użytkownika – dlatego utwórz dla
asystenta **osobnego użytkownika z możliwie najwęższymi uprawnieniami**, a nie
konto człowieka.

### Użytkownik z możliwie najwęższymi uprawnieniami

1. Otwórz **Firma** → **Uživatelé** (Użytkownicy) → **Nový uživatel** (Nowy
   użytkownik). Wypełnij imię, nazwisko i e-mail logowania – zapamiętaj go,
   draften będzie go potrzebował.
2. Otwórz nowego użytkownika → zakładka **Přístupová práva** (Prawa
   dostępu). Przy modułach, które asystent ma czytać, wybierz **Prohlížení**
   (Przeglądanie), przy wszystkich pozostałych **Zakázaný** (Zabroniony):
   - **Partneři** (Partnerzy) – kontakt i partner,
   - **Obchodní případy** (Sprawy handlowe),
   - **Zakázky** (Zamówienia),
   - **Události** (Zdarzenia) i **Úlohy** (Zadania).
3. Użytkownik musi być aktywny i mieć ustawione hasło. Aktywuje go
   administrator; hasło użytkownik ustawi przy pierwszym logowaniu. Każdy
   użytkownik to w FLOWii płatna licencja.

Te same prawa możesz zapisać jako profil i używać go ponownie: koło zębate
w górnym menu → **Nastavení** (Ustawienia) → **Přístupová práva** →
**Profily** (Profile) → **Nový profil** (Nowy profil); przy użytkowniku
wybierzesz go potem w polu **Profil**.

### Klucz API

Koło zębate w górnym menu → **Nastavení** → **Rozšíření** (Rozszerzenia) →
**API** → **FLOWii REST API**. Wyświetli się **API klíč** (Klucz API) –
skopiuj go.

### ID firmy

Tylko gdy logowanie użytkownika obejmuje kilka firm. ID nie musisz szukać:
test połączenia w draften wypisze firmy razem z ich ID.

## W draften

1. Otwórz Organizacja → **Integracje** i na karcie **Integracje** wypełnij:
   - **System** – **FLOWii**,
   - **Nazwa** – np. `FLOWii – sprzedaż`,
   - **E-mail logowania użytkownika** – e-mail użytkownika z poprzedniego
     kroku,
   - **ID firmy (opcjonalnie)** – puste, jeśli użytkownik widzi tylko jedną
     firmę,
   - **Hasło użytkownika** i **Klucz API**.

   Kliknij **Dodaj połączenie**. Hasło i klucz zostaną zapisane w postaci
   zaszyfrowanej i nigdy więcej się nie wyświetlą.
2. W wierszu połączenia otwórz menu **⋯** → **Przetestuj połączenie**. Po
   chwili pojawi się „Połączenie działa (…), konto …” z nazwą firmy. Gdy
   użytkownik widzi kilka firm, test napisze „Logowanie obejmuje te firmy –
   wpisz ID właściwej w pole „ID firmy””; uzupełnij ID i powtórz test.
   Moduły, których użytkownik czytać nie może, test wypisze pod „Niedostępne
   z tym tokenem:” (nazwy modułów są po słowacku, tak jak zwraca je FLOWii).
3. W sekcji **Które skrzynki mogą używać połączenia** kliknij przy skrzynce
   **Nadaj**, zaznacz, co asystent może czytać, i kliknij **Zapisz
   uprawnienie**:
   - **Kontakt i partner**,
   - **Sprawy handlowe**, a pod nimi **Oczekiwane przychody**,
   - **Zamówienia**,
   - **Zdarzenia i zadania**, a pod nimi **Notatki do zdarzeń**.
4. Edytor asystenta dodaje potem w Ustawieniach asystenta → **Wiedza** źródło
   rodzaju **system zewnętrzny** i wybiera, co asystent faktycznie czyta –
   zobacz [Podłączenie CRM i innych systemów](/pl/connecting-a-crm).

**Gdy użytkownikowi zmieni się hasło**, połączenie przestanie działać. Nowe
hasło wpisz przy połączeniu w pola pod **Nowy sekret dostępowy** (hasło
i klucz API) i kliknij **Wymień**; potem znowu **Przetestuj połączenie**.

## Błędy testu połączenia

Komunikat testu jest po angielsku, bezpośrednio od FLOWii albo od draften:

| W komunikacie | Co to znaczy | Co zrobić |
|---|---|---|
| `the login, the password or the API key was refused` | FLOWii nie przyjął e-maila, hasła albo klucza API | sprawdzić wszystkie trzy dane; użytkownik musi być aktywny, a licencja płatna |
| `the login reaches N companies - set the company's id on the connection` | użytkownik widzi kilka firm | uzupełnić **ID firmy** według wyniku testu |
| `the login does not reach company …` | użytkownik nie widzi firmy o podanym ID | poprawić ID albo udostępnić użytkownikowi firmę |
| `the login reaches no company` | użytkownik nie widzi żadnej firmy | przypisać użytkownika do firmy |
| `the user of the login may not read this (403)` | użytkownik nie może czytać modułu | ustawić **Prohlížení** przy potrzebnych modułach |
| `FLOWii rate limit reached (429)` | wyczerpany dzienny limit wywołań API | spróbować później |