Saltar al contenido principal

Troubleshooting

Soluciones a problemas comunes con el widget.

El widget no carga​

Verificar el token​

// En la consola del navegador
console.log('Token configurado:', document.querySelector('[data-token]')?.dataset.token);

Si el token está vacío o es incorrecto, obtén uno nuevo en el Dashboard.

Verificar errores de consola​

Abre DevTools (F12) → Console y busca errores:

  • 401 Unauthorized: Token inválido o expirado
  • 403 Forbidden: Dominio no autorizado
  • 429 Too Many Requests: Rate limit alcanzado
  • Network Error: Problema de conexión

Verificar CORS​

Si ves errores de CORS, asegúrate de que tu dominio esté verificado en el Dashboard.

Los estilos no se aplican​

Shadow DOM​

El widget usa Shadow DOM para encapsular estilos. Los estilos de tu página no afectan al widget y viceversa.

Para personalizar el widget, usa las variables CSS o el objeto styles en la configuración.

Conflictos con CSS existente​

Si tu CSS interfiere con el contenedor:

/* El contenedor del widget */
#neuroon-search {
  /* Asegura que no tenga estilos conflictivos */
  all: unset;
}

La búsqueda por voz no funciona​

Requisitos​

  • HTTPS (obligatorio)
  • Navegador compatible: Chrome, Safari, Edge
  • Permiso de micrófono concedido
  • Idioma: Español (es-ES)

Verificar soporte​

const supported = 'webkitSpeechRecognition' in window || 'SpeechRecognition' in window;
console.log('Voz soportada:', supported);

Permisos denegados​

Si el usuario denegó permisos:

  1. Click en el icono de candado en la barra de direcciones
  2. Cambiar permisos de micrófono a "Permitir"
  3. Recargar la página

Los productos no aparecen​

Verificar sincronización​

  1. Ve al Dashboard → Productos
  2. Verifica que haya productos indexados
  3. Comprueba que los productos estén activos (no borradores)

Sin resultados para la búsqueda​

Si una búsqueda no devuelve resultados:

  • Verifica que los términos coincidan con productos existentes
  • Comprueba que no haya filtros activos que excluyan resultados
  • Intenta con términos más genéricos

Rendimiento lento​

Reducir resultados por página​

NeuroonWidget.init({
  ui: {
    resultsPerPage: 10, // Default: 20
  },
});

Optimización de imágenes​

El widget usa lazy loading por defecto. Asegúrate de que las imágenes de tus productos estén optimizadas (WebP recomendado, max 200KB).

Errores de rate limiting​

Si recibes errores 429:

  1. Espera: Los límites se resetean cada minuto
  2. Verifica tu plan: Los límites varían según el plan
  3. Contacta soporte: Si necesitas más capacidad

Token expirado​

El token tiene validez de 1 hora. Si el widget deja de funcionar después de un tiempo:

  1. Recarga la página para obtener un nuevo token
  2. Para SPAs de larga duración, implementa refresh de token en tu backend

Depuración​

Para depurar problemas, abre DevTools y busca:

  1. Console: Errores de JavaScript
  2. Network: Llamadas a api.neuroon.ai y sus respuestas
  3. Elements: Verifica que el Shadow DOM se haya creado dentro de tu contenedor
// Verificar que el widget esté inicializado
const container = document.querySelector('#neuroon-search');
console.log('Shadow root:', container?.shadowRoot);

Contactar soporte​

Si el problema persiste:

  1. Captura el error de la consola
  2. Anota tu Shop ID
  3. Describe los pasos para reproducir
  4. Contacta en soporte@neuroon.ai