Skip to main content
En esta guía aprenderás a activar automáticamente una llamada de un VoiceAgent de CloudTalk desde Freshdesk mediante reglas de automatización. La acción Trigger Webhook te da control total sobre el método HTTP, la URL, las cabeceras y el cuerpo, de modo que las llamadas se pueden iniciar directamente desde los eventos de los tickets.
Nivel de usuario: Administrador

​
Antes de empezar

Necesitarás:
  • Un VoiceAgent de CloudTalk ya creado (anota el ID del VoiceAgent)
  • Las credenciales de la API de CloudTalk (Clave de API y Secret) que encontrarás en Configuración de la empresa > Integraciones > API (Cómo acceder a tus claves de API de CloudTalk y generarlas)
  • Un plan Pro de Freshdesk o superior
  • Un número de teléfono disponible en los registros de contacto

​
Genera la cabecera Authorization

CloudTalk utiliza autenticación básica para las solicitudes a la API.
  1. Abre https://www.debugbear.com/basic-auth-header-generator
  2. Introduce tu Clave de API de CloudTalk como Username y tu Secret de API como Password
  3. Copia el valor generado. Tiene este aspecto: Basic XXXXXXXXX
Nota: Freshdesk también acepta una combinación normal de usuario y contraseña en la configuración del webhook, así que la cabecera codificada en Base64 es opcional. Las dos opciones funcionan.

​
Configura la integración

​
Crea la regla de automatización

1. En Freshdesk, ve a Admin > Automation > Ticket Creation (o On Ticket Update, según cuándo quieras que se activen las llamadas)
2. Haz clic en Start from scratch 3. Define tus conditions, por ejemplo:
  • Ticket is created
  • Contact phone is present
  • Tag contains voiceagent
4. En Actions, haz clic en Add action > Trigger Webhook 5. Configura el webhook:
6. En Custom Headers, añade:
  • Authorization > Basic XXXXXXXXX
  • Content-Type > application/json
7. En Content (Advanced), pega el siguiente cuerpo:
call_number y voice_agent_id son los únicos campos obligatorios. También puedes enviar call_properties opcionales, como variables del prompt del sistema y variables de salida, según la configuración de tu VoiceAgent. Descubre qué incluir
8. Haz clic en Preview and save y después activa la regla.

​
Prueba y comprueba

  1. Crea o actualiza un ticket que cumpla las condiciones de tu activador
  2. Ve a Admin > Automation y revisa el registro de ejecución de la regla
  3. Comprueba en CloudTalk que la llamada del VoiceAgent se ha iniciado
¡Todo listo! 🚀 Tu regla de automatización de Freshdesk activará ahora una llamada de un VoiceAgent de CloudTalk cada vez que un ticket 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 de Freshdesk gestiona con cuidado la distribución de las llamadas. Usa retrasos o lógica de programación cuando sea necesario, ya que el límite estándar de la API (60 solicitudes por minuto) se aplica también al endpoint del VoiceAgent.

​
Resolución de problemas

¿Necesitas ayuda o tienes alguna pregunta? Escríbenos a través de nuestro Portal de atención al cliente. Estamos aquí para ayudarte.