Instalar el chat en WordPress

En WordPress el chat se instala pegando la línea de código de tu agente en el pie de todas las páginas. La forma más segura es un plugin de los que añaden código a la cabecera y al pie del sitio: guarda el código fuera del tema, así que no se pierde cuando el tema se actualiza. No existe un plugin de iAgentify para WordPress y no hace falta.

Antes de empezar

• El agente tiene que estar activo. Un agente en Borrador o En pausa no muestra el chat aunque el código esté pegado. Se activa con el botón Activar (o Reanudar, si estaba en pausa) de la página del agente.
• Necesitas entrar en WordPress como administrador. Es el rol que puede instalar plugins y cambiar el tema. Si no lo tienes, pásale el código y este artículo a quien lleve la web.
• Si tu web está en WordPress.com, comprueba tu plan. Cuando se escribió este artículo (octubre de 2026), WordPress.com solo dejaba instalar plugins y añadir código propio en algunos de sus planes de pago. Consulta la ayuda de WordPress.com para saber qué incluye el tuyo.

Copia el código de tu agente

1. En iAgentify, entra en Agentes y abre tu agente.

2. Abre la pestaña Widget y, dentro de ella, Instalación.

3. En Código de instalación, pulsa Copiar. Es una sola línea, como esta:

   <script src="https://backendiagentify.yarqat.com/widget.js" data-agent="clave-de-tu-agente" async></script>

Copia siempre la de la aplicación, no la de este artículo: la tuya lleva la clave pública de tu agente. Tienes más detalle en instalar el chat en tu web.

Pégalo con un plugin de cabecera y pie

1. En el escritorio de WordPress, entra en Plugins y elige la opción de añadir uno nuevo.

2. Escribe «header footer code» en el buscador de plugins.

3. Elige un plugin que deje añadir código al pie de todo el sitio. WPCode es uno de los más utilizados; cualquier otro que tenga una casilla para el pie sirve igual.

4. Pulsa Instalar ahora y, cuando termine, Activar.

5. Abre la pantalla del plugin donde se pega el código de cabecera y pie. En WPCode está en el menú del plugin y se llama Header & Footer; según el idioma de tu WordPress puede aparecer traducida.

6. Pega la línea del chat en la casilla del pie (en inglés, Footer). Es la que añade el código antes de </body> en todas las páginas.

   Si el plugin solo tiene casilla para la cabecera (<head>), pégala ahí: el chat espera a que la página termine de cargar y funciona igual.

7. Guarda los cambios del plugin.

8. Si tu WordPress usa un plugin de caché, vacía la caché. Sin este paso tus visitantes pueden seguir recibiendo la copia antigua de las páginas, sin el chat.

Otras formas de pegarlo

Desde las opciones del tema o del constructor de páginas

Algunos temas y constructores de páginas tienen su propia casilla para esto. Búscala en las opciones del tema con un nombre como «código personalizado», «scripts», «integraciones» o «código del pie»: lo que necesitas es el sitio donde el tema deja añadir código antes de </body> en todo el sitio. Pega la línea, guarda y vacía la caché.

Ese ajuste pertenece al tema. Normalmente se conserva cuando el tema se actualiza, pero si cambias de tema tendrás que pegar la línea en el nuevo.

Editando el archivo del tema, como último recurso

Hazlo solo si no puedes usar ninguna de las dos formas anteriores, y mejor con quien montó la web. La línea se pega en el archivo footer.php del tema, en la línea de encima de </body>, desde el editor de archivos del tema (suele estar en Apariencia o en Herramientas) o por FTP. Muchos temas recientes, los llamados temas de bloques, no tienen ese archivo: en ellos usa el plugin.

Comprueba que funciona

1. Abre tu web en una ventana privada del navegador. Con la sesión de WordPress iniciada, muchos plugins de caché te enseñan la página recién hecha y no la copia que reciben tus visitantes.

2. En una esquina inferior de la página aparece el botón del chat. Púlsalo.

3. Escribe una pregunta. La respuesta llega en unos segundos y la conversación aparece en Conversaciones, dentro de la aplicación.

Esa prueba es una conversación real: gasta créditos y cuenta en tu analítica.

Problemas habituales en WordPress

• La caché sigue sirviendo la página antigua. Vacía la del plugin de caché y, si tu alojamiento o una red de distribución (CDN) guardan copias de las páginas, también la suya.
• Un plugin de optimización retrasa o combina el JavaScript. Con opciones como «retrasar JavaScript» o «combinar JavaScript», el chat puede no aparecer hasta que el visitante mueve el ratón o toca la pantalla, o no aparecer. Esos plugins tienen una lista de exclusiones: añade en ella la dirección del script del chat, la que va en src dentro de tu línea de código.
• El código está pegado dentro de una página o una entrada. Ahí solo saldría en esa página, y WordPress puede quitar el código al guardar, según el rol de tu usuario. Pégalo con el plugin, que lo pone en todo el sitio.
• El código está pegado dos veces. Si queda en el plugin y también en el tema, no pasa nada: la segunda copia no hace nada. Si las dos líneas son de agentes distintos, solo se carga uno, así que deja solo la del agente que quieres.

Añade tu dominio a los dominios permitidos

Mientras la lista de Dominios permitidos esté vacía, cualquier web que copie tu línea de código puede cargar tu chat y gastar tus créditos. En Agentes › tu agente › Widget › Instalación › Dominios permitidos, escribe el dominio de tu WordPress, pulsa Añadir y después Guardar cambios. Un dominio como tuempresa.com incluye también www.tuempresa.com.

Si tu web se ve en más de una dirección (un subdominio de pruebas, la dirección temporal que te da tu alojamiento o una dirección de WordPress.com como tunegocio.wordpress.com), añádelas todas, cada una completa: en una dirección que no está en la lista el chat no aparece. Lo explica con detalle limitar el chat a tus dominios.

Si el chat no aparece

En WordPress lo más habitual es la caché: vacíala y vuelve a mirar en una ventana privada. Después comprueba que el agente está activo y que tu dominio está en Dominios permitidos. La lista completa, con cómo comprobar cada causa, está en el chat no aparece en tu web.