# Connecter Raynet CRM

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](/fr/admin/integrations).

## 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

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](/fr/connecting-a-crm).

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 |