Cómo activar una llamada de VoiceAgent desde Make

• Admin

​

VoiceAgents de CloudTalk en Make

​

Requisitos previos

• Las credenciales de la API de CloudTalk
  • Ve a Dashboard de CloudTalk → Cuenta → Configuración → Claves de API
  • Copia tanto el API Key ID como el API Key Secret
• El ID del VoiceAgent
  • El ID del VoiceAgent se puede obtener en Dashboard > VoiceAgents de CloudTalk
    

​

Instrucciones de configuración

1. En tu escenario de Make, añade un módulo y selecciona la app HTTP Request .
2. Selecciona la acción Make a basic auth request.
3. Configura la autenticación
   • Haz clic en Añadir para crear nuevas credenciales.
   • Usa tu API Key ID como Username.
   • Usa tu API Key Secret como Password.
   • Ponle un nombre a la conexión y haz clic en Crear.
4. Como endpoint de la API, usa esta URL:
   https://api.cloudtalk.io/v1/voice-agent/calls
5. En Método, selecciona POST
6. Configura el formato de la solicitud
   • Body type: Raw
   • Content type: application/json
7. Crea el Request content siguiendo la documentación de la API
   • Crea un payload JSON con el siguiente formato:
     {
       "call_number": "#{{phone_number}}",
       "voice_agent_id": "#{{voice_agent_id}}",
       "call_properties": {
         "system_prompt": {
           "variables": {
             "contact_name": "#{{name}}"
           }
         },
         "output": {
           "variables": {
             "custom_field": "value"
           }
         }
       }
     }
     
   • Sustituye las variables (#{{...}}) por datos de pasos anteriores de tu escenario.
   • En call_number, inserta una referencia al número de teléfono (e.164) al que se debe llamar, extraído de pasos anteriores.
   • En voice_agent_id, inserta el ID del VoiceAgent obtenido en el Dashboard de CloudTalk.
   • Si es necesario, configura call_properties, donde:
     1. Los datos de call_properties.system_prompt.variables incluyen información específica de la solicitud que el VoiceAgent debe usar durante la llamada (por ejemplo, el nombre del contacto).
     2. Los datos de call_properties.output.variables definen los valores que el VoiceAgent debe enviar al endpoint externo después de la llamada, además de la información extraída durante la conversación.