# FLOWii: napojení

Asistent si z FLOWii přečte, kdo mu píše: kontakt a partnera, obchodní
případy, zakázky a události a úlohy. Do FLOWii nikdy nezapisuje. Co přesně smí
číst, určíte u každé schránky zvlášť. Jak napojení v draftenu funguje obecně,
popisuje stránka [Integrace](/cs/admin/integrations).

## Co budete potřebovat

- FLOWii s **placenou licencí** — licence FREE API nemá.
- **Administrátora FLOWii** — jen ten nastaví uživateli přístupová práva.
- V draftenu **vlastníka nebo správce organizace**.

## Ve FLOWii

FLOWii se přes API přihlašuje **e-mailem a heslem uživatele** a k tomu API
klíčem. draften tedy potřebuje heslo uživatele — proto pro asistenta založte
**samostatného uživatele s co nejužšími právy**, ne účet člověka.

### Uživatel s co nejužšími právy

1. Otevřete **Firma** → **Uživatelé** → **Nový uživatel**. Vyplňte jméno,
   příjmení a přihlašovací e-mail — zapamatujte si ho, draften ho bude
   potřebovat.
2. Otevřete nového uživatele → záložka **Přístupová práva**. U modulů, které
   má asistent číst, zvolte **Prohlížení**, u všech ostatních **Zakázaný**:
   - **Partneři** — kontakt a partner,
   - **Obchodní případy**,
   - **Zakázky**,
   - **Události** a **Úlohy**.
3. Uživatel musí být aktivní a mít nastavené heslo. Aktivuje ho
   administrátor; heslo si nastaví při prvním přihlášení. Každý uživatel je ve
   FLOWii placená licence.

Stejná práva můžete uložit jako profil a použít ho znovu: ozubené kolečko
v horním menu → **Nastavení** → **Přístupová práva** → **Profily** → **Nový
profil**; u uživatele ho pak vyberete v poli **Profil**.

### API klíč

Ozubené kolečko v horním menu → **Nastavení** → **Rozšíření** → **API** →
**FLOWii REST API**. Zobrazí se **API klíč** — zkopírujte ho.

### ID firmy

Jen když přihlášení uživatele vidí víc firem. ID nemusíte hledat: test
spojení v draftenu firmy i s jejich ID vypíše.

## V draftenu

1. Otevřete Organizace → **Integrace** a v kartě **Integrace** vyplňte:
   - **Systém** — **FLOWii**,
   - **Název** — třeba `FLOWii – obchod`,
   - **Přihlašovací e-mail uživatele** — e-mail uživatele z předchozího kroku,
   - **ID firmy (nepovinné)** — prázdné, pokud uživatel vidí jen jednu firmu,
   - **Heslo uživatele** a **API klíč**.

   Klikněte na **Přidat připojení**. Heslo a klíč se uloží zašifrované a už
   se nezobrazí.
2. V řádku připojení otevřete nabídku **⋯** → **Otestovat spojení**. Za chvíli
   se ukáže „Spojení v pořádku (…), účet …“ s názvem firmy. Když uživatel vidí
   víc firem, test napíše „Přihlášení vidí tyto firmy – ID té správné zadejte
   do pole „ID firmy““; ID doplňte a test zopakujte. Moduly, které uživatel
   číst nesmí, test vypíše pod „S tímto tokenem nejsou dostupné:“ (názvy
   modulů jsou slovensky, jak je vrací FLOWii).
3. V části **Které schránky smějí připojení používat** klikněte u schránky na
   **Povolit**, zaškrtněte, co smí asistent číst, a klikněte na **Uložit
   oprávnění**:
   - **Kontakt a partner**,
   - **Obchodní případy** a pod nimi **Očekávané příjmy**,
   - **Zakázky**,
   - **Události a úlohy** a pod nimi **Poznámky u událostí**.
4. Editor asistenta pak v Nastavení asistenta → **Znalosti** přidá zdroj
   druhu **externí systém** a vybere, co asistent opravdu čte — viz
   [Napojení na CRM a jiné systémy](/cs/connecting-a-crm).

**Když se uživateli změní heslo**, přestane napojení fungovat. Nové heslo
vložte u připojení do polí pod **Nový přístupový údaj** (heslo i API klíč)
a klikněte na **Vyměnit**; pak znovu **Otestovat spojení**.

## Chyby testu spojení

Hláška testu je anglicky, přímo od FLOWii nebo od draftenu:

| V hlášce | Co to znamená | Co udělat |
|---|---|---|
| `the login, the password or the API key was refused` | FLOWii nepřijal e-mail, heslo nebo API klíč | zkontrolovat všechny tři údaje; uživatel musí být aktivní a licence placená |
| `the login reaches N companies - set the company's id on the connection` | uživatel vidí víc firem | doplnit **ID firmy** podle výpisu testu |
| `the login does not reach company …` | zadané ID firmy uživatel nevidí | opravit ID, nebo uživateli firmu zpřístupnit |
| `the login reaches no company` | uživatel nevidí žádnou firmu | přiřadit uživatele k firmě |
| `the user of the login may not read this (403)` | uživatel nesmí číst modul | nastavit **Prohlížení** u potřebných modulů |
| `FLOWii rate limit reached (429)` | vyčerpaný denní limit volání API | zkusit později |