L’assistant lit dans FLOWii qui lui écrit : le contact et le partenaire, les affaires, les commandes, ainsi que les événements et les tâches. Il n’écrit jamais dans FLOWii. Ce qu’il peut lire exactement, vous le définissez pour chaque boîte mail séparément. Le fonctionnement général des connexions dans draften est décrit sur la page Intégrations.
Ce dont vous avez besoin
- FLOWii avec une licence payante – la licence FREE n’a pas d’API.
- Un administrateur de FLOWii – lui seul définit les droits d’accès d’un utilisateur.
- Dans draften, un propriétaire ou un gestionnaire de l’organisation.
Dans FLOWii
Par l’API, FLOWii se connecte avec l’e-mail et le mot de passe d’un utilisateur, plus une clé API. draften a donc besoin du mot de passe de l’utilisateur – c’est pourquoi vous créez pour l’assistant un utilisateur distinct aux droits les plus restreints, et non le compte d’une personne.
Utilisateur aux droits les plus restreints
- Ouvrez Firma (Entreprise) → Uživatelé (Utilisateurs) → Nový uživatel (Nouvel utilisateur). Renseignez le prénom, le nom et l’e-mail de connexion – notez-le, draften en aura besoin.
- Ouvrez le nouvel utilisateur → onglet Přístupová práva (Droits d’accès). Pour les modules que l’assistant doit lire, choisissez Prohlížení (Consultation), pour tous les autres Zakázaný (Interdit) :
- Partneři (Partenaires) – contact et partenaire,
- Obchodní případy (Affaires),
- Zakázky (Commandes),
- Události (Événements) et Úlohy (Tâches).
- L’utilisateur doit être actif et avoir un mot de passe défini. C’est l’administrateur qui l’active ; l’utilisateur définit son mot de passe lors de sa première connexion. Chaque utilisateur est une licence payante dans FLOWii.
Vous pouvez enregistrer ces mêmes droits comme profil et le réutiliser : roue dentée dans le menu du haut → Nastavení (Paramètres) → Přístupová práva → Profily (Profils) → Nový profil (Nouveau profil) ; vous le choisissez ensuite chez l’utilisateur dans le champ Profil.
Clé API
Roue dentée dans le menu du haut → Nastavení → Rozšíření (Extensions) → API → FLOWii REST API. La clé s’affiche sous API klíč (Clé API) – copiez-la.
ID de l’entreprise
Uniquement si l’identifiant de l’utilisateur donne accès à plusieurs entreprises. Inutile de chercher l’ID : le test de connexion dans draften liste les entreprises avec leur ID.
Dans draften
- Ouvrez Organisation → Intégrations et, dans la carte Intégrations, renseignez :
- Système – FLOWii,
- Nom – par exemple
FLOWii – ventes, - E-mail de connexion de l’utilisateur – l’e-mail de l’utilisateur de l’étape précédente,
- ID de l’entreprise (facultatif) – vide si l’utilisateur ne voit qu’une seule entreprise,
- Mot de passe de l’utilisateur et Clé API.
Cliquez sur Ajouter une connexion. Le mot de passe et la clé sont stockés chiffrés et ne sont plus jamais affichés.
- Dans la ligne de la connexion, ouvrez le menu ⋯ → Tester la connexion. Au bout d’un instant s’affiche « Connexion opérationnelle (…), compte … » avec le nom de l’entreprise. Si l’utilisateur voit plusieurs entreprises, le test écrit « La connexion donne accès à ces entreprises – indiquez l’ID de la bonne dans « ID de l’entreprise » » ; complétez l’ID et relancez le test. Les modules que l’utilisateur n’a pas le droit de lire sont listés sous « Non disponible avec ce jeton : » (les noms des modules sont en slovaque, tels que FLOWii les renvoie).
- Dans la partie Quelles boîtes mail peuvent utiliser la connexion, cliquez sur Accorder à côté d’une boîte mail, cochez ce que l’assistant peut lire, puis cliquez sur Enregistrer l’accès :
- Contact et partenaire,
- Affaires et, en dessous, Revenus prévus,
- Commandes,
- Événements et tâches et, en dessous, Notes des événements.
- L’éditeur de l’assistant ajoute ensuite, dans Paramètres de l’assistant → Connaissances, une source de type système externe et choisit ce que l’assistant lit réellement – voir Connecter un CRM et d’autres systèmes.
Lorsque le mot de passe de l’utilisateur change, la connexion cesse de fonctionner. Saisissez le nouveau mot de passe dans les champs sous Nouveau secret d’accès de la connexion (le mot de passe et la clé API) et cliquez sur Remplacer ; puis relancez Tester la connexion.
Erreurs du test de connexion
Le message du test est en anglais ; il vient directement de FLOWii ou de draften :
| Dans le message | Ce que cela signifie | Que faire |
|---|---|---|
the login, the password or the API key was refused | FLOWii n’a pas accepté l’e-mail, le mot de passe ou la clé API | vérifier les trois informations ; l’utilisateur doit être actif et la licence payante |
the login reaches N companies - set the company's id on the connection | l’utilisateur voit plusieurs entreprises | renseigner l’ID de l’entreprise d’après la liste du test |
the login does not reach company … | l’utilisateur ne voit pas l’ID d’entreprise saisi | corriger l’ID, ou donner à l’utilisateur l’accès à l’entreprise |
the login reaches no company | l’utilisateur ne voit aucune entreprise | rattacher l’utilisateur à une entreprise |
the user of the login may not read this (403) | l’utilisateur n’a pas le droit de lire le module | choisir Prohlížení pour les modules nécessaires |
FLOWii rate limit reached (429) | la limite quotidienne d’appels API est atteinte | réessayer plus tard |