Documentación en Desarrollo

Esta guía está actualmente en desarrollo. El contenido puede estar incompleto o sujeto a cambios.

~15 minutos

Acciones de Voz

Configura acciones que la IA puede tomar durante llamadas de voz. Habilita transferencias, consultas de API, autenticacion y mensajeria cross-channel.

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

1

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.

2

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.

3

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:

  1. Abre el paso LlamadaVoz en el editor de flujo
  2. Navega a la pestana Acciones
  3. Haz clic en "Agregar Accion"
  4. Selecciona el tipo de accion
  5. Configura el nombre de funcion y descripcion
  6. Define parametros (que info debe recopilar la IA)
  7. 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

  1. Selecciona la integracion de API a usar
  2. Elige el endpoint
  3. Mapea parametros del contexto de llamada a parametros de API
  4. Define que campos de respuesta extraer
  5. 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:

RUT/Numero ID
Nombre Completo
Fecha de Nacimiento
Ultimos 4 digitos del telefono
Numero de Cuenta
Campo personalizado

Tipos de Coincidencia

ExactoLos valores deben coincidir exactamente
DifusoPermitir variaciones menores (errores de tipeo, formato)
ParcialCoincidir subcadena o valor parcial

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

SiempreEnviar mensaje de WhatsApp independientemente del resultado de la accion
En ExitoSolo enviar si la accion se completo exitosamente
En FalloSolo enviar si la accion fallo

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