Agentes de voz
Configura agentes de voz con números de teléfono (Twilio) y voces de OpenAI, ElevenLabs o Deepgram.
Objetivo
Configurar agentes de voz con números telefónicos (Twilio) y analizar llamadas.
Acceso
Sidebar -> Voice Agents Ruta: /app/{tenant}/voice-agents
Roles
- owner, admin, agent
Requisitos previos
- Integrations: Twilio conectado.
- Agents: un agent base con canal Voice habilitado y modelo compatible realtime.
- Integrations: OpenAI para analytics (transcription/summary/sentiment).
- Integrations: ElevenLabs si quieres voz TTS externa.
Crear un Voice Agent
En Agentes de voz, pulsa Crear agente de voz.
El modal tiene 4 pasos (Agente base, Configuración de voz, Comportamiento y analítica, Número de teléfono):
Paso 1: Select Base Agent
Campos:
| Campo | Obligatorio | Formato | Ejemplo | Nota |
|---|---|---|---|---|
| Base Agent | Sí | selección | Support Agent | Debe tener Voice habilitado |
Paso 2: Voice Configuration
Campos:
| Campo | Obligatorio | Formato | Ejemplo | Nota |
|---|---|---|---|---|
| Voice Provider | Sí | OpenAI, ElevenLabs o Deepgram | OpenAI | ElevenLabs/Deepgram requieren su propia key |
| Primary Language | Sí | código idioma | es | Afecta pronunciación |
| Initial Greeting | No | texto | Hola, en que puedo ayudarte | Se reproduce al iniciar |
| Voice (OpenAI) | Sí | selección | alloy | Algunas voces no tienen preview |
| Voice ID (ElevenLabs) | Sí | texto | UOIqAnmS... | Desde ElevenLabs |
Call Analytics (si OpenAI conectado):
- Transcription (enable)
- AI Summary (enable)
- Sentiment Analysis (enable)
- Call Recording (enable, requiere Twilio)
Call Termination:
- Enable End Call (ON/OFF)
- End Call Prompt (texto largo)
- Inactivity Timeout (segundos, 5-60)
Paso 3: Phone Number (Twilio)
Opciones:
- Guardar Twilio SID/Auth Token si no está conectado.
- Selecciona un número de Twilio existente (dropdown).
- Phone Number manual (formato +E.164).
Campos:
| Campo | Obligatorio | Formato | Ejemplo | Nota |
|---|---|---|---|---|
| Twilio Account SID | Si (si no conectado) | AC... | ACxxxx | Integrations |
| Twilio Auth Token | Si (si no conectado) | 32 chars | ******** | Integrations |
| Phone Number | Sí | +E.164 | +15551234567 | Número Twilio |
Gestionar Voice Agents
En cada card:
- Toggle Active/Inactive.
- Edit.
- Delete.
Llamadas (Calls)
Rutas:
- /app/{tenant}/voice-agents/calls (lista)
- /app/{tenant}/voice-agents/calls/{callId} (detalle)
Datos mostrados:
- Direction (inbound/outbound)
- From / To
- Agent
- Duration
- Status
- Sentiment
- Fecha y hora
Buenas prácticas
- Usa un agent base con prompt claro y breve.
- Define un Initial Greeting corto.
- Activa Inactivity Timeout como respaldo.
- Si usas ElevenLabs, válida que el Voice ID sea correcto.
Errores comunes
- No aparece el agent base: el agent no tiene Voice habilitado o modelo no es realtime.
- No aparecen números: Twilio no conectado.
- Analytics no funcionan: OpenAI no conectado.