L’assistant lit dans Raynet qui lui écrit : le contact et l’entreprise, les affaires, les offres et commandes et les activités. Il n’écrit jamais dans Raynet. 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
- Raynet avec la formule PROFESSIONAL ou supérieure – la formule START n’a pas de clés API.
- Une instance sur app.raynet.cz (le serveur tchèque). Une instance sur les serveurs slovaque ou internationaux de Raynet (
app.raynetcrm.sk,eu.raynetcrm.com,app.raynetcrm.com) ne peut pas être connectée. - Un administrateur de Raynet – lui seul crée l’utilisateur et la clé API.
- Dans draften, un propriétaire ou un gestionnaire de l’organisation.
Dans Raynet
Raynet n’a pas de clé en lecture seule : une clé API a toujours les droits de l’utilisateur auquel elle appartient. Créez donc pour l’assistant un utilisateur distinct avec un rôle en lecture seule. Ne donnez pas la clé d’un administrateur – un administrateur voit tout et peut tout faire.
Utilisateur en lecture seule
- En haut à droite, cliquez sur votre nom → Nastavení (Paramètres).
- Dans le menu de gauche, ouvrez Uživatelské účty (Comptes utilisateurs) et ajoutez un utilisateur avec Přidat uživatele (Ajouter un utilisateur) – dans la version payante, d’abord Přidat další uživatelské účty (Ajouter d’autres comptes utilisateurs), puis Přiřadit uživatele (Attribuer un utilisateur). Renseignez :
- le nom, par exemple
draften, - l’e-mail de connexion – notez-le, draften en aura besoin,
- le rôle Jen ke čtení (Lecture seule).
Chaque utilisateur est une licence payante dans Raynet.
- le nom, par exemple
- Si l’utilisateur existe déjà : Uživatelské účty → ouvrez son profil → Oprávnění uživatele (Droits de l’utilisateur) → changez le rôle en Jen ke čtení et enregistrez.
- Facultativement, limitez les enregistrements que l’utilisateur verra : Nastavení → Bezpečnostní úrovně (Niveaux de sécurité) → Přidat úroveň (Ajouter un niveau), nommez le niveau et choisissez l’utilisateur.
Clé API
- Nastavení → dans le menu de gauche, section PRO VÝVOJÁŘE (Pour les développeurs) → API klíče (Clés API).
- Cliquez sur Nový API klíč (Nouvelle clé API). Dans la fenêtre Vytvořit API klíč (Créer une clé API), renseignez :
- Název klíče (Nom de la clé) – par exemple
draften, - Uživatel (Utilisateur) – l’utilisateur en lecture seule de l’étape précédente. La clé lira avec ses droits.
- Název klíče (Nom de la clé) – par exemple
- Copiez la clé immédiatement – une fois enregistrée, Raynet ne l’affiche plus. Cliquez ensuite sur Vytvořit API klíč.
Nom de l’instance
En haut à droite, cliquez sur votre nom → O aplikaci Raynet CRM (À propos de Raynet CRM) ; vous y trouvez le nom de l’instance. C’est aussi la partie de l’adresse après app.raynet.cz/ – pour l’adresse https://app.raynet.cz/firma, c’est firma.
Dans draften
- Ouvrez Organisation → Intégrations et, dans la carte Intégrations, renseignez :
- Système – Raynet CRM,
- Nom – par exemple
Raynet – ventes, - Nom de l’instance – celui de l’étape précédente,
- Utilisateur (e-mail) – l’e-mail de connexion de l’utilisateur en lecture seule,
- Secret d’accès – la clé API.
Cliquez sur Ajouter une connexion. La clé est stockée chiffrée et n’est plus jamais affichée.
- Dans la ligne de la connexion, ouvrez le menu ⋯ → Tester la connexion. Au bout d’un instant s’affiche « Connexion opérationnelle (…), compte … ». Si l’utilisateur n’a pas le droit de lire quelque chose, le test l’indique sous « Non disponible avec ce jeton : ».
- 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 entreprise,
- Affaires et, en dessous, Montants,
- Offres et commandes,
- Activités et, en dessous, Description et solution des activités.
- 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 vous remplacez la clé, saisissez la nouvelle dans le champ Nouveau secret d’accès de la connexion 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 Raynet ou de draften :
| Dans le message | Ce que cela signifie | Que faire |
|---|---|---|
the user name or the API key was refused (401) | Raynet n’a pas accepté l’e-mail ou la clé | vérifier que l’e-mail est bien l’e-mail de connexion de l’utilisateur auquel appartient la clé, et saisir de nouveau la clé |
the user of the API key may not read this (403) | l’utilisateur de la clé n’a pas le droit de lire | vérifier le rôle et le niveau de sécurité de l’utilisateur |
Raynet rate limit reached (429) | la limite quotidienne d’appels API est atteinte | réessayer plus tard ; Raynet fixe la limite selon la formule |
Raynet needs the instance name (letters, digits, dashes) | le nom de l’instance manque ou contient des caractères non valides | recopier le nom de l’instance depuis O aplikaci Raynet CRM |
Raynet answered HTTP … | une autre réponse de Raynet | vérifier le nom de l’instance et réessayer |