Solución de problemas
Problemas comunes y soluciones para problemas de integración de AI Anywhere.
Si estás experimentando problemas con AI Anywhere, esta guía cubre los problemas más comunes y sus soluciones. Comienza aquí antes de contactar con el soporte.
El botón de Asistente no aparece
Ves botones de ayuda duplicados junto al mismo área de texto.
Posibles soluciones:
- Borra la caché del navegador: Actualiza tu página forzadamente (Ctrl+Shift+R en Windows/Linux, Cmd+Shift+R en Mac) para asegurarte de que\
- Verifica que el script esté cargado: Abre las herramientas de desarrollador del navegador (F12), ve a la pestaña de Consola y busca cualquier error de JavaScript. Asegúrate de que el script se cargue sin errores.
- Verifica la ubicación del fragmento: Asegúrate de que la etiqueta del script esté en la
<head>sección, no en la<body>. El script debe cargarse antes del contenido de la página. - Verifica las áreas de texto: El Asistente solo aparece junto a
<textarea>y<input type="text">elementos. Asegúrate de que estos elementos existan en tu página. - Verifica el selector: Verifica que tu selector CSS sea correcto y apunte a un elemento de área de texto real en tu página.
- Desactiva los bloqueadores de anuncios: Algunos bloqueadores de anuncios o extensiones de privacidad pueden interferir con el script del Asistente. Prueba en una ventana de incógnito/privada.
Errores de Política de Seguridad de Contenidos (CSP)
La consola de tu navegador muestra violaciones de CSP que impiden que el script se cargue.
ai-anywhere.ai a tu Política de Seguridad de Contenidos\ script-src directiva.
Content-Security-Policy: script-src 'self' https://ai-anywhere.ai;
Si usas etiquetas meta en HTML:
<meta http-equiv="Content-Security-Policy"
content="script-src 'self' https://ai-anywhere.ai;">
El botón de Asistente no responde
El botón de Asistente aparece pero no sucede nada al hacer clic.
Posibles soluciones:
- Verifica la consola del navegador: Abre las herramientas de desarrollador (F12) y busca mensajes de error que puedan indicar problemas de autenticación o de red.
- Verifica las solicitudes de red: En la pestaña Red de las herramientas de desarrollo, verifica que las solicitudes API a AI Anywhere estén teniendo éxito (estado 200) y no estén siendo bloqueadas.
- Prueba con un navegador diferente: Descarta problemas específicos del navegador probando en Chrome, Firefox o Safari.
- Desactiva las extensiones del navegador: Algunas extensiones pueden interferir con la ejecución de JavaScript. Prueba con las extensiones desactivadas.
Aparecen múltiples botones de ayuda
Ves botones de ayuda duplicados junto al mismo área de texto.
Soluciones:
- Verifica fragmentos duplicados: Busca en tu HTML/plantillas para asegurarte de que la etiqueta del script solo aparezca una vez en el
<head>sección. - React/Vue/Angular: Asegúrate de que el script se cargue solo una vez usando
useEffect(React) o hooks montados, y añade un guardia para prevenir la recarga. - Usa un guardia de carga: Verifica si el script ya existe antes de añadirlo:
if (!document.querySelector('script[src*="ai-anywhere.ai"]')) { // Add script here }
Problemas de rendimiento o carga
El script de ayuda está ralentizando la carga de tu página o causando problemas de rendimiento.
Soluciones:
- Usa carga asíncrona: Añade
asyncatributo en la etiqueta del script (aunque nuestro script ya se carga de forma asíncrona). - Retrasa la carga del script: Si tu página tiene muchos scripts, considera cargar el script de ayuda con
deferatributo para cargarlo después del análisis de la página. - Verifica el tiempo de red: Usa la pestaña Red de las herramientas de desarrollo del navegador para ver si el script está tardando inusualmente en descargarse.
- Optimiza tu página: El script de ayuda es ligero (~50KB), pero si tu página ya es lenta, optimiza otros recursos primero.
Conflictos de estilo
El botón del Asistente no coincide con el diseño de tu sitio o entra en conflicto con tu CSS.
Soluciones:
- Sobrescribe con CSS: Usa selectores más específicos o
!importantpara sobrescribir los estilos del Asistente:.ai-helper-button { background-color: #your-color !important; border-radius: 8px !important; } - Usa la personalización de temas: Configura los colores y estilos de los botones en los ajustes de tu Asistente para que coincidan con tu marca.
- Verifica la especificidad de CSS: Asegúrate de que tus estilos personalizados tengan una especificidad CSS mayor que los estilos predeterminados del Asistente.
Problemas de compatibilidad con el navegador
La ayuda funciona en algunos navegadores pero no en otros.
Si los problemas persisten:
- Actualiza tu navegador: Asegúrate de estar usando la última versión de tu navegador.
- Verifica que JavaScript esté habilitado: Verifica que JavaScript esté habilitado en la configuración de tu navegador.
- Prueba en modo incógnito: Descarta conflictos de extensiones probando en modo privado/incógnito.
Si ninguna de estas soluciones resuelve tu problema, revisa la consola del navegador para mensajes de error específicos y contacta a nuestro equipo de soporte con:
- El mensaje de error de la consola de tu navegador
- Tu navegador y versión
- El nombre y selector de tu Asistente
- Una descripción de lo que esperabas vs. lo que ocurrió