Navegación

Solución de problemas

Problemas comunes y soluciones para problemas de integración de AI Anywhere.

Lectura de 9 min

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.

Solución: Añade 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.

Causa: Esto generalmente ocurre cuando el fragmento se incluye varias veces en la misma página, o cuando los frameworks de JavaScript vuelven a renderizar componentes.

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 async atributo 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 defer atributo 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 !important para 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.

Navegadores compatibles: AI Anywhere es compatible con todos los navegadores modernos, incluidos Chrome, Firefox, Safari, Edge y Opera. Internet Explorer 11 y versiones anteriores no son compatibles.

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.
¿Aún necesitas ayuda?

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ó