Activar una llamada de VoiceAgent desde Zapier

• Admin

​

VoiceAgents de CloudTalk en Zapier

​

Requisitos previos

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

​

Instrucciones de configuración

1. En el Zap que prefieras, añade un paso de Acción y elige Webhooks by Zapier.
2. Elige Custom Request como evento de acción.
3. En Método, selecciona POST
4. Para el endpoint de la API, usa esta URL:
   https://api.cloudtalk.io/v1/voice-agent/calls
5. En Data, configura el cuerpo de la solicitud según 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 va a llamar, extraída de pasos anteriores.
   • En voice_agent_id, inserta el ID del VoiceAgent que has obtenido en el CloudTalk Dashboard.
   • 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.