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

> Automatisez les appels sortants des VoiceAgents directement depuis Pipedrive

<Note>
  Dans ce guide, vous apprendrez à déclencher automatiquement un appel VoiceAgent CloudTalk depuis Pipedrive à l'aide de la fonctionnalité Automations.
</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)

* [Vos identifiants API CloudTalk](/fr/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys) (ID de clé API et Secret de clé API)

* Pipedrive avec un **plan Advanced ou supérieur** (les Automations avec actions webhook nécessitent Advanced+)

* Un numéro de téléphone disponible sur les enregistrements Person ou Deal

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

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

<Warning>
  **Remarque :** seuls les utilisateurs disposant du rôle d'admin global peuvent créer des webhooks. Les webhooks classiques existants ne peuvent pas être réutilisés pour les Automations : vous devez donc créer spécifiquement un webhook Automation.
</Warning>

1\. Dans Pipedrive, cliquez sur votre **icône de profil** et sélectionnez **Tools and Apps**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/f77734ddee37-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=65a9148ee4495fd80f7df964fc8a1ee3" alt="" width="400" data-path="images/help-center/articles/15516233/f77734ddee37-image.png" />
</Frame>

2\. Cliquez sur **+ Webhook** et sélectionnez **Automation webhook**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/de07daf9d028-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=6b00478bb7e454e661af55d75e14c5cd" alt="" width="2769" height="1500" data-path="images/help-center/articles/15516233/de07daf9d028-image.png" />
</Frame>

3\. Configurez le webhook :

* **Name :** `CloudTalk VoiceAgent`

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

* **Authentication, Username :** votre ID de clé API CloudTalk

* **Authentication, Password :** votre Secret de clé API CloudTalk

<Warning>
  **Pourquoi l'URL se termine-t-elle par `?` ?** Pipedrive exige que les URL des webhooks Automation se terminent par `/`, `&`, `?` ou `=`. Le `?` est le seul caractère accepté par l'API CloudTalk. Il ouvre une chaîne de requête vide que CloudTalk ignore : l'appel atteint donc bien le bon endpoint. Les autres caractères sont interprétés comme faisant partie du chemin de l'URL, ce qui casse la requête.
</Warning>

4\. Cliquez sur **Save**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/c4e587c5bf00-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=6f104177314f9b1b6c5306bf545352e2" alt="" width="2270" height="1030" data-path="images/help-center/articles/15516233/c4e587c5bf00-image.png" />
</Frame>

<h3 id="h_step2">
  Créer l'Automation
</h3>

1\. Accédez à **Tools and Apps > Automations**

2\. Cliquez sur **+ Automation**

3\. Sélectionnez un **déclencheur**, par exemple :

* *Deal stage changed*

* *Person created or updated*

* *Activity completed*

4\. Ajoutez les **conditions** nécessaires (par exemple, une exécution réservée à une étape de pipeline précise)

5\. Cliquez sur **+ Add action** et sélectionnez **Webhook**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/c37747817114-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=550eb243ab60d8ef6297f3064d4c0312" alt="" width="1928" height="1290" data-path="images/help-center/articles/15516233/c37747817114-image.png" />
</Frame>

<h3 id="h_step3">
  Configurer l'action Webhook
</h3>

1\. Dans le champ **Webhook**, sélectionnez `CloudTalk VoiceAgent` (le webhook créé à l'étape 1)

2\. Définissez **Method** sur `POST`

3\. Dans la section **Body**, passez en mode **Raw** et saisissez :

```json theme={"system"}
{  "call_number": "",  "voice_agent_id": "YOUR_VOICE_AGENT_ID"}
```

Pour `call_number`, utilisez le bouton de sélection de champ pour choisir **Person > Phones**. Saisissez l'ID de votre VoiceAgent comme valeur de `voice_agent_id`.

<Warning>
  `call_number` et `voice_agent_id` sont les seuls champs obligatoires. Vous pouvez également transmettre des `call_properties` facultatives, 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)

  Assurez-vous que le numéro de téléphone est enregistré au **format E.164** (`+1234567890`), sinon CloudTalk rejettera la requête.
</Warning>

<Warning>
  **Contacts ayant plusieurs numéros de téléphone :** le champ Person Phones de Pipedrive peut contenir plusieurs numéros. Lorsqu'un contact en possède plusieurs, le champ les transmet tous à CloudTalk au lieu d'un seul numéro, ce qui rend la requête invalide et fait échouer l'appel. **Solution de contournement :** créez un champ personnalisé de type téléphone à valeur unique (**Settings > Data fields > Person**), enregistrez-y uniquement le numéro à composer au format E.164, puis associez plutôt ce champ à `call_number`.
</Warning>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/0c71cf9fcd8d-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=93c6028b4bdd3d9b29eb40fc62e07ef9" alt="" width="400" data-path="images/help-center/articles/15516233/0c71cf9fcd8d-image.png" />
</Frame>

<h3 id="h_step4">
  Activer et tester
</h3>

1. Enregistrez et **activez** l'automation

2. Déclenchez manuellement la condition à l'aide d'un enregistrement de test (par exemple, déplacez un deal vers l'étape ciblée)

3. Accédez à **Automations > History** et vérifiez que l'action s'est exécutée avec le statut **SUCCESS**

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

**Tout est prêt !** 🚀 Votre automation Pipedrive déclenchera désormais un appel VoiceAgent CloudTalk dès qu'un enregistrement remplira les conditions que vous avez définies.

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

  *Pour éviter les échecs ou la limitation du débit, veillez à ce que votre automation gère soigneusement la répartition des appels. 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 à l'endpoint VoiceAgent.*
</Info>

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

Si l'appel du VoiceAgent n'a pas été lancé :

1. Accédez à **Automations > History**

2. Sélectionnez le filtre **Failed**

3. Ouvrez l'exécution en échec pour voir quelle étape a échoué

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/b8eaaf2d1470-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=3f4076863ebb895c14f29b28d4953528" alt="" width="2410" height="626" data-path="images/help-center/articles/15516233/b8eaaf2d1470-image.png" />
</Frame>

| **Erreur** | **À vérifier** |
| - | - |
| **Authentification** | L'ID ou le Secret de clé API CloudTalk indiqué dans le webhook est incorrect. Régénérez-les et saisissez-les à nouveau. |
| **Numéro de téléphone** | Le numéro n'est pas au format E.164, ou le contact possède plusieurs numéros de téléphone (voir la remarque de l'étape 3 ci-dessus) |
| **ID de VoiceAgent incorrect** | Vérifiez que le `voice_agent_id` indiqué dans le corps du webhook est correct |

***

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 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 Zendesk](/fr/articles/15934846-triggering-a-voiceagent-call-from-zendesk.md)


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