Skip to main content
Dans ce guide, vous apprendrez à déclencher automatiquement un appel VoiceAgent CloudTalk depuis Pipedrive à l’aide de la fonctionnalité Automations.
Niveau d’utilisateur : Admin

​
Avant de commencer

Vous aurez besoin de :
  • Un VoiceAgent CloudTalk déjà créé (notez l’ID du VoiceAgent)
  • Vos identifiants API CloudTalk (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

​
Configurer l’intégration

​
Créer le webhook Automation

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.
1. Dans Pipedrive, cliquez sur votre icône de profil et sélectionnez Tools and Apps
2. Cliquez sur + Webhook et sélectionnez Automation webhook
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
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.
4. Cliquez sur Save

​
Créer l’Automation

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

​
Configurer l’action Webhook

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 :
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.
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 inclureAssurez-vous que le numéro de téléphone est enregistré au format E.164 (+1234567890), sinon CloudTalk rejettera la requête.
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.

​
Activer et tester

  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.
💡 Limites d’API à garder à l’espritPour é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.

​
Dépannage

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é
Besoin d’aide ou une question ? Contactez-nous via notre Portail Support. Nous sommes là pour vous.