Idiomas del widget web — 50 out of the box.

Resumen — qué significa «compatible»

Un idioma se incorpora al widget web cuando todas las cadenas visibles para el usuario de la interfaz del chat cuentan con una traducción revisada por un hablante nativo. Esto incluye el texto de marcador de posición del cuadro de redacción, la descripción emergente del botón de envío, los avisos del estado de la conexión, los botones de respuesta rápida y todas las notificaciones emergentes de error. Si una cadena no puede traducirse con un equivalente directo (por contener modismos o expresiones culturales específicas), durante la revisión se redacta una versión adecuada para la configuración regional en lugar de recurrir al inglés.

La lista de esta página es la tabla de ejecución real: el cargador del widget incluye estos códigos y obtiene el paquete correspondiente durante la primera renderización.

Cobertura de un vistazo

Cómo se detecta el idioma del visitante

La detección se ejecuta una sola vez, al montar el widget, y selecciona la primera coincidencia en este orden:

1. Anulación explícita. Si tu página establece window.Knocket.locale = 'ja' antes de que se cargue el widget, eso tendrá prioridad. Consulte Anular en el código.
2. Atributo HTML lang. Si está presente <html lang="fr">, el widget lo adopta. Esta es la opción más limpia para sitios multilingües: configúralo en el servidor para cada página.
3. Configuración regional del navegador. Si no está disponible, se utiliza navigator.languages[0]. Las variantes regionales se reducen al idioma base (p. ej., pt-BR → pt).
4. Inglés. Si ninguna de las opciones anteriores coincide con un paquete publicado, el widget permanece en inglés en lugar de mostrarse parcialmente traducido.

La lista completa: 50 languages

Ordenados por número total de hablantes en el mundo. Cada fila es un paquete de idioma disponible; la columna de código contiene la cadena exacta que espera el widget.

Sobrescribir en el código

Si ya conoces el idioma preferido del visitante (por el estado de tu aplicación, la configuración de una cuenta o un parámetro de la URL), indícaselo explícitamente al widget:

<script>
  window.Knocket = window.Knocket || {};
  window.Knocket.locale = 'ja'; // must be set before the loader script
</script>
<script src="https://cdn.knocket.ai/w.js" async></script>

O, después de que el widget se haya cargado, modifícalo en tiempo real:

Knocket('setLocale', 'zh-Hans');

El widget vuelve a renderizar cada cadena de texto, invierte la dirección para los idiomas RTL y mantiene intacta la conversación actual.

Comportamiento alternativo

Dos casos excepcionales que conviene destacar:

• Configuración regional no incluida. Si introduces un código desconocido (por ejemplo, xx o una variante regional poco común), el widget vuelve silenciosamente al inglés y registra el fallo en las analíticas de la consola.
• Alternativa regional. Los códigos regionales se reducen a su idioma base cuando no se ofrece un paquete regional. pt-BR → pt, en-GB → en. El chino simplificado y el tradicional tienen paquetes independientes (zh-Hans frente a zh-Hant); no los trates como alias.