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

# Déclencher un appel VoiceAgent depuis Zoho Desk

> Automatisez les appels VoiceAgent directement depuis les workflows Zoho Desk

<Note>
  Vous pouvez déclencher automatiquement un appel VoiceAgent CloudTalk directement depuis les règles d'automatisation de Zoho Desk. Ce guide vous montre comment créer une Custom Function, la relier à une règle de workflow et vérifier que les appels sont bien lancés.
</Note>

**Niveau d'utilisateur** : Admin

***

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

Il vous faut :

* Un VoiceAgent CloudTalk déjà créé (notez l'ID du VoiceAgent)

* Les identifiants de l'API CloudTalk (Clé API et Secret) — disponibles dans **Paramètres de l'entreprise > Intégrations > API** ([Comment accéder à vos clés API CloudTalk et les générer](/fr/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys))

* Un compte Zoho Desk avec accès à Automation

* Des fiches de contact comportant des numéros de téléphone

<h2 id="h_145e880437">
  Générer l'en-tête Autorisation
</h2>

CloudTalk utilise l'authentification Basic pour les requêtes API. Pour générer votre valeur encodée :

1. Rendez-vous sur [https://www.debugbear.com/basic-auth-header-generator](https://www.debugbear.com/basic-auth-header-generator)

2. Saisissez votre **Clé API CloudTalk** comme nom d'utilisateur et votre **Secret API** comme mot de passe

3. Copiez l'en-tête généré. Il ressemblera à : `Basic XXXXXXXXX`

Vous utiliserez cette valeur dans le script de la Custom Function ci-dessous.

<h2 id="h_6d25a42937">
  Configurer l'intégration
</h2>

<h3 id="h_d35cb3411c">
  Créer la Custom Function
</h3>

1\. Allez dans **Setup > Developer Space > Custom Functions**

2\. Cliquez sur **New Function**

3\. Configurez la fonction :

* **Function Name :** CloudTalk VoiceAgent

* **Module :** sélectionnez le module qui déclenchera l'appel (par ex. Contacts, Tickets)

4\. Sous **Argument Mapping**, ajoutez :

* **Argument Name :** `phoneNumber` > **Select Field :** Contact Phone (ou le champ téléphone correspondant à votre module)

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15442851/f7b454104051-screenshot-2026-06-08-at-15-17-51.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=cfc3d5d04d921cb621be8e03dc85ae6f" alt="" width="2068" height="1234" data-path="images/help-center/articles/15442851/f7b454104051-screenshot-2026-06-08-at-15-17-51.png" />
</Frame>

5\. Collez le script suivant dans l'éditeur **Function Script** :

```
phoneVal = phoneNumber;
agentId = "YOUR_VOICE_AGENT_ID";
jsonBody = '{"call_number":"' + phoneVal + '","voice_agent_id":"' + agentId + '"}';

headers = Map();
headers.put("Authorization","Basic XXXXXXXXX");
headers.put("Content-Type","application/json");

response = invokeurl
[
    url: "https://api.cloudtalk.io/v1/voice-agent/calls"
    type: POST
    parameters: jsonBody
    headers: headers
];

info response;
```

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15442851/bfcf2a7d44d3-screenshot-2026-06-08-at-15-18-12.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=1beb14b5d1aa22ae780946174f885432" alt="" width="2060" height="1230" data-path="images/help-center/articles/15442851/bfcf2a7d44d3-screenshot-2026-06-08-at-15-18-12.png" />
</Frame>

Remplacez `YOUR_VOICE_AGENT_ID` par l'ID réel de votre VoiceAgent et `XXXXXXXXX` par vos identifiants encodés en Base64 obtenus à l'étape précédente.

<Tip>
  `call_number` et `voice_agent_id` sont les seuls champs obligatoires. Vous pouvez éventuellement transmettre des `call_properties` supplémentaires, comme des variables de prompt système ou des variables de sortie, selon la configuration de votre VoiceAgent. [Découvrez ce que vous pouvez inclure](/fr/articles/11401649-voiceagents-for-outbound-calls).
</Tip>

6\. Cliquez sur **Enregistrer le script**, puis sur **Enregistrer.**

<h3 id="h_6a6da01438">
  Créer la règle d'automatisation
</h3>

1. Allez dans **Setup > Automation > Workflow Rules**

2. Cliquez sur **New Rule** et sélectionnez le même module que celui choisi à l'étape 1

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15442851/f2490da4deee-screenshot-2026-06-08-at-15-17-27.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=a833428c1a45abed512a500c62a44f1c" alt="" width="2932" height="1438" data-path="images/help-center/articles/15442851/f2490da4deee-screenshot-2026-06-08-at-15-17-27.png" />
   </Frame>

3\. Définissez l'événement déclencheur, par exemple :

* Contact créé

* Statut du ticket passé à Open

4**. Facultatif :** ajoutez des conditions pour restreindre les fiches qui déclenchent l'appel (par ex. champ téléphone non vide, service précis)

5\. Sous **Actions**, sélectionnez **Custom Function > CloudTalk VoiceAgent**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15442851/3474f1a58059-screenshot-2026-06-08-at-15-17-38.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=1eefb6c3c83bb50c99b88ccc67e177bf" alt="" width="2928" height="1348" data-path="images/help-center/articles/15442851/3474f1a58059-screenshot-2026-06-08-at-15-17-38.png" />
</Frame>

6\. Enregistrez et activez la règle

<h3 id="h_69986ae3d2">
  Tester et vérifier
</h3>

1. Créez ou mettez à jour une fiche qui remplit vos conditions de déclenchement

2. Allez dans **Setup > Automation > Workflow Rules**, ouvrez votre règle et consultez les **Logs**

3. Vérifiez dans CloudTalk que l'appel du VoiceAgent a bien été lancé

**Tout est prêt !** 🚀 Votre configuration est terminée et vous pouvez commencer à déclencher des appels VoiceAgent en toute simplicité. Place à l'automatisation !

<Info>
  💡 **Limites de l'API à garder à l'esprit**

  *Pour éviter les échecs ou la limitation du débit, veillez à ce que votre automatisation Zoho Desk répartisse les appels avec précaution. Utilisez des temporisations ou une logique de planification si nécessaire, car la limite de débit standard de l'API (60 requêtes par minute) s'applique au point de terminaison VoiceAgent.*
</Info>

<h2 id="h_de10b8a2e9">
  Dépannage
</h2>

<Warning>
  Avant d'analyser des erreurs précises, vérifiez que votre règle d'automatisation est activée et qu'une fiche de test remplit réellement les conditions de déclenchement.
</Warning>

| **Erreur** | **Cause probable** | **Solution** |
| - | - | - |
| `401 Unauthorized` | Identifiants non valides ou expirés | Régénérez l'en-tête `Autorisation` et mettez-le à jour dans votre Custom Function |
| `400 Bad Request` | Numéro de téléphone mal formaté | Assurez-vous que le numéro de téléphone est au format E.164 (par ex. `+1234567890`) |
| La règle ne se déclenche pas | La règle est désactivée ou les conditions de déclenchement ne correspondent pas | Vérifiez que la règle est active et que la fiche remplit toutes les conditions |

***

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


## Related topics

- [Déclencher un appel VoiceAgent depuis Zoho CRM](/fr/articles/15516182-triggering-a-voiceagent-call-from-zoho-crm.md)
- [Déclencher un appel VoiceAgent depuis Freshdesk](/fr/articles/15457387-triggering-a-voiceagent-call-from-freshdesk.md)
- [Déclencher un appel VoiceAgent depuis Freshservice](/fr/articles/15502021-triggering-a-voiceagent-call-from-freshservice.md)


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