Modo experto de VoiceAgent

Este artículo explica cómo ver y editar la configuración completa de tu VoiceAgent en la sección Avanzado, incluidos los ajustes que no puedes cambiar en ningún otro sitio.

Nivel de usuario: Admin

El modo experto te muestra la configuración completa de tu VoiceAgent en formato JSON. Muestra todos los ajustes, incluidos los que nunca has cambiado, con sus valores actuales. Puedes ajustar opciones que no están disponibles en las demás secciones, como el modelo de IA, el comportamiento de la voz y la gestión de llamadas.

Abrir el modo experto

En el Dashboard, ve a AI Voice Agents > Agentes y abre tu VoiceAgent.
En el menú de la izquierda, en Crear, haz clic en Avanzado.

La sección Avanzado de un VoiceAgent, con el panel Configuración que muestra el JSON completo y la barra de estado Sin problemas

El panel Configuración muestra la configuración completa. Encima, también puedes pedir a AI Composer que haga los cambios por ti, con tus propias palabras.

Qué ves

Todos los ajustes, con su valor. Los ajustes que no has cambiado muestran su valor predeterminado, para que veas todo lo que puedes ajustar. No necesitas guardar antes para verlos.
Los ajustes de todos los proveedores de voz. Aparecen tanto elevenLabsSettings como deepgramSettings, sea cual sea el proveedor que use tu VoiceAgent.
Una barra de estado encima del JSON. Indica Sin problemas cuando la configuración es válida. Si hay algún error, por ejemplo un valor no admitido, te indica qué debes corregir antes de poder guardar.

Editar la configuración

Cambia los valores que quieras en el panel Configuración.
Comprueba que la barra de estado indica Sin problemas.
Haz clic en Guardar.

Para deshacer los cambios sin guardar, haz clic en Revertir. Las demás secciones (Identidad, Base de conocimiento y Habilidades y escenarios) y la sección Avanzado muestran la misma configuración de dos formas distintas. Los cambios que hagas en una se reflejan en la otra.

Copiar una configuración a otro VoiceAgent

En la sección Avanzado, haz clic en Copiar para copiar la configuración completa, incluidos los valores predeterminados.
Abre la sección Avanzado del otro VoiceAgent, sustituye su configuración por la copiada y haz clic en Guardar.

Como la copia incluye todos los ajustes, el otro VoiceAgent se comporta exactamente igual.

Cambia el agentName. Cada VoiceAgent necesita un nombre único.
Vuelve a conectar los recursos específicos de la cuenta. Una configuración puede hacer referencia a elementos de tu cuenta, como bases de conocimiento, herramientas personalizadas, números de teléfono o una integración de calendario. Cuando copies una configuración a otra cuenta, vuelve a configurarlos allí.
Después de una importación correcta, guarda el VoiceAgent dos veces. Hay un conjunto conocido de casos límite que solo aparece después de la segunda vez que guardas.

Referencia de ajustes

Identidad

Campo JSON	Qué configura
`agentName`	El nombre del VoiceAgent. Debe ser único en tu cuenta.
`direction`	Indica si el agente gestiona llamadas entrantes o salientes: `"inbound"` o `"outbound"`.
`language`	El idioma en el que habla el VoiceAgent.
`secondaryLanguages`	Idiomas adicionales que el VoiceAgent puede detectar y a los que puede cambiar durante una llamada. Opcional.
`voice`	La voz que utiliza el VoiceAgent.
`greeting`	La frase exacta que dice el VoiceAgent al inicio de la llamada. Si está vacío, los agentes para llamadas entrantes usan un mensaje predeterminado genérico; los agentes para llamadas salientes empiezan en silencio.
`startSpeakingFirst`	Indica si el VoiceAgent habla primero cuando se conecta la llamada (`true`) o espera a que hable la persona que llama (`false`).
`defaultOutboundNumberId`	El número de teléfono desde el que llama el VoiceAgent.
`failoverOutboundNumberId`	Un número de respaldo desde el que llamar si no se puede usar el número predeterminado.

Conocimiento y comportamiento

Campo JSON	Qué configura
`knowledgeBaseIds`	Las bases de conocimiento que el VoiceAgent puede usar para responder preguntas.
`goalPrompt`	Las instrucciones principales que definen el comportamiento del VoiceAgent durante una llamada.
`skills`	Funciones estructuradas, por ejemplo `takeMessage` y `extractData`. Cada habilidad tiene `enabled` y sus propios ajustes.
`scenarios`	Cómo responde el VoiceAgent a situaciones específicas. Cada escenario tiene `when`, `reply` y, opcionalmente, una `action` como `"hangup"`.
`guardrails`	Respuestas fijas para situaciones que requieren una respuesta coherente sin importar el contexto.

En skills.extractData.properties, cada propiedad necesita un name único. Si dos propiedades comparten nombre, la configuración no se guarda.

Estilo de conversación

Estos dos campos controlan cómo habla el VoiceAgent.

Campo	Qué configura	Valores
`tone`	Cómo suena el VoiceAgent. Una lista de estilos predefinidos; se pueden combinar, pero lo mejor es usar uno o dos (cada estilo adicional diluye los demás). El orden no importa, los duplicados se eliminan automáticamente y no se aceptan valores de texto libre.	`"professional"`, `"friendly"`, `"casual"`, `"calm"`, `"empathetic"`, `"direct"`. Valor predeterminado: `["friendly", "direct"]`.
`verbosity`	Cuánto dice el VoiceAgent en cada respuesta. `"concise"` = la respuesta útil más breve. `"standard"` = una o dos frases, con más información si es necesario. `"thorough"` = respuestas más completas con contexto útil (aun así breves; es una llamada telefónica).	`"concise"` / `"standard"` / `"thorough"`. Valor predeterminado: `"standard"`.

Guía de estilos predefinidos:

Estilo predefinido	Efecto
`professional`	Mesurado, preciso y respetuoso
`friendly`	Cálido y cercano
`casual`	Relajado e informal, como un compañero dispuesto a ayudar
`calm`	Estable, tranquilo y paciente
`empathetic`	Reconoce los sentimientos de la persona que llama antes de pasar a las soluciones
`direct`	Va directo a la respuesta y reduce las formalidades al mínimo

Independientemente del tono y la extensión de las respuestas, el VoiceAgent siempre es breve en los momentos operativos: confirmaciones, repeticiones de datos, despedidas y pasos de transferencia o reserva.

Modelo de IA

Campo	Qué configura
`llm`	El modelo de IA que usa el VoiceAgent. Consulta la lista de modelos admitidos más abajo.
`provider`	El proveedor de voz: `"elevenlabs"` o `"deepgram"`. En la mayoría de los casos, el idioma determina el proveedor automáticamente.
`temperature`	La variedad de las respuestas del VoiceAgent, de `0.0` a `1.0`. Para agentes profesionales o estructurados, se recomienda un valor de `0.1` a `0.3`.

Modelos admitidos para llm

Modelo	Valor
GPT-4o Mini	`openai - gpt-4o-mini`
GPT-4o	`openai - gpt-4o`
GPT-4.1	`openai - gpt-4.1`
GPT-4.1 Mini	`openai - gpt-4.1-mini`
GPT-4.1 Nano	`openai - gpt-4.1-nano`
GPT-5	`openai - gpt-5`
GPT-5 Mini	`openai - gpt-5-mini`
GPT-5 Nano	`openai - gpt-5-nano`
GPT-5.1	`openai - gpt-5.1`
Claude 3 Haiku	`anthropic - claude-3-haiku`
Claude Haiku 4.5	`anthropic - claude-haiku-4-5`
Claude 3.7 Sonnet	`anthropic - claude-3-7-sonnet`
Gemini 2.0 Flash Lite	`google - gemini-2.0-flash-lite`
Gemini 1.5 Pro	`google - gemini-1.5-pro`

Ajuste de voz

Campo	Qué configura	Valores
`stability`	La consistencia de la voz del VoiceAgent durante la llamada. Los valores más altos producen una voz más estable.	`0.0`–`1.0`
`similarity`	Cuánto se parece la voz al modelo de voz original.	`0.0`–`1.0`
`optimizeStreamingLatency`	Sacrifica calidad de voz a cambio de menor latencia de respuesta. Los valores más altos reducen la latencia, pero pueden afectar a la calidad. No lo establezcas en `4`: desactiva la normalización de texto, por lo que los números y las fechas se pronuncian mal.	`0`–`4`

Comportamiento de la llamada

Campo	Qué configura	Valores
`maxCallDuration`	Un límite estricto para la duración de la llamada, en minutos.	Recomendado: de 3 a 5 minutos para llamadas salientes, de 15 a 30 minutos para llamadas entrantes.
`dialTime`	Cuánto tiempo espera el VoiceAgent a que se conteste en llamadas salientes antes de darse por vencido.	`5`–`120` segundos.

Ajustes de ElevenLabs

Estos ajustes se aplican cuando tu VoiceAgent usa ElevenLabs, la opción predeterminada para la mayoría de los idiomas. Se encuentran dentro del objeto elevenLabsSettings, no en el nivel raíz de la configuración.

Campo	Qué configura	Valores
`speculativeTurn`	El VoiceAgent empieza a preparar su respuesta antes de que la persona que llama termine de hablar, lo que reduce el tiempo de respuesta.	`true` / `false`
`turnEagerness`	Con qué rapidez toma el turno el VoiceAgent cuando la persona que llama hace una pausa.	`"patient"` / `"normal"` / `"eager"`
`turnModel`	La versión del modelo de detección de turnos.	`"turn_v2"` / `"turn_v3"`
`vad`	Filtra el ruido de fondo para que no provoque una respuesta involuntaria.	`true` / `false`
`asrKeywords`	Palabras o frases que se priorizan en el reconocimiento de voz, como nombres de producto o términos técnicos.	Lista de cadenas de texto
`interruptionIgnoreTerms`	Expresiones breves de confirmación de la persona que llama (por ejemplo, sonidos de asentimiento) que no deben contar como interrupción, de modo que el VoiceAgent siga hablando a pesar de ellas. Se escriben en el idioma de la persona que llama.	Lista de cadenas de texto
`interruptionIgnoreTermLanguages`	Los idiomas en los que se buscan estas expresiones.	Lista de códigos de idioma
`backgroundSound`	Un sonido ambiente de fondo mientras habla el VoiceAgent. `null` significa ninguno.	`null` o un objeto: `preset` (uno de `"office"`, `"office2"`, `"restaurant"`, `"city"`, `"typing"`, `"elevator"`, `"elevator2"`, `"elevator3"`, `"elevator4"`), `volume` (`0.0`–`1.0`, opcional), `crossfadeLoop` (`true`/`false`, opcional; repite el sonido en bucle sin cortes)

Ejemplo:

"elevenLabsSettings": {
  "speculativeTurn": true,
  "turnEagerness": "patient",
  "turnModel": "turn_v3",
  "vad": true,
  "asrKeywords": ["Capil Clinic", "injerto capilar", "Barcelona"],
  "interruptionIgnoreTerms": ["vale", "sí", "ajá"],
  "interruptionIgnoreTermLanguages": ["es"],
  "backgroundSound": {
    "preset": "office",
    "volume": 0.3,
    "crossfadeLoop": true
  }
}

Al guardar, el objeto elevenLabsSettings que envías sustituye al que estaba guardado. Para borrar un solo ajuste, elimínalo del objeto.

Ajustes de Deepgram

deepgramSettings contiene los ajustes de los VoiceAgents que usan Deepgram. Está vacío cuando no hay nada que configurar.

Gestionado por CloudTalk

CloudTalk gestiona minorVersion y hashes. Déjalos como están.

¿Necesitas ayuda o tienes alguna pregunta? Ponte en contacto con nosotros a través de nuestro Portal de atención al cliente. Estamos aquí para ayudarte.

Primeros pasos

Números y portabilidad

IA

AI Sales Dialer

CloudTalk Phone y Go

Mensajería

Dashboard

Integraciones

Facturación y suscripción

Novedades y actualizaciones técnicas

Dashboard antiguo

Abrir el modo experto

Qué ves

Editar la configuración

Copiar una configuración a otro VoiceAgent

Referencia de ajustes

Identidad

Conocimiento y comportamiento

Estilo de conversación

Modelo de IA

Ajuste de voz

Comportamiento de la llamada

Ajustes de ElevenLabs

Ajustes de Deepgram

Gestionado por CloudTalk

​Abrir el modo experto

​Qué ves

​Editar la configuración

​Copiar una configuración a otro VoiceAgent

​Referencia de ajustes

​Identidad

​Conocimiento y comportamiento

​Estilo de conversación

​Modelo de IA

​Ajuste de voz

​Comportamiento de la llamada

​Ajustes de ElevenLabs

​Ajustes de Deepgram

​Gestionado por CloudTalk

Abrir el modo experto

Qué ves

Editar la configuración

Copiar una configuración a otro VoiceAgent

Referencia de ajustes

Identidad

Conocimiento y comportamiento

Estilo de conversación

Modelo de IA

Ajuste de voz

Comportamiento de la llamada

Ajustes de ElevenLabs

Ajustes de Deepgram

Gestionado por CloudTalk