Déclencher un appel VoiceAgent depuis Zapier

• Admin

​

Les VoiceAgents CloudTalk dans Zapier

​

Prérequis

• 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
  

​

Instructions de configuration

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
5. Dans Data, configurez le corps de la requête conformément à la documentation de l’API
   • Créez une charge utile JSON au format suivant :
     {
     "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.