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​

Verificar que el CSS esté cargado​

<!-- Debe estar en el <head> -->
<link rel="stylesheet" href="https://cdn.neuroon.ai/widget.css">

Conflictos con CSS existente​

Si tu CSS interfiere con el widget:

/* Aumentar especificidad */
#neuroon-search .neuroon-widget {
  /* tus estilos */
}

O usa !important como último recurso.

La búsqueda por voz no funciona​

Requisitos​

  • HTTPS (obligatorio)
  • Navegador compatible: Chrome, Safari, Edge
  • Permiso de micrófono concedido

Verificar soporte​

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

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)

Verificar filtros​

Los filtros pueden ocultar resultados:

// Limpiar filtros
widget.clearFilters();
widget.search('test');

Rendimiento lento​

Reducir resultados por página​

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

Lazy loading de imágenes​

El widget usa lazy loading por defecto. Si ves problemas:

.neuroon-product-image {
  loading: lazy;
}

Errores de rate limiting​

Si recibes errores 429:

  1. Espera: Los límites se resetean cada minuto
  2. Reduce búsquedas: Debounce más agresivo
  3. Contacta soporte: Si necesitas más capacidad

Debug mode​

Activa logs detallados:

NeuroonWidget.init({
  debug: true, // Logs en consola
});

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