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

> Automatisez les appels sortants des VoiceAgents directement depuis Zoho CRM

<Note>
  Dans ce guide, vous apprendrez à déclencher automatiquement un appel d'un VoiceAgent CloudTalk depuis Zoho CRM à l'aide des Workflow Rules.
</Note>

**Niveau d'utilisateur** : Admin

***

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

Vous aurez besoin de :

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

* Des identifiants 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))

* Zoho CRM **plan Professional** ou supérieur

* Un champ téléphone disponible sur les fiches Contact ou Lead

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

CloudTalk utilise l'authentification Basic pour les requêtes API.

1. Ouvrez [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 la valeur générée. Elle ressemble à ceci : `Basic XXXXXXXXX`

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

<h3 id="h_create_webhook">
  Créer le webhook
</h3>

1\. Dans Zoho CRM, cliquez sur l'**icône Engrenage** en haut à droite, puis accédez à **Automation > Actions > Webhooks**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/98feae8fe1a4-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=c66f0979edeb7832e8f6616f11539e01" alt="" width="2840" height="1160" data-path="images/help-center/articles/15516182/98feae8fe1a4-image.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/73f55ba967b7-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=88bd7e10c27198c0b30f581ff28cba2e" alt="" width="2384" height="544" data-path="images/help-center/articles/15516182/73f55ba967b7-image.png" />
</Frame>

2\. Cliquez sur **Configure Webhook**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/c29a495b2b90-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=1fc63b01d658701a43e6dfce477807bf" alt="" width="2384" height="530" data-path="images/help-center/articles/15516182/c29a495b2b90-image.png" />
</Frame>

3\. Renseignez les détails du webhook :

| **Champ** | **Valeur** |
| - | - |
| Name | CloudTalk VoiceAgent |
| URL to Notify | `https://api.cloudtalk.io/v1/voice-agent/calls` |
| Method | POST |
| Authorization Type | General |
| Module | Contacts ou Leads |

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/4a5c1aef7583-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=a28db82730d3f7679e9ffb17a0c66e40" alt="" width="1385" height="949" data-path="images/help-center/articles/15516182/4a5c1aef7583-image.png" />
</Frame>

4\. Sous **Custom Headers**, ajoutez :

* `Authorization` → `Basic XXXXXXXXX` (la valeur que vous avez générée)

* `Content-Type` → `application/json`

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/5242d55f0b27-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=553381a3ed9fd980e2c3a4d21af4a47b" alt="" width="1644" height="514" data-path="images/help-center/articles/15516182/5242d55f0b27-image.png" />
</Frame>

5\. Sous **Body**, réglez **Type** sur Raw et **Format** sur JSON, puis collez :

```json theme={"system"}
{  "call_number": "${Contacts.Phone}",  "voice_agent_id": "YOUR_VOICE_AGENT_ID"}
```

<Warning>
  `call_number` et `voice_agent_id` sont les seuls champs obligatoires. Vous pouvez également transmettre des `call_properties` facultatifs, comme des variables de prompt système et des variables de sortie, selon la configuration de votre VoiceAgent. [Découvrez ce qu'il faut inclure](/fr/articles/11401649-voiceagents-for-outbound-calls)
</Warning>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/5dae1c82d009-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=eeb1d0596d12ab9a036373e3e3ca726f" alt="" width="2298" height="474" data-path="images/help-center/articles/15516182/5dae1c82d009-image.png" />
</Frame>

6\. Cliquez sur **Save**

<h3 id="h_create_rule">
  Créer la règle de workflow
</h3>

1\. Cliquez sur l'**icône Engrenage** en haut à droite, puis accédez à **Automation > Workflow Rules**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/801053f501d3-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=bcca196dfb6b5f1365ed0d7a3ded13f5" alt="" width="2856" height="1114" data-path="images/help-center/articles/15516182/801053f501d3-image.png" />
</Frame>

2\. Cliquez sur **Create Rule**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/5ef19e32b2ee-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=c3e2c947e6af57bfcdc914cca28bf0de" alt="" width="2850" height="874" data-path="images/help-center/articles/15516182/5ef19e32b2ee-image.png" />
</Frame>

<Warning>
  **Remarque :** les webhooks sont disponibles à partir de l'édition Zoho CRM Professional.
</Warning>

3\. Configurez la règle :

* Sélectionnez le **module** (par ex. Contacts ou Leads) et donnez un nom à la règle

* Définissez le **déclencheur** (par ex. création d'une fiche, modification d'un champ)

* Ajoutez des **conditions** pour filtrer les fiches (par ex. le champ téléphone n'est pas vide)

* Sous **Instant Actions**, ajoutez : **Webhook > CloudTalk VoiceAgent**

4\. Cliquez sur **Save**, puis sur **Activate** pour activer la règle

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/51a5a32cd713-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=c7d4b1550da7b824c867024705ed11b0" alt="" width="2016" height="1258" data-path="images/help-center/articles/15516182/51a5a32cd713-image.png" />
</Frame>

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

1. Créez ou mettez à jour un contact qui remplit les conditions de votre déclencheur

2. Accédez à **icône Engrenage > Automation > Workflow Rules**, sélectionnez votre règle et cliquez sur **View Usage** pour vérifier l'exécution

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

**Tout est prêt !** 🚀 Votre workflow Zoho CRM déclenchera désormais un appel d'un VoiceAgent CloudTalk dès qu'une fiche remplira les conditions que vous avez choisies.

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

  *Pour éviter les échecs ou la limitation du débit, veillez à ce que votre workflow gère la répartition des appels avec précaution. Utilisez des délais 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_troubleshooting">
  Dépannage
</h2>

Si l'appel du VoiceAgent n'a pas été passé, accédez à **View Usage** et cliquez sur **Failures**. Recherchez votre fiche et consultez la colonne **Reason For Failures**.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/f6fcd150ee27-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=186290eea2a7b0d1b57b663a9c28e4dd" alt="" width="2828" height="1232" data-path="images/help-center/articles/15516182/f6fcd150ee27-image.png" />
</Frame>

| **Erreur** | **À vérifier** |
| - | - |
| **Autorisation** | Identifiants API CloudTalk incorrects dans le webhook — régénérez-les et saisissez-les à nouveau |
| **Format du numéro** | Assurez-vous que le numéro est au format E.164 (`+1234567890`) |
| **ID de VoiceAgent incorrect** | Vérifiez que le `voice_agent_id` indiqué dans le corps du webhook est correct |
| **Webhook non déclenché** | Vérifiez que la règle de workflow est active et que ses conditions ont bien été remplies |

***

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 Desk](/fr/articles/15442851-triggering-a-voiceagent-call-from-zoho-desk.md)
- [Déclencher un appel VoiceAgent depuis Freshworks CRM](/fr/articles/15477534-triggering-a-voiceagent-call-from-freshworks-crm.md)
- [Déclencher un appel VoiceAgent depuis Zapier](/fr/articles/11831224-triggering-a-voiceagent-call-from-zapier.md)


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