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

> Déclenchez des appels VoiceAgent CloudTalk via Zapier avec une étape Webhook. Automatisez vos appels, transmettez des données et personnalisez le tout, sans…

<Note>
  Ce guide vous explique comment déclencher un appel **CloudTalk VoiceAgent** à l'aide de **Zapier** et de l'application **Webhooks by Zapier**. Vous pouvez ainsi lancer des appels vocaux automatisés à partir d'événements en temps réel dans vos outils, sans écrire la moindre ligne de code.
</Note>

**Niveau d'utilisateur :**

* Admin

***

<h2 id="h_bc6a9f4970">
  Les VoiceAgents CloudTalk dans Zapier
</h2>

Zapier relie vos outils favoris et automatise les tâches entre eux. By Zapier vous aide à connecter vos outils et à automatiser les tâches entre eux. En le connectant à **CloudTalk VoiceAgent**, vous pouvez déclencher des appels vocaux à partir de données en direct issues d'outils comme des CRM, des formulaires ou des systèmes de helpdesk. Vous pouvez ainsi confirmer des rendez-vous, relancer des prospects ou envoyer des rappels vocaux en utilisant les données que vous collectez déjà. L'automatisation vocale s'intègre directement dans vos flux de travail existants.

Pour déclencher un **appel VoiceAgent depuis Zapier**, utilisez l'[application Webhooks](https://zapier.com/apps/webhook/integrations) afin d'envoyer une requête API à l'[endpoint CloudTalk VoiceAgent](/developers#tag/VoiceAgent) comme l'une des étapes de votre Zap.

<h3 id="h_a9cc30eafb">
  Prérequis
</h3>

Avant de configurer la Webhook Custom Request dans Zapier, assurez-vous d'avoir :

* *Vos identifiants d'API CloudTalk*

  * Allez dans **CloudTalk Dashboard → Compte → Paramètres → Clés API**

  * Copiez l'**API Key ID** et l'**API Key Secret**

* *L'ID du VoiceAgent*

  * L'ID du VoiceAgent peut être récupéré depuis Cloudtalk **Dashboard > VoiceAgents**

  <Frame>
    <img src="https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11831224/66af489dee4a-vaid.png?fit=max&auto=format&n=g8s2E4Yk8cWS5656&q=85&s=067b7d34380535b6ce267b80b228d17a" alt="" width="1622" height="477" data-path="images/help-center/articles/11831224/66af489dee4a-vaid.png" />
  </Frame>

<h3 id="h_b36bf33918">
  Instructions de configuration
</h3>

Suivez ces étapes pour configurer le déclenchement d'un appel VoiceAgent depuis Zapier :

1. Dans le Zap de votre choix, ajoutez une étape **Action** et choisissez **Webhooks by Zapier.**

2. Choisissez **Custom Request** comme événement d'action.

3. Pour **Méthode**, sélectionnez POST

4. Pour l'endpoint API, utilisez cette **URL** :\
   [`https://api.cloudtalk.io/v1/voice-agent/calls`](https://api.cloudtalk.io/v1/voice-agent/calls)

5. Dans Data, configurez le corps de la requête conformément à la [documentation de l'API](/developers#tag/VoiceAgent)

   * Créez une charge utile JSON au format suivant :

     ```json theme={"system"}
     {
     "call_number": "#{{phone_number}}",
     "voice_agent_id": "#{{voice_agent_id}}",
     "call_properties": {
     "system_prompt": {
     "variables": {
     "contact_name": "#{{name}}"
     }
     },
     "output": {
     "variables": {
     "custom_field": "value"
     }
     }
     }
     }
     ```

   * Remplacez les variables (`#{{...}}`) par les données provenant des étapes précédentes de votre scénario.

   * Dans `call_number`, insérez une référence au numéro de téléphone (e.164) à appeler, extraite des étapes précédentes.

   * Dans `voice_agent_id`, insérez l'ID du VoiceAgent récupéré dans le CloudTalk Dashboard.

   * Si nécessaire, configurez `call_properties`, où :

     1. Les données de `call_properties.system_prompt.variables` contiennent les informations propres à la requête que le VoiceAgent doit utiliser pendant l'appel (par exemple le nom du contact).

     2. Les données de `call_properties.output.variables` définissent les valeurs que le VoiceAgent doit transmettre à l'endpoint externe après l'appel, en plus des informations extraites pendant la conversation.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11831224/bdcbf8b7ba06-image.png?fit=max&auto=format&n=g8s2E4Yk8cWS5656&q=85&s=1ac248ff9179fe93b91e2045d354e3b6" alt="" width="867" height="254" data-path="images/help-center/articles/11831224/bdcbf8b7ba06-image.png" />
   </Frame>

<Warning>
  📘 **Envie d'aller plus loin ?** Découvrez comment les variables System prompt et les variables Output influencent le comportement de votre VoiceAgent dans [cet article dédié](/fr/articles/11401649-voiceagents-for-outbound-calls#h_91064c3683) !
</Warning>

6\. Dans le champ **En-têtes**, ajoutez l'en-tête `"Content-Type": "application/json"`

8\. Configurez la **Basic Authentication** en utilisant votre **API Key ID** comme nom d'utilisateur et votre **API Key Secret** comme mot de passe, tous deux récupérés dans le CloudTalk Dashboard.

9\. Cliquez sur **Continuer** et, si vous souhaitez vérifier la configuration, utilisez **Test Step** pour envoyer un appel de test.

<Note>
  ⚠️ **Attention :** tester l'étape déclenchera un véritable appel VoiceAgent. Assurez-vous que le `call_number` utilisé pendant le test est bien un numéro que vous souhaitez appeler à ce stade.
</Note>

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

<Info>
  **💡 Limites d'API à garder en tête**

  *Pour éviter les échecs ou la limitation du débit, veillez à ce que votre scénario Make gère la distribution des appels avec précaution. Utilisez des délais, des files d'attente 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 à l'endpoint VoiceAgent.*
</Info>

***

*Besoin d'aide ou vous avez 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 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.