Skip to main content
En esta guía aprenderás a activar automáticamente una llamada de VoiceAgent de CloudTalk desde Pipedrive mediante la función Automations.
Nivel de usuario: Admin

​
Antes de empezar

Necesitarás:
  • Un VoiceAgent de CloudTalk ya creado (anota el ID del VoiceAgent)
  • Credenciales de la API de CloudTalk (API Key ID y API Key Secret)
  • Plan Advanced o superior de Pipedrive (las Automations con acciones de webhook requieren Advanced+)
  • Un número de teléfono disponible en los registros de Person o Deal

​
Configurar la integración

​
Crear el webhook de Automation

Nota: solo los usuarios con permisos de administrador global pueden crear webhooks. Los webhooks normales que ya existen no se pueden reutilizar para las Automations, así que tienes que crear un Automation webhook específico.
1. En Pipedrive, haz clic en tu icono de perfil y selecciona Tools and Apps
2. Haz clic en + Webhook y selecciona Automation webhook
3. Configura el webhook:
  • Name: CloudTalk VoiceAgent
  • Endpoint URL: https://api.cloudtalk.io/v1/voice-agent/calls?
  • Authentication, Username: tu API Key ID de CloudTalk
  • Authentication, Password: tu API Key Secret de CloudTalk
¿Por qué la URL termina con ?? Pipedrive exige que las URL de los Automation webhooks terminen en /, &, ? o =. El ? es el único que acepta la API de CloudTalk. Abre una cadena de consulta vacía que CloudTalk ignora, por lo que la llamada sigue llegando al endpoint correcto. Los demás caracteres se interpretan como parte de la ruta de la URL, lo que rompe la solicitud.
4. Haz clic en Save

​
Crear la automatización

1. Ve a Tools and Apps > Automations 2. Haz clic en + Automation 3. Selecciona un activador, por ejemplo:
  • Deal stage changed
  • Person created or updated
  • Activity completed
4. Añade las condiciones que necesites (por ejemplo, que solo se ejecute para una etapa concreta del pipeline) 5. Haz clic en + Add action y selecciona Webhook

​
Configurar la acción Webhook

1. En el campo Webhook, selecciona CloudTalk VoiceAgent (el webhook que creaste en el paso 1) 2. Establece Method en POST 3. En la sección Body, cambia a Raw e introduce:
Para call_number, usa el botón selector de campos y elige Person > Phones. Introduce tu ID de VoiceAgent como valor de voice_agent_id.
call_number y voice_agent_id son los únicos campos obligatorios. También puedes enviar call_properties opcionales, como variables del system prompt y variables de salida, según la configuración de tu VoiceAgent. Descubre qué puedes incluirAsegúrate de que el número de teléfono esté guardado en formato E.164 (+1234567890); de lo contrario, CloudTalk rechazará la solicitud.
Contactos con varios números de teléfono: el campo Phones de Person en Pipedrive puede contener varios números. Cuando un contacto tiene más de uno, el campo envía todos a CloudTalk en lugar de un único número, lo que invalida la solicitud y hace que la llamada falle. Solución alternativa: crea un campo personalizado de teléfono específico con un solo valor (Settings > Data fields > Person), guarda en él solo el número al que se debe llamar en formato E.164 y asigna ese campo a call_number.

​
Activar y probar

  1. Guarda y activa la automatización
  2. Activa manualmente la condición con un registro de prueba (por ejemplo, mueve un deal a la etapa de destino)
  3. Ve a Automations > History y comprueba que la acción se ejecutó con el estado SUCCESS
  4. Verifica en CloudTalk que se inició la llamada del VoiceAgent
¡Ya está todo listo! 🚀 A partir de ahora, tu automatización de Pipedrive activará una llamada de VoiceAgent de CloudTalk cada vez que un registro cumpla las condiciones que hayas elegido.
💡 Límites de la API que debes tener en cuentaPara evitar fallos o limitaciones, asegúrate de que tu automatización distribuya las llamadas con cuidado. Usa retrasos o lógica de programación cuando haga falta, ya que el límite estándar de la API (60 solicitudes por minuto) se aplica al endpoint del VoiceAgent.

​
Solución de problemas

Si la llamada del VoiceAgent no se inició:
  1. Ve a Automations > History
  2. Selecciona el filtro Failed
  3. Abre la ejecución fallida para ver qué paso falló
¿Necesitas ayuda o tienes alguna pregunta? Escríbenos a través de nuestro Portal de atención al cliente. Estamos aquí para ayudarte.