Pour les administrateurs
← Tous les sujets

Connecter Raynet CRM

Un utilisateur en lecture seule, une clé API et le nom de l’instance dans Raynet, puis la connexion dans draften, étape par étape.

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

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

  1. En haut à droite, cliquez sur votre nom → Nastavení (Paramètres).
  2. 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.

  3. 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.
  4. 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

  1. Nastavení → dans le menu de gauche, section PRO VÝVOJÁŘE (Pour les développeurs) → API klíče (Clés API).
  2. 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.
  3. 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

  1. 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.

  2. 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 : ».
  3. 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.
  4. 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 messageCe que cela signifieQue 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 lirevé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 atteinteré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 validesrecopier le nom de l’instance depuis O aplikaci Raynet CRM
Raynet answered HTTP …une autre réponse de Raynetvérifier le nom de l’instance et réessayer

Version texte