Configura el idioma del widget

Dobrik te ayuda a seguir esta guía de DobroDesk

Actualizado:14 de octubre de 2026

Al terminar

El widget usa inglés, ucraniano, alemán, español, francés o portugués brasileño cuando ese idioma está activado y usa el idioma predeterminado configurado cuando el idioma solicitado no está activado.

Comprende qué se localiza

El widget carga dos tipos de contenido lingüístico. El texto de la interfaz incluye el botón, los campos, la validación y los mensajes de estado. El contenido para clientes incluye las respuestas sugeridas y las rutas guiadas aprobadas para ese idioma.

Cambiar solo el idioma de la interfaz no traduce una respuesta pública existente. Cada respuesta destinada a clientes debe revisarse y publicarse para su propia configuración regional para evitar una experiencia en varios idiomas.

El inglés utiliza el código de configuración regional en.
El ucraniano utiliza el código de configuración regional uk.
El alemán utiliza el código de configuración regional de.
El español utiliza el código de configuración regional es.
El francés utiliza el código de configuración regional fr.
El portugués brasileño utiliza el código de configuración regional pt.
Un valor regional del navegador como uk-UA se asocia a su código de idioma principal uk.
El cargador usa el idioma solicitado solo cuando está incluido en la lista de idiomas activados del widget. En caso contrario, usa el idioma predeterminado configurado.

Usa la detección automática del idioma

El código de inserción generado utiliza auto de forma predeterminada. Al cargar cada página, el widget lee el idioma principal del navegador, lo compara con los idiomas activados y usa el idioma predeterminado configurado si el idioma solicitado no está activado. La detección automática no analiza el texto de la página ni traduce contenido en el navegador.

Inserción mediante script

<script
  async
  src="https://widget.dobrodesk.com/widget/loader/v1.min.js"
  data-dobrodesk-integration="wgt_7f4c1d2e3a5b6980718293a4b5c6d7e8"
  data-dobrodesk-locale="auto"
></script>

Define un idioma explícito para una página localizada

Usa una configuración regional explícita cuando el sitio ya tenga rutas separadas por idioma y el widget deba seguir el idioma seleccionado en el sitio. Los idiomas de interfaz compatibles son en, uk, de, es, fr y pt. El widget solo usa un idioma activado en su configuración. De lo contrario, usa el idioma predeterminado configurado.

Inserción en ucraniano

<script
  async
  src="https://widget.dobrodesk.com/widget/loader/v1.min.js"
  data-dobrodesk-integration="wgt_7f4c1d2e3a5b6980718293a4b5c6d7e8"
  data-dobrodesk-locale="uk"
></script>

Mantén una sola inserción en la página. Genera el valor regional adecuado a partir del estado de idioma del sitio en lugar de añadir un script por idioma.

Define o cambia el idioma con el SDK

Pasa un idioma activado durante la inicialización cuando la aplicación ya conozca su idioma actual. Si el visitante lo cambia sin recargar la página, llama a setLocale con el nuevo código compatible. El widget vuelve a cargar la interfaz y el contenido correspondientes para la integración existente.

Configuración regional programática

const supportWidget = createDobroDeskWidget({
  integrationId: "wgt_7f4c1d2e3a5b6980718293a4b5c6d7e8",
  locale: currentSiteLocale,
});

await supportWidget.ready;

// After an in-app language change
supportWidget.setLocale("uk");

Prepara contenido público para cada idioma

Decide si cada ruta del sitio utilizará auto o un idioma activado: en, uk, de, es, fr o pt. Si el idioma solicitado no está activado, se usa el idioma predeterminado configurado.
Crea o revisa las respuestas sugeridas y las rutas guiadas por separado para cada idioma de clientes que publiques. Traduce el significado y la política actual, no solo palabras sueltas.
Comprueba nombres de productos, precios, textos legales, horarios y tiempos de respuesta previstos en cada versión publicada.
Publica únicamente contenido completo destinado al cliente. Si aún falta una respuesta en ucraniano, mantén la versión inglesa exacta en lugar de prometer una traducción inexistente.

La traducción automática puede ayudar a preparar un borrador, pero una persona responsable de la comunicación con clientes debe revisarlo antes de publicarlo.

Prueba los idiomas activados y el idioma predeterminado

Abre el sitio público en una ventana privada con el idioma del navegador establecido en el que quieras probar.
Comprueba el botón de Soporte, el encabezado, la disponibilidad, los campos, la validación y el mensaje de confirmación.
Abre cada respuesta sugerida y ruta guiada. Busca claves de texto ausentes o frases que cambien a otro idioma.
Envía un mensaje que incluya el nombre del idioma y confirma que la conversación llegue a DobroDesk con esa configuración regional.
Repite la prueba con un idioma del navegador que no esté activado y confirma que el widget use el idioma predeterminado configurado.