Déclencher un appel VoiceAgent depuis Make

• Admin

​

Les VoiceAgents CloudTalk dans Make

​

Prérequis

• Identifiants de l’API CloudTalk
  • Accédez à CloudTalk Dashboard → Compte → Paramètres → Clés API
  • Copiez l’API Key ID et l’API Key Secret
• ID du VoiceAgent
  • L’ID du VoiceAgent peut être récupéré dans CloudTalk Dashboard > VoiceAgents
    

​

Instructions de configuration

1. Dans votre scénario Make, ajoutez un module et sélectionnez l’application HTTP Request .
2. Sélectionnez l’action Make a basic auth request.
3. Configurez l’authentification
   • Cliquez sur Ajouter pour créer de nouveaux identifiants.
   • Utilisez votre API Key ID comme nom d’utilisateur.
   • Utilisez votre API Key Secret comme mot de passe.
   • Donnez un nom à la connexion, puis cliquez sur Créer.
4. Pour l’endpoint de l’API, utilisez cette URL :
   https://api.cloudtalk.io/v1/voice-agent/calls
5. Pour Méthode, sélectionnez POST
6. Configurez le format de la requête
   • Body type : Raw
   • Content type : application/json
7. Construisez le Request content en suivant 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 issues 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, extrait des étapes précédentes.
   • Dans voice_agent_id, insérez l’ID du VoiceAgent obtenu 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.