Este artículo te mostrará cómo usar las Acciones Personalizadas de Voice AI para habilitar integraciones de webhook en tiempo real durante llamadas en vivo. Esta potente función permite que tus agentes de IA interactúen con sistemas externos en pleno proceso de conversación: extraen datos, ejecutan procesos y mejoran la automatización sin esperar a que termine la llamada.
¿Qué son las Acciones Personalizadas de Voice AI?
Las Acciones Personalizadas de Voice AI permiten que los agentes de IA disparen 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 recogidos en tiempo real de la llamada. Esto permite que los agentes obtengan o envíen información instantáneamente según lo que diga la persona que llama.
Beneficios clave de las Acciones Personalizadas de Voice AI
Las Acciones Personalizadas de Voice AI permiten integraciones fluidas con sistemas externos directamente durante una llamada en vivo. Esto mejora la capacidad del agente de personalizar y resolver problemas más rápido.
Realiza llamadas a APIs en tiempo real activadas por señales de la conversación.
Automatiza la búsqueda o envío de datos durante la llamada.
Por ejemplo: Si un cliente pregunta, “¿Cuál es el estado de mi pedido reciente?”, la IA puede llamar instantáneamente a tu sistema de gestión de pedidos y recuperar el estado en tiempo real, sin poner en espera a la persona que llama.
Configura solicitudes POST con autenticación y encabezados.
Envía dinámicamente datos de la llamada, como números de teléfono o IDs de pedido.
Prueba las respuestas del webhook antes de ponerlo en producción.
Reduce tareas de seguimiento al resolver las necesidades durante la llamada.
Voice AI 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 configurar una lógica más compleja. Los disparadores también pueden filtrarse por condiciones como “ejecutar solo si el parámetro X está presente”.
Ejemplos de disparadores:
Cuando el usuario dice: “Quiero consultar mi cita.”
Cuando se menciona un correo electrónico.
Cuando se pronuncia una cadena de dígitos (por ejemplo, número de pedido).

Acción Personalizada Webhook
La integración por 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—CRM, herramientas de agendamiento, bases de datos y más.
Cada Acción Personalizada se define por 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 (Bearer token, Autenticación Básica, etc.).
Ejemplo: Si estás integrando un CRM como Salesforce, tu URL de webhook podría apuntar a un endpoint como /api/v1/lookupContact e incluir parámetros como el correo electrónico o número telefónico del contacto.

Obtenció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 parámetros usados en la solicitud del webhook. Esto es útil cuando, por ejemplo, la IA necesita extraer tanto un número de pedido como un correo electrónico antes de consultar el estado del envío. Puedes asignar estos valores extraídos al payload de tu webhook, asegurando que la integración sea contextual y personalizada.
Tipos de datos soportados:
Texto (String)
Número (Numérico)
Correo electrónico
Número de teléfono
Fecha

Cómo Configurar Acciones Personalizadas de Voice AI
Las Acciones Personalizadas de Voice AI pueden configurarse desde la interfaz del Agente de Voice AI en solo unos pasos. Aquí te explicamos cómo empezar:
Paso 1: Navega a tu Agente de Voice AI
Navega a Voice AI > Objetivos del Agente > Cambia a Modo Avanzado (Si no está ya habilitado) > Acciones Personalizadas.

Paso 2: Crear Acción Personalizada
Haz clic en + Nueva Acción para abrir la ventana de configuración de acción personalizada.
Paso 3: Configurar Acción Personalizada
Introduce todos los detalles necesarios para la acción personalizada. No todos son obligatorios.
Nombre
Establece las condiciones disparadoras de conversación
Por ejemplo: Si un usuario pregunta, “consultar mi saldo de cuenta”, puedes configurar un disparador con la frase "consultar mi saldo" y definir un parámetro para su número de teléfono para pasar a tu API bancaria.
Agrega tu URL de Webhook y selecciona POST como método.
Agrega cualquier encabezado personalizado según sea necesario.
Ingresa los datos de autenticación requeridos (por ejemplo, Bearer token).
Define los parámetros extraídos dinámicamente de la conversación.
Utiliza la función de Probar Webhook para validar la configuración.


Voice AI - Pruebas en Tiempo Real
Antes de guardar una Acción Personalizada, puedes usar la herramienta integrada de Probar Webhook. Esto te permite simular un escenario de llamada, enviar datos de prueba y ver la respuesta de tu sistema externo en tiempo real. Puedes usar la herramienta de prueba para simular que un cliente solicita “reprogramar una cita” y comprobar si el webhook extrae y envía correctamente la fecha y hora proporcionadas a tu sistema de calendario.
Podrás:
Ver la solicitud completa (encabezados + cuerpo).
Ver la respuesta cruda (200 OK, 404 No Encontrado, etc.). Por ejemplo, si la respuesta de tu webhook incluye una fecha estimada de entrega, tu agente de IA puede informar inmediatamente al interlocutor: “Su paquete llegará el jueves.”
Identificar y corregir configuraciones erróneas antes de guardar.

Preguntas Frecuentes
P: ¿Puedo utilizar GET u otros tipos de solicitudes?
No, actualmente solo se admiten solicitudes POST para las Acciones Personalizadas.
P: ¿Dónde accedo a las Acciones Personalizadas de Voice AI?
Puedes acceder a ellas en Voice AI > Objetivos del Agente > Cambia a Modo Avanzado (si no está ya habilitado) > Acciones Personalizadas.
P: ¿Se admite autenticación en los webhooks?
Sí, puedes usar tokens Bearer, Autenticación Básica o pasar claves en los encabezados.
P: ¿Qué ocurre si mi webhook falla durante la llamada?
El sistema registra el fallo y se puede definir un comportamiento alternativo si no se devuelve ningún dato o si el webhook excede el tiempo de espera.
P: ¿Puedo activar múltiples webhooks en una sola llamada?
Sí. Cada Acción Personalizada puede activarse de forma independiente según sus condiciones propias.
P: ¿Necesito un desarrollador para configurar estas acciones?
No necesariamente. Mientras tengas acceso a la documentación del API del sistema externo, puedes configurar esto con habilidades técnicas mínimas.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.