Documentación en Desarrollo
Esta guía está actualmente en desarrollo. El contenido puede estar incompleto o sujeto a cambios.
Acciones de Voz
Configura acciones que la IA puede tomar durante llamadas de voz. Habilita transferencias, consultas de API, autenticacion y mensajeria cross-channel.
En esta guia
Que son las Acciones de Voz?
Las Acciones de Voz son herramientas disponibles para la IA durante las llamadas de voz. Permiten a la IA realizar tareas especificas basadas en el contexto de la conversación - como transferir llamadas, consultar datos o autenticar llamantes.
Como Funcionan las Acciones
Las acciones se definen como funciones
Cada accion se expone a la IA como una funcion llamable con parametros usando el formato de llamada de funciones de OpenAI.
La IA decide cuando usar acciones
Basandose en el contexto de la conversación y las descripciones de acciones, la IA determina cuando es apropiado llamar una accion.
Los resultados informan la conversación
Los resultados de las acciones se devuelven a la IA, que los usa para continuar la conversación apropiadamente.
Tipos de Acciones
Tipos de acciones de voz disponibles y sus casos de uso:
Transferir
Transferir la llamada a una cola, agente o numero externo.
Colgar
Finalizar la llamada de forma elegante despues de completar el objetivo.
LlamadaApi
Consultar una API externa durante la llamada para datos en tiempo real.
EnviarWhatsApp
Enviar un mensaje de WhatsApp al llamante durante o despues de la llamada.
ConsultaBaseDatos
Consultar la base de datos de la campana para informacion del cliente.
Autenticar
Validar identidad del llamante contra registros de la base de datos.
ObtenerDatosCliente
Obtener info del cliente con acceso controlado (requiere autenticacion primero).
EstablecerVariable
Almacenar datos en contexto de llamada para uso posterior o enriquecimiento.
Lista de acciones en configuracion de VoiceBot
Captura de pantalla proximamente
Creando Acciones Personalizadas
Configura acciones en el paso LlamadaVoz dentro de tu flujo.
Pasos:
- Abre el paso LlamadaVoz en el editor de flujo
- Navega a la pestana Acciones
- Haz clic en "Agregar Accion"
- Selecciona el tipo de accion
- Configura el nombre de funcion y descripcion
- Define parametros (que info debe recopilar la IA)
- Configura el comportamiento post-accion
Formulario de crear nueva accion
Captura de pantalla proximamente
Definicion de Funcion
Cada accion se convierte en una funcion que la IA puede llamar. La descripcion ayuda a la IA a entender cuando usarla:
{
"name": "transferir_a_ventas",
"description": "Transferir la llamada al equipo de ventas cuando el cliente quiere hacer una compra o tiene preguntas sobre precios",
"parameters": {
"type": "object",
"properties": {
"motivo": {
"type": "string",
"description": "Breve motivo de la transferencia"
}
},
"required": ["motivo"]
}
}Vista previa de definicion de funcion
Captura de pantalla proximamente
Configuracion de Accion de Transferencia
Configura como se transfieren las llamadas a agentes o numeros externos.
Configuracion de accion de transferencia
Captura de pantalla proximamente
Tipos de Destino
Extension
Transferir a un agente especifico por numero de extension.
Cola
Transferir a una cola de llamadas (ej., "ventas", "soporte"). El siguiente agente disponible en la cola recibira la llamada.
Externo
Transferir a un numero de telefono externo. Util para callbacks de especialistas o socios externos.
SIP
Transferir a una direccion SIP para integracion con sistemas VoIP externos.
Mapeo de Destinos
Mapea nombres amigables a destinos reales:
Mapeo de Destinos: - "ventas" → cola:equipo_ventas - "soporte" → cola:soporte_tecnico - "facturacion" → cola:dept_facturacion - "supervisor" → ext:1001
Anuncio de Transferencia
Configura lo que la IA dice antes de transferir:
Ejemplo: "Lo transferire a nuestro equipo de ventas ahora. Por favor espere un momento."
Configuracion de Accion de Llamada API
Realiza llamadas API en tiempo real durante conversaciones de voz para obtener o actúalizar datos.
Configuracion de accion de llamada API
Captura de pantalla proximamente
Pasos de Configuracion
- Selecciona la integracion de API a usar
- Elige el endpoint
- Mapea parametros del contexto de llamada a parametros de API
- Define que campos de respuesta extraer
- Configura la plantilla de habla para que la IA lea los resultados
Plantilla de Respuesta
Define como la IA debe comunicar los resultados de la API:
// Plantilla para consulta de saldo de cuenta
"Su saldo actúal es {{response.balance}} pesos.
Su ultimo pago fue el {{response.last_payment_date}}
por {{response.last_payment_amount}} pesos."Configuracion de plantilla de respuesta
Captura de pantalla proximamente
Acciones de Autenticacion
Valida la identidad del llamante antes de proporcionar informacion sensible o tomar acciones.
Campos de accion de autenticacion
Captura de pantalla proximamente
Metodos de Validacion
Validacion contra Base de Datos
Coincidir informacion proporcionada por el llamante contra registros de la base de datos de la campana.
Campos Requeridos
Configura que campos debe recopilar y validar la IA:
Tipos de Coincidencia
Verificacion Multi-Paso
Para operaciones sensibles, requiere multiples campos de verificacion:
Paso 1: Recopilar y verificar RUT Paso 2: Recopilar y verificar fecha de nacimiento Paso 3: Si ambos coinciden, autenticacion exitosa
Consejo de Seguridad: Configura un numero maximo de intentos de autenticacion. Despues de excederse, transferir a un agente humano o finalizar la llamada.
Acciones Cross-Channel
Dispara mensajes de WhatsApp durante o despues de llamadas de voz para comunicacion de seguimiento.
Configuracion de disparador cross-channel
Captura de pantalla proximamente
Condiciones de Disparo
Configuracion de Plantilla
Selecciona una plantilla de WhatsApp y configura variables del contexto de llamada:
Plantilla: confirmacion_cita
Variables:
- {{1}}: {{nombre_cliente}}
- {{2}}: {{fecha_cita}}
- {{3}}: {{hora_cita}}Resultados y Captura de Acciones
Captura datos de las acciones para usar en la conversación de IA y enriquecer datasets.
Capturando Datos
Configura que campos de los resultados de acciones guardar:
- Campos de respuesta de API
- Resultados de consulta de base de datos
- Estado de autenticacion
- Resultado de transferencia
Usando Datos Capturados
Los datos capturados estan disponibles para la IA durante el resto de la conversación:
// Despues de llamada API capturando saldo
IA: "Veo que su saldo actúal es $150,000.
Le gustaria hacer un pago hoy?"
// La IA tiene acceso a los datos capturados:
// - balance: 150000
// - last_payment_date: "2024-01-15"
// - account_status: "active"Historial de Ejecucion
Todas las ejecuciones de acciones se registran con:
- Marca de tiempo
- Parametros proporcionados por la IA
- Resultado/respuesta
- Duracion
- Estado de exito/fallo