Pro administrátory
← Na rozcestník

FLOWii: napojení

Uživatel s co nejužšími právy a API klíč ve FLOWii a připojení v draftenu, krok za krokem.

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

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.

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ášceCo to znamenáCo udělat
the login, the password or the API key was refusedFLOWii 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 connectionuživatel vidí víc firemdoplnit 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 companyuživatel nevidí žádnou firmupřiřadit uživatele k firmě
the user of the login may not read this (403)uživatel nesmí číst modulnastavit Prohlížení u potřebných modulů
FLOWii rate limit reached (429)vyčerpaný denní limit volání APIzkusit později

Textová verze