> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurer Zoho Desk

> Découvrez comment connecter Zoho Desk à CloudTalk et configurer la synchronisation des données

<Note>
  Configurez l'échange de données entre CloudTalk et Zoho Desk pour que vos données restent à jour.
</Note>

**Niveau d'utilisateur** : Administrateur

***

<h2 id="h_bc0f2e3f13">
  Avant de commencer
</h2>

Avant de connecter Zoho Desk à CloudTalk, assurez-vous que :

* Vous utilisez un forfait **[Essential, Expert ou Custom](https://www.cloudtalk.io/pricing)** [CloudTalk](https://www.cloudtalk.io/pricing).

* Vous avez un [compte Zoho Desk](https://www.zoho.com/desk/login.html) actif.

* Vous avez les autorisations **Admin** dans Zoho Desk.

* Vous avez les autorisations **Administrateur** dans CloudTalk.

* L'adresse e-mail que vous utilisez dans CloudTalk doit correspondre exactement à celle de votre compte Zoho Desk. Si les adresses ne correspondent pas, la synchronisation ne fonctionnera pas correctement.

<h2 id="h_93b230662f">
  Connecter Zoho Desk à CloudTalk
</h2>

1. Connectez-vous à votre [Dashboard](https://dashboard.cloudtalk.io/login) CloudTalk.

2. Allez dans **Compte** > **Intégrations**.

3. Dans la section **Ajouter une intégration**, trouvez **Zoho Desk** et cliquez sur `+ Ajouter`.

4. Vous pouvez éventuellement donner un nom unique à votre intégration.

   ```
   💡 CONSEIL : donner un nom unique à votre intégration peut être utile si votre organisation connecte plusieurs instances Zoho Desk pour différentes équipes.
   ```

5. Dans la section **Paramètres de flux de travail**, cliquez sur `New Authentication`.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/6114608/7dc74f4acc66-zoho1.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=8e0708f0b1fa199057baaaaadbe4a02c" alt="" width="2392" height="1576" data-path="images/help-center/articles/6114608/7dc74f4acc66-zoho1.png" />
</Frame>

6\. Nommez votre intégration si vous le souhaitez, puis cliquez sur `Créer`.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/6114608/8b4e17448378-zoho2.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=14b5cf963779f78db8eeb3fd2024498f" alt="" width="2408" height="1496" data-path="images/help-center/articles/6114608/8b4e17448378-zoho2.png" />
</Frame>

7\. Vous serez redirigé vers votre compte Zoho. Connectez-vous à Zoho.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/6114608/aea22cc88def-zoho3.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=c4eb7c3d7ab108920a5774718cb7a5f1" alt="" width="1834" height="1160" data-path="images/help-center/articles/6114608/aea22cc88def-zoho3.png" />
</Frame>

8\. Sélectionnez votre environnement Zoho (il s'agit généralement de **Production**).

9\. Vérifiez que Zoho Desk figure bien sur l'écran suivant et cliquez sur `Accept` pour autoriser CloudTalk à se connecter à votre compte Zoho Desk.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/6114608/2403e3ffd9c5-zoho5.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=76b65bccb7b055b18736ddae3f26e869" alt="" width="1448" height="1494" data-path="images/help-center/articles/6114608/2403e3ffd9c5-zoho5.png" />
</Frame>

10\. Vous serez ensuite redirigé vers CloudTalk ; cliquez sur `Terminer` pour enregistrer vos **Paramètres** **de flux de travail**.

***

<h3 id="h_b42360bbb6">
  Configurer le mappage des champs personnalisés (facultatif)
</h3>

Une fois l'authentification terminée, faites défiler jusqu'à la section **Mappage des champs personnalisés**.

CloudTalk vous permet de mapper les données d'appel vers des champs personnalisés des tickets Zoho Desk.

Vous pouvez ainsi enregistrer des informations d'appel telles que la direction de l'appel, le temps de conversation ou l'ID de l'appel dans des champs Zoho Desk structurés, et non uniquement dans la description du ticket.

<h4 id="h_7f1504c2d1">
  Fonctionnement du mappage
</h4>

* À gauche, sélectionnez un **champ d'appel CloudTalk**

* À droite, saisissez le **nom d'API** du champ personnalisé Zoho Desk. Il s'agit d'un **champ de texte libre**, ce qui signifie que les **champs personnalisés ne sont pas chargés automatiquement** depuis Zoho Desk. Vous devez **saisir manuellement le nom d'API exact** du champ personnalisé tel qu'il est défini dans votre compte Zoho Desk.

* Cliquez sur **Ajouter un nouveau mappage** pour mapper d'autres champs.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/6114608/b5c6f80724d1-screenshot-2026-03-17-at-09-59-11.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=13a2ddf8b1a10731d14783e909a58ba3" alt="" width="2347" height="563" data-path="images/help-center/articles/6114608/b5c6f80724d1-screenshot-2026-03-17-at-09-59-11.png" />
</Frame>

<h4 id="h_731b7b080b">
  Champs CloudTalk disponibles
</h4>

Vous pouvez mapper les données d'appel suivantes :

* callID

* internal\_number

* public\_number

* direction

* callStartTime

* callEndTime

* status

* waiting\_time

* agent\_email

<h4 id="h_a9ca46621d">
  Utiliser les noms d'API des champs personnalisés Zoho Desk
</h4>

Les champs personnalisés Zoho Desk doivent être référencés par leur **nom d'API**, et non par leur nom d'affichage.

Les noms d'API suivent généralement ce format :

```
cf_fieldname
```

Exemple :

```
cf_call_id
cf_internal_number
cf_public_number
cf_call_direction
```

<Warning>
  **Important**

  * Si un champ n'est pas mappé, il ne sera pas exporté vers Zoho Desk

  * Seuls les champs mappés avec succès sont inclus dans le ticket

  * Assurez-vous que les champs personnalisés existent déjà dans Zoho Desk avant de les mapper

  * Si le champ personnalisé n'existe pas dans Zoho Desk, la valeur ne sera pas enregistrée dans le ticket.
</Warning>

***

<h4 id="h_e64e2feeb2">
  Poursuivre la configuration
</h4>

11\. Les administrateurs peuvent choisir quels appels sont exportés vers Zoho Desk. Pour ne consigner que les appels de certains numéros CloudTalk, ajoutez ces numéros dans la section **Numéros connectés**.

12\. Pour ne consigner que les SMS de certains numéros CloudTalk, ajoutez ces numéros dans la section **Numéros connectés pour SMS**

13\. En haut de la page, vérifiez que votre intégration est définie sur `Actif`.

14\. Choisissez quelles directions d'appel créent des tickets. Par défaut, CloudTalk crée un ticket Zoho Desk pour chaque type d'appel. Utilisez les boutons bascule de la section **Journalisation des appels** pour contrôler précisément quels appels sont consignés.

| Bouton bascule | Ce qu'il fait |
| - | - |
| **Consigner les appels sortants traités** | Crée un ticket lorsqu'un appel sortant d'un agent est décroché |
| **Consigner les appels sortants non aboutis** | Crée un ticket lorsqu'un appel sortant reste sans réponse |
| **Consigner les appels entrants aboutis** | Crée un ticket lorsqu'un agent répond à un appel entrant |
| **Consigner les appels entrants manqués** | Crée un ticket lorsqu'un appel entrant reste sans réponse |
| **Consigner les messages vocaux** | Crée un ticket lorsqu'un appelant laisse un message vocal |

<Warning>
  **Conseil :** si des tickets indésirables encombrent votre helpdesk, commencez par désactiver **Consigner les appels entrants manqués** et **Consigner les appels sortants non aboutis**.
</Warning>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/6114608/ba051d2b89bd-screenshot-2026-06-01-at-12-17-54.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=029021070da2d1cc4e1da00bd67ca078" alt="" width="1479" height="644" data-path="images/help-center/articles/6114608/ba051d2b89bd-screenshot-2026-06-01-at-12-17-54.png" />
</Frame>

15\. Cliquez sur `Enregistrer`.

<h2 id="h_aee26942c8">
  Déconnecter ou supprimer l'intégration
</h2>

Si vous ne souhaitez plus que CloudTalk synchronise les données avec Zoho Desk, vous pouvez désactiver l'intégration ou la supprimer définitivement.

Pour **désactiver l'intégration**, allez dans **Compte > Intégrations**, repérez l'**intégration Zoho Desk** et faites basculer le statut de **Actif** à **Inactive**.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/6114608/6baee58f26ac-screenshot-2026-03-16-at-13-11-47.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=0bd6d60701b7c3ecd3caf20b9767e1fe" alt="" width="2357" height="328" data-path="images/help-center/articles/6114608/6baee58f26ac-screenshot-2026-03-16-at-13-11-47.png" />
</Frame>

Pour **supprimer définitivement l'intégration**, ouvrez les paramètres de l'intégration Zoho Desk, faites défiler vers le bas, cliquez sur **Supprimer l'intégration** et saisissez **DELETE** pour confirmer.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/6114608/8aed4aaa4354-screenshot-2025-07-03-at-11-57-50.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=c9e8757139397ede6582336d9aa41031" alt="" width="350" data-path="images/help-center/articles/6114608/8aed4aaa4354-screenshot-2025-07-03-at-11-57-50.png" />
</Frame>

Votre intégration Zoho Desk est désormais supprimée de CloudTalk.

***

*Besoin d'aide ou une question ?* Contactez-nous simplement via notre [Portail Support](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — nous sommes là pour vous.


## Related topics

- [Utiliser Zoho Desk avec CloudTalk](/fr/articles/14076544-using-zoho-desk-with-cloudtalk.md)
- [Configurer Zoho](/fr/articles/3490662-configure-zoho.md)
- [Déclencher un appel VoiceAgent depuis Zoho Desk](/fr/articles/15442851-triggering-a-voiceagent-call-from-zoho-desk.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.