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.
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
- 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.
- 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.
- 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
- 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í.
- 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).
- 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í.
- 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.
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 |