Tabla de contenido
- ¿Qué son las acciones personalizadas de Voice AI?
- Beneficios clave de las acciones personalizadas
- Cómo configurar acciones personalizadas en Voice AI
- Integración con Webhook
- Disparadores de conversación
- Recolección dinámica de parámetros
- Pruebas en tiempo real
- Preguntas frecuentes
¿Qué son las acciones personalizadas de Voice AI?
Las acciones personalizadas de Voice AI permiten que los agentes de IA activen llamadas webhook POST personalizadas a APIs externas durante una conversación en vivo. Estas acciones pueden incluir autenticación, encabezados y parámetros dinámicos recopilados en tiempo real desde la llamada. Esto permite que los agentes recuperen o envíen información instantáneamente según lo que diga el interlocutor.
Beneficios clave de las acciones personalizadas
Las acciones personalizadas de Voice AI permiten integraciones sin interrupciones con sistemas externos directamente dentro de una llamada en vivo. Esto mejora la capacidad del agente para personalizar y resolver situaciones rápidamente.
• Realiza llamadas a APIs en tiempo real activadas por frases de la conversación.
• Automatiza consultas o envíos de datos durante la llamada. Por ejemplo, si un cliente pregunta: “¿Cuál es el estado de mi pedido reciente?”, la IA puede consultar instantáneamente tu sistema de pedidos y entregar la respuesta en tiempo real, sin poner al cliente en espera.
• Configura solicitudes POST con autenticación y encabezados.
• Transmite dinámicamente datos de la llamada (como número de teléfono o ID de pedido).
• Prueba las respuestas del webhook antes de activarlo en vivo.
• Reduce tareas de seguimiento resolviendo necesidades durante la llamada.
Cómo configurar acciones personalizadas en Voice AI
Las acciones personalizadas de Voice AI se configuran desde la interfaz de Voice AI Labs con unos pocos pasos.
- Navega a Labs > Voice AI > Custom Actions.
- Haz Click en Create Action para abrir la ventana de configuración.
- Ingresa un nombre y descripción para la acción.
- Añade tu URL de Webhook y selecciona POST como método.
- Ingresa cualquier detalle de autenticación necesario (por ejemplo, token Bearer).
- Agrega encabezados personalizados si es necesario.
- Define parámetros obtenidos dinámicamente desde la conversación.
- Establece condiciones de activación según frases clave. Por ejemplo: si el asistente de IA debe recuperar el saldo después de que el usuario diga “consultar mi saldo”, define ese disparador y un parámetro para enviar su número al API del banco.
- Usa la función Test Webhook para validar la configuración.
- Haz Click en Save para activar la acción personalizada.
Integración con Webhook
La integración con webhook es el núcleo de las acciones personalizadas de Voice AI. Permite que tus agentes interactúen con cualquier sistema externo que soporte APIs — como CRMs, herramientas de agendamiento, bases de datos y más.
Cada acción personalizada se define mediante una solicitud POST, que puede incluir:
• Una URL de endpoint de webhook
• Encabezados (por ejemplo, claves API, tokens)
• Un cuerpo de solicitud con parámetros dinámicos
• Autenticación (token Bearer, autenticación básica, etc.)
Ejemplo: Si estás integrando con un CRM como Salesforce, tu URL de webhook podría apuntar a /api/v1/lookupContact e incluir parámetros como el correo electrónico o número de teléfono del contacto.
Disparadores de conversación
Los disparadores definen las condiciones bajo las cuales se ejecuta una acción personalizada durante la llamada. Puedes crear disparadores simples basados en frases o lógica más avanzada.
Ejemplos de disparadores:
• Cuando el usuario dice: “Quiero revisar mi cita.”
• Cuando se menciona un correo electrónico.
• Cuando se dice una cadena de dígitos (por ejemplo, número de pedido).
También puedes agregar condiciones como “solo ejecutar si el parámetro X está presente”.
Recolección dinámica de parámetros
Voice AI puede extraer y etiquetar datos relevantes en tiempo real durante las conversaciones. Estos valores se asignan automáticamente a los parámetros que se usan en la solicitud webhook.
Esto es útil, por ejemplo, si la IA necesita obtener un número de pedido y una dirección de correo electrónico antes de consultar el estado de envío. Puedes asignar esos valores extraídos a tu payload para que la integración esté personalizada y contextualizada.
Tipos de datos compatibles:
• Texto (String)
• Número (Numeric)
• Correo electrónico
• Número de teléfono
• Fecha (próximamente)
Puedes asignar estos valores a cualquier parte del cuerpo de tu webhook para personalizar la integración.
Pruebas en tiempo real
Antes de guardar una acción personalizada, puedes usar la herramienta incorporada Test Webhook. Esto te permite simular un escenario de llamada, enviar datos de prueba y ver la respuesta del sistema externo en tiempo real.
Puedes usar esta herramienta de prueba para simular que un cliente pide “reprogramar una cita” y verificar si el webhook transmite correctamente la fecha y hora al sistema de calendario.
Podrás:
• Ver la solicitud completa (encabezados + cuerpo)
• Ver la respuesta sin procesar (200 OK, 404 Not Found, etc.)
• Por ejemplo: si tu webhook devuelve una fecha estimada de entrega, tu agente de IA puede decirle al cliente: “Tu paquete llegará el jueves.”
• Identificar y corregir errores de configuración antes de guardar.
Preguntas frecuentes
P: ¿Puedo usar GET u otros tipos de solicitud?
R: No, actualmente solo se admiten solicitudes POST para las acciones personalizadas.
P: ¿Dónde accedo a las acciones personalizadas de Voice AI?
R: Puedes acceder desde Labs > Voice AI > Custom Actions, una vez que Labs esté habilitado en tu cuenta.
P: ¿Se admite autenticación en los webhooks?
R: Sí, puedes usar tokens Bearer, autenticación básica o pasar claves en los encabezados.
P: ¿Qué sucede si el webhook falla durante la llamada?
R: El sistema registra el fallo y puede configurarse un comportamiento alternativo si no se recibe respuesta o si hay un timeout.
P: ¿Puedo activar múltiples webhooks en una sola llamada?
R: Sí. Cada acción personalizada se activa de forma independiente según sus propias condiciones.
P: ¿Necesito un desarrollador para configurar estas acciones?
R: No necesariamente. Siempre que tengas acceso a la documentación del API externo, puedes configurarlo con habilidades técnicas básicas.