Skip to main content
Elige el idioma que hablará el asistente de forma predeterminada, permite otros idiomas si es necesario y selecciona una voz por idioma cuando el motor lo admita.

​
Configurar el idioma principal

El idioma principal define el idioma que habla el asistente de forma predeterminada. Los motores con reconocimiento de voz separado también usan este ajuste para configurar el reconocimiento. Elige el idioma en el que quieres que hable normalmente.
Ajustes del asistente con selectores de idioma principal e idiomas secundarios

Settings del asistente → Advanced → General: configura Primary language y permite idiomas adicionales con Secondary languages.

Sin un idioma secundario distinto, el asistente permanece en su idioma principal. Mantén las instrucciones del prompt alineadas con estos ajustes: un prompt no sustituye la selección de los idiomas permitidos. Cuando hay detección de turnos separada, puedes usar un modelo semántico multilingüe, una variante optimizada para inglés o detección de actividad de voz. Full Duplex gestiona el ritmo de la conversación de otra manera; esos controles separados no se le aplican.

​
Asistentes multilingües

Para permitir el cambio automático de idioma:
  1. Configura el idioma principal como predeterminado.
  2. Añade un idioma secundario diferente del principal. El cambio solo está activo mientras haya un idioma secundario distinto configurado y se limita a los idiomas seleccionados.
  3. En motores con reconocimiento de voz separado, elige un modelo de reconocimiento multilingüe que admita esos idiomas.
  4. Si el motor lo permite, selecciona una voz por idioma. El asistente usa la voz correspondiente al cambiar a un idioma permitido.
El asistente recibe la regla de idioma configurada. Si añades al prompt una instrucción para cambiar de idioma, hazlo solo cuando haya un idioma secundario configurado y limítala a los idiomas seleccionados. Una palabra extranjera aislada o un nombre de marca no requiere por sí solo un cambio de idioma. Las voces por idioma están disponibles en Pipeline y Half-cascade, porque esos modos usan una voz de salida separada. Realtime, incluido Full Duplex, mantiene la voz nativa seleccionada al cambiar de idioma.
Cambiar la vista a Voice per language no modifica nada por sí solo. Elige una voz para un idioma para guardar la sustitución; los demás idiomas conservan la voz principal.

​
Idiomas y voces

Cada voz habla solo un conjunto determinado de idiomas. El editor solo ofrece idiomas principales y secundarios que la voz del asistente puede hablar, y la biblioteca de voces se puede filtrar por idioma. La misma regla se aplica al guardar en el panel, mediante la API o mediante MCP. En los asistentes Pipeline y Half-cascade, el idioma principal, los idiomas secundarios y cada idioma con voz propia deben ser idiomas que la voz pueda hablar:
  • Un asistente nuevo se comprueba por completo. Si lo creas sin elegir una voz, se selecciona automáticamente una voz predeterminada que habla el idioma principal.
  • Un asistente existente se comprueba por completo cuando cambias a una voz de otro proveedor de voz o cambias el motor a Pipeline o Half-cascade. En los demás casos solo se comprueban los idiomas que añades: otra voz del mismo proveedor conserva los idiomas actuales y los demás cambios siguen funcionando. Si la plataforma tiene que sustituir una voz que ya no está disponible, también se conservan los idiomas actuales.
  • Restaurar una versión anterior sigue la misma regla.
  • Realtime, incluido Full Duplex, habla con su voz nativa y no se ve afectado.
Si se rechaza un cambio, elige una voz que admita esos idiomas o elimina los idiomas que no puede hablar.

​
Alemán (Suiza)

Elige Alemán (Suiza) para solicitar alemán suizo. El dialecto se configura en el selector de idiomas, sin un ajuste regional adicional. Alemán mantiene el alemán estándar.
  • Pipeline y Half-cascade: el reconocimiento utiliza alemán y las instrucciones de respuesta solicitan alemán suizo. Elige una voz adecuada y escucha una conversación de prueba; una voz que habla alemán no garantiza un acento suizo.
  • Realtime, incluido Full Duplex: el modelo recibe instrucciones de dialecto con la voz nativa seleccionada. La fidelidad al dialecto y la pronunciación regional dependen del modelo y de la voz.
  • Translate: conserva su propia lista de idiomas de origen y destino. Esta opción no añade alemán suizo a los motores de traducción.
Puedes combinar alemán suizo con inglés u otro idioma compatible. No selecciones Alemán y Alemán (Suiza) juntos: la detección automática no puede distinguirlos de forma fiable. Para especificar un dialecto regional, añade por ejemplo «Sprich Züritüütsch» al prompt. Escribe los saludos fijos y anuncios guardados en el dialecto deseado; las grabaciones existentes y los guiones exactos conservan su texto. Los mensajes automáticos usan alemán suizo cuando su traducción está lista y alemán mientras tanto. El código es gsw. de-CH sigue siendo una configuración de alemán estándar, no un alias de este dialecto. Consulta los idiomas activados con GET /api/v1/languages, MCP get_languages o famulor list-languages. Usa PATCH /api/v1/assistants/{id} con {"primary_language":"gsw","secondary_languages":["en"]}, o los mismos campos en MCP update_assistant.
Antes de publicar, prueba la comprensión, las fechas, los nombres y el regreso desde un idioma secundario.

​
Ejemplos de prompts regionales

Para las variantes regionales siguientes, selecciona el idioma base existente y añade el ejemplo correspondiente a las instrucciones del asistente. Son preferencias del prompt, no nuevas opciones del selector de idioma. Los ejemplos están escritos en el idioma de conversación deseado y sirven como punto de partida para adaptarlos a tu negocio.

​
Qué gestionan automáticamente los ajustes

La plataforma combina su regla de idioma con tus instrucciones para el modelo. Mantén ambas coherentes: un prompt regional no activa un idioma no seleccionado ni sustituye la lista configurada. Si permites idiomas secundarios, aplica cada preferencia regional solo al hablar su idioma correspondiente.
Selección: Alemán.
Selección: Alemán.
Selección: Francés.
Selección: Portugués.
Selección: Portugués.
Selección: Inglés.
Selección: Español.
Selección: Árabe.

​
Comprueba el resultado con tu motor

  • Pipeline y Half-cascade: el prompt influye en el texto generado. La voz elegida influye mucho en el acento y la pronunciación; selecciona una voz adecuada o una voz por idioma cuando esté disponible.
  • Realtime, incluido Full Duplex: el modelo de voz nativo recibe la preferencia regional en sus instrucciones. El resultado depende del modelo y de la voz seleccionada.
  • Saludos fijos y grabaciones: escribe el texto deseado directamente en los guiones fijos. Los cambios del prompt no reescriben las grabaciones subidas.
Escucha varios turnos, interrumpe una respuesta, comprueba los nombres y las citas, y cambia a un idioma secundario permitido y de vuelta. Una buena muestra breve no garantiza un acento constante durante cada llamada.

​
Pronunciación y prompts en Full Duplex

De forma predeterminada, Full Duplex recibe indicaciones para usar una pronunciación natural y neutra, con un ritmo adecuado al idioma hablado configurado. Se respetan las instrucciones explícitas del prompt sobre pronunciación regional o de nombres. No imita automáticamente el acento de quien llama. No se garantiza un acento concreto: el resultado sigue dependiendo de la voz seleccionada y de los idiomas que admite el modelo. Siempre que sea posible, escribe el prompt y los ejemplos de respuestas habladas en el idioma principal deseado. Por ejemplo, para un asistente que habla español:
Mantén estas indicaciones alineadas con los ajustes de idioma principal y secundario. Añade una regla para cambiar de idioma solo si has configurado un idioma secundario distinto.

​
API y MCP

Los mismos ajustes de idioma y voz están disponibles mediante PATCH /api/v1/assistants/{id} y la herramienta MCP update_assistant. GET /api/v1/languages muestra los códigos ISO 639-1 / ISO 639-3 admitidos; consulta la referencia de la API para ver los campos de la solicitud. A través de la API REST, un cambio rechazado devuelve 400 con el código de error invalid_request; las herramientas MCP devuelven el mismo mensaje como error de la herramienta.

​
Pronunciación en todos los idiomas

El diccionario de pronunciación se aplica a la síntesis de voz TTS, incluidos los idiomas y las voces por idioma compatibles. Los administradores del espacio de trabajo pueden definir un mapa predeterminado que se combina con las entradas de cada asistente. El diccionario no se aplica actualmente a la voz nativa de Full Duplex. Para la voz nativa, añade al prompt del asistente instrucciones explícitas sobre la pronunciación de nombres o marcas.

​
Idioma del resumen posterior a la llamada

El Conversation Summary en el detalle de una llamada siempre se redacta en el idioma principal del asistente, no en el idioma en el que se mantuvo la llamada. Un asistente en alemán que atendió una llamada en inglés sigue recibiendo un resumen en alemán, de modo que el listado del historial se mantiene legible en un solo idioma. Al reevaluar una llamada (Historial → Re-evaluate) se aplica la misma regla. Todo lo demás permanece en el idioma original: la transcripción, las grabaciones y los campos de análisis extraídos nunca se traducen.
Cuando cambias el idioma principal, solo los resúmenes nuevos usan el nuevo idioma. Usa Re-evaluate para volver a generar el resumen de una llamada anterior.

​
Documentación frente al idioma de la llamada

Ten en cuenta que el idioma de la interfaz de la plataforma y el idioma de llamada del asistente son independientes: tu equipo puede usar un panel en inglés mientras los asistentes hablan en alemán con los clientes, y viceversa.
El catálogo incluye códigos de dos letras y, cuando es necesario, de tres letras, como ceb para cebuano. Las opciones disponibles dependen tanto del modelo de síntesis como del reconocimiento de voz. No todos los modelos admiten todos los idiomas del catálogo; consulta las opciones de tu asistente. La calidad de voz, los acentos y los sistemas de escritura compatibles pueden variar según el idioma.