El chat no aparece en tu web: qué revisar

Cuando el chat no puede cargarse no muestra nada, ni el botón ni un mensaje de error, así que hay que ir descartando causas. Las tres más frecuentes: el agente no está activo (ábrelo y pulsa Activar), el código no está publicado en esa página o el dominio no está en Dominios permitidos.

Comprobación rápida

1. Abre tu web en una ventana privada del navegador. Así no ves una copia guardada de la página.

2. En la aplicación, entra en Agentes, abre tu agente y mira el estado junto al nombre. Si no pone Activo, ve a el agente está en borrador o en pausa.

3. Abre la pestaña Widget y, dentro de ella, Instalación. Si en Dominios permitidos hay dominios y ninguno es el de la página donde falta el chat, ve a el dominio no está en la lista.

Si el agente está activo y el dominio es correcto, la causa está en tu web. Sigue con los demás apartados, en orden.

El agente está en borrador o en pausa

Cómo reconocerlo. Junto al nombre del agente pone Borrador o En pausa, y en Widget › Instalación aparece el aviso «El widget todavía no se mostrará en tu web».

Cómo arreglarlo. Abre el agente y pulsa Activar, o Reanudar si estaba en pausa. Después recarga tu web.

Un agente creado con Duplicar nace en Borrador: es habitual pegar su código y olvidarse de activarlo.

El código no está en esa página o no se ha publicado

Cómo reconocerlo. En un ordenador, abre la página donde falta el chat, pulsa con el botón derecho y elige la opción de ver el código fuente de la página. Busca data-agent con Ctrl+F (Cmd+F en un Mac). Si no aparece, lo más probable es que esa página no lleve el código.

Cómo arreglarlo. Suele ser una de estas cosas:

• Guardaste el cambio, pero no lo publicaste. Muchas plataformas guardan un borrador hasta que pulsas su botón de publicar.
• El código está en una sola página o plantilla. Tiene que estar en todas las páginas donde quieras el chat.
• Lo pegaste en un fragmento de código o en un plugin que está desactivado.
• Lo estás mirando dentro del editor de tu plataforma. Muchos editores no ejecutan el código añadido ni en el editor ni en su vista previa: compruébalo en la web publicada.

Dónde y cómo pegarlo, plataforma por plataforma, en instalar el chat en tu web.

El dominio no está en la lista de dominios permitidos

Cómo reconocerlo. En Dominios permitidos hay algún dominio, y la dirección que ves en la barra del navegador cuando falta el chat no coincide con ninguno. Si la lista está vacía, esta no es la causa.

Los casos habituales:

• Con www o sin www. www.tuempresa.com en la lista no cubre tuempresa.com. Al revés sí: tuempresa.com cubre las dos.
• Otro subdominio. tuempresa.com no cubre tienda.tuempresa.com. Añádelo, o usa *.tuempresa.com para cubrirlos todos.
• Otro dominio. La versión .es cuando en la lista solo está la .com, o una segunda web.
• La dirección de pruebas de tu plataforma. La vista previa del editor o una dirección temporal, como las que terminan en myshopify.com o webflow.io, no es tu dominio.

Cómo arreglarlo. En Añadir dominio, escribe el que falta, pulsa Añadir y después Guardar cambios. Recarga tu web. Los pasos completos están en añadir tus dominios y las reglas, en qué cubre cada entrada.

Estás viendo una copia antigua de la página

Cómo reconocerlo. El chat aparece en una ventana privada o en otro dispositivo, pero no en tu navegador de siempre. O acabas de pegar el código y la página pública sigue igual que antes.

Cómo arreglarlo.

• Tu navegador. Vacía su caché o comprueba siempre el chat en una ventana privada.
• La caché de tu web. Si tu web usa un plugin de caché o de optimización, o una red de distribución de contenidos (CDN), puede seguir sirviendo la página antigua, sin el código. Vacía esa caché desde su panel y vuelve a probar.

El código se alteró al pegarlo

Cómo reconocerlo. Ves la línea de código escrita en tu página como si fuera texto. O el código está en la página (lo encuentras al buscar data-agent) y el chat sigue sin salir.

• Se pegó como texto. Un bloque de texto o de párrafo muestra el código en lugar de ejecutarlo. Tiene que ir en un campo para código o HTML.
• Las comillas cambiaron. Si el código pasó por un procesador de textos, un correo o una aplicación de mensajería, las comillas rectas pueden haberse convertido en comillas tipográficas, y el navegador ya no entiende la línea.
• La clave no es la de tu agente. El valor de data-agent tiene que ser la Clave pública que ves en la página de tu agente. Cada agente tiene la suya, también los duplicados.
• Hay dos códigos de chat en la misma página. Solo se usa uno. Deja únicamente el del agente que debe atender esa web.

Cómo arreglarlo. Borra la línea de tu web, cópiala de nuevo con Copiar en Widget › Instalación y pégala directamente, sin pasarla por otro programa.

Algo en tu web bloquea o retrasa el chat

Cómo reconocerlo. El código está bien pegado, el agente está activo y el dominio es correcto, pero el chat no aparece, o solo aparece después de aceptar las cookies o de moverte por la página.

Pásale esta lista a quien gestione tu web:

• Avisos de cookies. Algunas herramientas de consentimiento no dejan cargar código de terceros hasta que el visitante acepta. Comprueba si el chat aparece al aceptar y revisa en esa herramienta cómo está clasificado.
• Optimizadores de velocidad. Las opciones que retrasan o aplazan el JavaScript pueden no cargar el chat hasta que el visitante toca la página, o no cargarlo. Excluye de esa opción la dirección que aparece en src dentro del código del chat.
• Una política de seguridad estricta. Si tu web solo admite código de direcciones autorizadas (lo que se llama Content Security Policy), hay que autorizar la dirección de ese src para cargar scripts, para conectarse a ella y para mostrar sus imágenes.

Cuando el código se carga pero el chat no puede arrancar, deja un único aviso en la consola del navegador. Empieza por [iAgentify] Widget not loaded: y termina con el motivo: por ejemplo, ORIGIN_NOT_ALLOWED si el dominio no está en la lista, o NOT_FOUND si el agente no está activo o la clave no es la suya. Si no hay ningún aviso de iAgentify y el chat no aparece, el código no ha llegado a ejecutarse: no está en la página o algo lo bloquea antes de cargarse.

La cuenta está suspendida

Cómo reconocerlo. Al entrar en la aplicación ves un aviso que empieza por «Esta cuenta está suspendida». El chat deja de cargarse en todas tus webs.

Cómo arreglarlo. No depende de tu web ni del código. Escríbenos desde Soporte.

El chat aparece, pero dice que no está disponible

Este caso es distinto: el código funciona. El visitante abre el chat, escribe y lee «Este chat no está disponible ahora mismo.». Significa que tu agente no puede generar respuestas porque se han acabado los créditos, ha terminado la prueba gratuita o la suscripción no está activa. La aplicación te dice cuál de las tres en un aviso en la parte superior. Con menos frecuencia es un fallo temporal del servicio de IA, que no depende de tu cuenta.

• Qué hacer en cada caso: tu agente no responde.
• Cómo funcionan la prueba y los créditos: la prueba gratuita y los créditos.

El chat aparece, pero no se abre solo

Tampoco es un fallo. Depende de lo elegido en Widget › Comportamiento › Apertura:

• Con Cerrado solo se ve el botón, y el visitante lo abre cuando quiere.
• Con Abierto, si el visitante cierra el chat, se queda cerrado en esa pestaña del navegador.
• Se abre al cabo de un rato lo hace una sola vez por visita.
• En móviles el chat ocupa toda la pantalla y nunca se abre solo, elijas lo que elijas.

Para volver a probarlo, usa una ventana privada nueva en un ordenador. Las opciones están explicadas en personalizar el aspecto del chat.

Qué enviar a soporte

Abre un ticket desde Soporte con estos datos:

• El nombre del agente.
• La dirección exacta de la página donde falta el chat.
• La plataforma con la que está hecha tu web: WordPress, Shopify, hecha a mano u otra.
• Qué puntos de esta lista has comprobado ya.
• Si quien gestiona tu web lo ha mirado, el texto completo del aviso [iAgentify] de la consola.