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

> Automatisez les appels VoiceAgent depuis les Triggers et Automations Zendesk

<Note>
  Vous pouvez déclencher automatiquement un appel VoiceAgent CloudTalk depuis les Triggers ou les Automations de Zendesk. Zendesk prend nativement en charge l'authentification Basic dans la configuration de ses Webhooks : aucun middleware n'est donc nécessaire. Ce guide vous montre comment configurer le webhook, le relier à un trigger et vérifier que l'appel a bien été lancé.
</Note>

**Niveau d'utilisateur** : Admin

***

<h2 id="before-you-start">
  Avant de commencer
</h2>

Vous aurez besoin de :

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

* La clé API et le secret CloudTalk (**Paramètres de l'entreprise > Intégrations > API**)

* Un plan Zendesk Support Professional ou supérieur

* Des fiches de contact/demandeur comportant un numéro de téléphone

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

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

1. Dans le Zendesk Admin Center, allez dans **Apps and integrations > Webhooks**.

2. Cliquez sur **Create webhook**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/b1a87fcbfc33-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=3b3b2435d5b92b81e7ff3e70e6d73eac" alt="" width="3600" height="2064" data-path="images/help-center/articles/15934846/b1a87fcbfc33-image.png" />
   </Frame>

3. Sélectionnez **Trigger or automation** et cliquez sur **Next**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/d66feedd2495-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=506cf3c3e35dd681833fb33a90c56c46" alt="" width="2970" height="1896" data-path="images/help-center/articles/15934846/d66feedd2495-image.png" />
   </Frame>

4. Configurez le webhook :

   * **Name:** CloudTalk VoiceAgent

   * **Endpoint URL:** `https://api.cloudtalk.io/v1/voice-agent/calls`

   * **Request method:** POST

   * **Request format:** JSON

   * **Authentication:** Basic authentication

     * **Username:** votre clé API CloudTalk

     * **Password:** votre secret API CloudTalk

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/6295a2943f0e-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=78c8949f05e2337d22167fae3481702c" alt="" width="1586" height="1528" data-path="images/help-center/articles/15934846/6295a2943f0e-image.png" />
   </Frame>

5. Cliquez sur **Create webhook > Finish Setup**.

<Note>
  Zendesk encode automatiquement les identifiants en Base64 lorsque l'authentification Basic est sélectionnée.
</Note>

<h3 id="h_81ccd62750">
  Créer le trigger
</h3>

1. Dans l'Admin Center, allez dans **Objects and rules > Business rules > Triggers** (ou **Automations**).

2. Cliquez sur **Create trigger**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/e30863086760-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=45848cc42f215461c9dbbff9d8c3c689" alt="" width="3628" height="1532" data-path="images/help-center/articles/15934846/e30863086760-image.png" />
   </Frame>

3. Saisissez un **Trigger name** (par ex. Ticket Solved).

4. Choisissez une **Trigger category** : créez une nouvelle catégorie ou sélectionnez-en une qui convient parmi les catégories existantes.

5. Définissez vos **Conditions** (par ex. Ticket > Status > Is > Solved).

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15934846/036d3ef902d4-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=15d81021252741ab2093e78d05d3fba1" alt="" width="1538" height="1242" data-path="images/help-center/articles/15934846/036d3ef902d4-image.png" />
   </Frame>

6. Sous **Actions**, cliquez sur **Add action** et sélectionnez **Notify active webhook**.

7. Sélectionnez le webhook que vous avez créé à l'étape 1. Un champ de texte pour le corps JSON apparaît.

8. Saisissez votre charge utile JSON dans le champ de texte. Utilisez le placeholder Zendesk `#{{ticket.requester.phone}}` pour associer le numéro de téléphone du demandeur à `call_number` :

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/bd395bb986f2-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=abcee019a5e4d70d2fa724ad55563348" alt="" width="1574" height="1770" data-path="images/help-center/articles/15934846/bd395bb986f2-image.png" />
   </Frame>

```json theme={"system"}
{
  "call_number": "#{{ticket.requester.phone}}",
  "voice_agent_id": "YOUR_VOICE_AGENT_ID"
}
```

<Note>
  `call_number` et `voice_agent_id` sont les seuls champs obligatoires. Les `call_properties` supplémentaires, comme les variables du prompt système et les variables de sortie, sont facultatives et dépendent de la configuration de votre VoiceAgent. [Découvrez ce qu'il faut inclure](/fr/articles/11401649-voiceagents-for-outbound-calls).
</Note>

9\. En bas à droite, passez le trigger sur **Active** et cliquez sur **Create**.

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

1. Mettez à jour un ticket de test pour qu'il remplisse les conditions du trigger.

2. Allez dans **Apps and integrations > Webhooks > CloudTalk VoiceAgent > Activity** pour confirmer l'envoi.

3. Dans CloudTalk, vérifiez que l'appel du VoiceAgent a bien été lancé.

**Tout est prêt !**

Zendesk déclenchera désormais automatiquement un appel VoiceAgent CloudTalk dès qu'un ticket remplira les conditions que vous avez choisies.

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

Si l'appel n'a pas été lancé, allez dans **Apps and integrations > Webhooks > CloudTalk VoiceAgent > Activity** pour voir pourquoi l'envoi a échoué.

Les causes les plus fréquentes sont :

* **Autorisation** : identifiants API CloudTalk incorrects dans le webhook

* **Format du numéro** : le numéro n'est pas au format E.164 (`+1234567890`)

* **ID de VoiceAgent incorrect** : le mauvais `voice_agent_id` a été envoyé

* **Webhook non déclenché** : le trigger n'est pas actif ou ses conditions n'ont pas été remplies

***

*Besoin d'aide ou une question ?* Écrivez-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

- [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)
- [Déclencher un appel VoiceAgent depuis Pipedrive](/fr/articles/15516233-triggering-a-voiceagent-call-from-pipedrive.md)


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