Internacionalización

El widget soporta 9 idiomas y detecta automáticamente el idioma del usuario. Además, el agente de IA puede cambiar el idioma de la interfaz en tiempo real según el idioma en que el usuario escribe.

Idiomas

Código	Idioma	Carga
es	Español	Incluido en el bundle (carga inmediata)
en	English	Incluido en el bundle
fr	Français	Carga diferida
de	Deutsch	Carga diferida
it	Italiano	Carga diferida
pt	Português	Carga diferida
ca	Català	Carga diferida
eu	Euskara	Carga diferida
gl	Galego	Carga diferida

es y en vienen en el bundle principal. Los otros 7 se cargan bajo demanda cuando se necesitan.

Cómo se detecta el idioma

Al iniciar, el widget consulta estas fuentes en orden:

1. data-locale del <script> o config.locale de init()
2. window.Shopify.locale (si existe)
3. document.documentElement.lang
4. navigator.language del navegador
5. Si nada coincide → es

<script src="https://cdn.neuroon.ai/widget@0.9.27/widget.js"
  data-token="TOKEN"
  data-locale="ca"
  async></script>

El agente de IA adapta el idioma

El backend recibe el locale en cada búsqueda (campo lang). Si el usuario escribe en un idioma distinto al configurado, el agente responde en ese idioma y el widget cambia toda la interfaz para igualarlo automáticamente.

Esto significa que no necesitas configurar manualmente el idioma para cada visitante — el widget se adapta solo.

Traducciones custom

Si necesitas modificar textos concretos, pasa translations en init() con las claves que quieras sobrescribir. Las claves se organizan por categoría:

Categoría	Ejemplos de claves
search	placeholder, noResults, voiceButton, imageButton, inputAriaLabel
results	empty, error, loadMore, showing, of
product	addToCart, outOfStock, compare, viewDetails
filters	title, apply, clearAll, sortBy
cart	title, empty, checkout, remove
ai	thinking, searching, analyzing
voice	listening, notSupported, tryAgain
image	uploadTitle, dragDrop, processing
errors	general, network, tokenExpired

El objeto Translations completo tiene más de 200 claves en 34 categorías. Para ver todas las disponibles, consulta el archivo es.ts en el código fuente del widget.

Las claves que no sobrescribas mantienen el valor por defecto del idioma cargado.

NeuroonWidget.init({
  token: 'TOKEN',
  locale: 'es',
  translations: {
    es: {
      search: { placeholder: '¿Qué estás buscando?' },
      results: { empty: 'No encontramos nada' },
      cart: { checkout: 'Pagar ahora' },
    },
  },
})

Próximas lecturas

• Configuración — locale y translations en NeuroonWidgetConfig.
• Recipe · Multi-locale storefront — tienda multilingüe con varios widgets.