Cómo instalar un chatbot en WordPress: guía paso a paso con el plugin Agentia Chat

Actualizado el 7 de octubre de 2026 · Revisado por Alejandro Díaz, CEO de Agent IA SAS

Si te preguntas cómo instalar un chatbot en WordPress, la respuesta corta es esta: entras al escritorio con un usuario administrador, vas a Plugins, añades uno nuevo, buscas el plugin del chatbot, pulsas Instalar ahora y luego Activar. Después conectas el plugin con la cuenta del servicio, ajustas el aspecto del chat y escribes las instrucciones con las que va a responder. Con Agentia Chat, el plugin de SoyAgentia, son cinco pasos y no hay que tocar el código del tema.

Esta guía sigue el flujo real del plugin, publicado en el directorio de WordPress.org: requisitos, instalación, inicio de sesión, diseño, instrucciones y verificación final, más los errores típicos y qué hacer si cambias de dominio o quieres desconectarlo. Si todavía estás evaluando qué tipo de chatbot necesitas, empieza por la página del chatbot para WordPress.

Prueba el agente ahora por WhatsApp Escríbenos y te responde el mismo agente, sin formularios.

Antes de empezar: requisitos para instalar el chatbot

Revisa cuatro cosas antes de abrir el escritorio. La versión: la ficha del plugin pide WordPress 5.0 o superior y PHP 7.4 o superior, y ambas aparecen en Herramientas > Salud del sitio, en la pestaña de información. El usuario: necesitas permisos de administrador, que por defecto es el rol que instala plugins. El alojamiento: si tu sitio está en WordPress.com, instalar plugins depende del plan que tengas allí; en un hosting propio lo normal es que puedas hacerlo desde el escritorio.

La cuarta es la cuenta. El plugin es el conector entre tu sitio y el servicio de SoyAgentia, así que necesitas una cuenta activa con plan de pago y su correo y contraseña a mano. Como cada empresa vincula un solo sitio, conviene instalarlo en el dominio definitivo y no en una copia de desarrollo.

Ten lista también la información con la que el chatbot va a responder: servicios, precios, horarios, políticas y preguntas frecuentes. No hace falta pulirla antes de instalar, porque el asistente de configuración del panel te ayuda a redactarla, pero sin ella el chat no tiene qué decir.

WordPress 5.0 o superior y PHP 7.4 o superior.
Usuario con rol de administrador.
Permiso para instalar plugins en tu alojamiento.
Cuenta activa de SoyAgentia con plan de pago.
Dominio definitivo del sitio.

Paso 1: instala y activa el plugin Agentia Chat

En el escritorio de WordPress, abre el menú Plugins y entra en la opción para añadir uno nuevo; según la versión aparece como Añadir nuevo o Añadir nuevo plugin. En el buscador escribe «Agentia Chat», ubica el plugin publicado por Agent IA S.A.S y pulsa Instalar ahora. Cuando termine, el mismo botón cambia a Activar: púlsalo. Es el procedimiento estándar que describe la documentación de WordPress sobre plugins.

Si prefieres partir del archivo, descárgalo desde la ficha de Agentia Chat en WordPress.org, vuelve a la pantalla de añadir plugins, elige Subir plugin, selecciona el archivo .zip y actívalo al terminar. Al activarlo aparece un menú nuevo, Agentia Chat, en la barra lateral del administrador. En el sitio público todavía no se ve nada: falta conectar la cuenta.

Paso 2: inicia sesión con tu cuenta de SoyAgentia y vincula el sitio

Entra al menú Agentia Chat. La pantalla de bienvenida pide el correo y la contraseña de tu cuenta de SoyAgentia; escríbelos y pulsa Iniciar sesión. En ese momento el plugin envía también la dirección de tu sitio y el sistema le asigna una clave única: desde ahí tu WordPress queda vinculado a tu panel.

Con la cuenta activa verás el tablero del plugin con el estado Asistente activo, un bloque Flujo activo para elegir la configuración de IA que usará el sitio y un resumen de actividad. Elige el flujo, pulsa Guardar y abre tu sitio en otra pestaña: la burbuja del chat ya debe aparecer en las páginas públicas.

Hay tres respuestas distintas que conviene reconocer. Si la cuenta tiene el pago pendiente, el plugin lo indica y muestra el enlace para completarlo. Si está suspendida, el tablero lo avisa y el chat no se muestra hasta reactivar el plan. Y si el inicio de sesión se rechaza con el aviso de que la cuenta ya está vinculada a otro sitio WordPress, es porque cada empresa conecta un solo sitio: desvincula el anterior o actualiza la URL desde el panel antes de volver a intentarlo.

Paso 3: personaliza el widget desde el panel de SoyAgentia

El aspecto del chat no se configura dentro de WordPress sino en el panel de SoyAgentia, y el plugin tiene un acceso directo: el botón Gestionar mi cuenta abre el panel sin pedirte de nuevo la contraseña. Allí, en la configuración de tu sitio WordPress, defines el mensaje de bienvenida, el color del chat y la posición del widget, abajo a la derecha o abajo a la izquierda.

Tres criterios prácticos. El color se usa de fondo en la burbuja, el encabezado y los botones, con letras blancas encima: elige un tono que se lea bien con texto blanco. La posición depende de lo que ya tienes en pantalla: si en la esquina derecha hay un botón de WhatsApp o un aviso de cookies, pasa el chat a la izquierda. Y el mensaje de bienvenida debe decir qué puede resolver el chat, no solo saludar.

Compara el mensaje que viene por defecto, «¡Hola! ¿En qué puedo ayudarte?», con este: «Hola, soy el asistente de Academia Lumen. Te ayudo con horarios, precios e inscripciones de los cursos. ¿Qué quieres saber?». El segundo le dice al visitante qué puede preguntar y reduce las conversaciones que empiezan con un «hola» y terminan ahí.

Paso 4: escribe las instrucciones del agente en el panel

El chatbot responde con las instrucciones del canal WordPress que guardas en el panel; no lee el contenido de tu sitio por su cuenta. Para escribirlas, el panel tiene un asistente de configuración que te pregunta qué hace tu empresa y qué esperas del agente, y redacta una primera versión. Tu trabajo es revisarla con ojos de cliente: ¿están los precios vigentes?, ¿dice qué hacer cuando no sabe algo?, ¿indica a dónde enviar a quien quiere hablar con una persona?

Si ya configuraste el agente para WhatsApp u otro canal, el asistente puede copiar esas instrucciones al canal WordPress. Revisa después lo que no aplica en la web, como las menciones a pagos o citas que solo existen en WhatsApp. Una estructura que funciona para un sitio de servicios:

Quién eres: nombre del negocio, qué haces, dónde y para quién.
Qué ofreces: servicios o productos, precios o rangos, condiciones y vigencia de promociones.
Cómo operas: horarios, sedes, tiempos de respuesta, medios de pago y políticas de cambios o cancelación.
Preguntas frecuentes con su respuesta exacta, escritas como las hacen tus clientes.
Límites: lo que no debe responder ni prometer, como diagnósticos, descuentos no autorizados o fechas que no controlas.
Salida humana: tu WhatsApp, tu correo o tu teléfono y el horario en que alguien responde.

Paso 5: verifica el chat como si fueras un visitante

Abre tu sitio en una ventana de incógnito o en otro navegador, para verlo como un visitante y no como administrador. Pulsa la burbuja: el chat pide nombre y correo antes de empezar, con el aviso «Antes de comenzar, necesitamos unos datos». Completa los datos con un correo tuyo, inicia el chat y confirma que aparece tu mensaje de bienvenida.

Después haz las diez preguntas que más recibe tu negocio, escritas como las escribiría un cliente apurado: con abreviaturas, con dos preguntas en un mensaje y con una pregunta sobre algo que no vendes. Anota cada respuesta incorrecta o incompleta y corrige las instrucciones; la causa casi siempre es un dato que falta o una regla que nadie escribió.

Por último, revisa el otro lado. En el panel de SoyAgentia deben aparecer la conversación en el centro de mensajes y el lead con tu nombre y correo en el CRM; en el tablero del plugin, dentro de WordPress, deben haber cambiado los contadores de respuestas de hoy y de clientes únicos. Repite la revisión desde un celular, donde la burbuja compite por espacio con otros botones.

Cómo instalar un chatbot en WordPress sin tropiezos: problemas frecuentes y soluciones

Casi todos los problemas de instalación tienen una causa sencilla. Estos son los casos típicos:

Síntoma	Causa probable	Qué hacer
La burbuja no aparece en el sitio	La cuenta no está conectada o activa, o una caché sirve una versión anterior de la página	Revisa el estado en el menú Agentia Chat y vacía la caché de tu plugin de caché o de tu hosting
El inicio de sesión dice que la cuenta ya está vinculada a otro sitio	Tu cuenta tiene registrada otra dirección y cada empresa conecta un solo sitio	Desvincula el sitio anterior o actualiza la URL en el panel y vuelve a iniciar sesión
El plugin muestra pago pendiente o cuenta suspendida	El plan no está activo	Completa o reactiva el pago y recarga la página del plugin
La burbuja tapa otro botón	Dos elementos flotantes en la misma esquina	Cambia la posición del chat desde el panel
El chat responde datos viejos o inventa	Instrucciones desactualizadas o sin regla para cuando falta un dato	Actualiza las instrucciones y agrega la regla de no responder lo que no está escrito
No ves el menú Agentia Chat	Tu usuario no es administrador o el plugin no está activado	Entra con un administrador y revisa la lista de plugins instalados

Cambiar de dominio, desconectar o desinstalar el chatbot

Si migras el sitio a otro dominio, primero edita la URL del sitio en la configuración de WordPress del panel de SoyAgentia y después instala el plugin en el sitio nuevo; así conservas el historial y la configuración. Si instalas primero, el inicio de sesión se rechazará porque tu cuenta sigue asociada a la dirección anterior.

Para desconectar el plugin sin desinstalarlo, usa Cerrar sesión en el tablero de Agentia Chat: según la ficha del plugin, eso borra las credenciales guardadas en WordPress y no afecta tu cuenta de SoyAgentia. Para quitarlo del todo, desactívalo y elimínalo desde la pantalla de plugins, como cualquier otro. Las conversaciones y los leads no viven en tu WordPress sino en el panel, y si un visitante pide que se eliminen sus datos, la ficha del plugin indica cómo solicitarlo.

Después de instalar: qué revisar la primera semana

Los primeros días muestran qué pregunta de verdad tu público, que rara vez coincide con lo que imaginabas. Dedica un rato diario a leer las conversaciones en el centro de mensajes del panel; la bandeja es de solo lectura, así que su función es aprender, no responder. Cada pregunta mal resuelta es una línea que falta en las instrucciones.

Organiza también el tablero del CRM: crea las columnas que reflejan tu proceso, asigna un responsable para los leads de la web y decide en cuánto tiempo se contacta a cada uno, porque el chat no envía seguimientos automáticos. Las guías para captar leads en tu sitio web y para la atención al cliente en tu página web profundizan en cada frente, y la página del agente de IA para WordPress resume el canal completo.

Sigue leyendo

Preguntas frecuentes

¿Hay que pegar algún código en el tema o en el encabezado del sitio para que aparezca el chat?

No. El plugin agrega el widget por su cuenta en las páginas públicas del sitio, sin que edites archivos del tema, el encabezado ni el pie de página, y sin copiar fragmentos de script. Lo que controla la aparición del chat es el estado del plugin y de tu cuenta: con el plugin activo y la cuenta activa, la burbuja se muestra en todo el sitio; si desactivas el plugin, desaparece. Si usas un plugin de caché, vacíala después de conectar la cuenta.

¿Puedo instalar el chatbot si mi sitio está alojado en WordPress.com?

Depende del plan. En WordPress.com, la posibilidad de instalar plugins de terceros está ligada al plan contratado, así que revisa en tu cuenta si el tuyo la incluye antes de comprar nada. Si tu sitio usa WordPress en un hosting propio o administrado, la instalación se hace desde el escritorio como con cualquier plugin. En ambos casos el resto de requisitos no cambia: WordPress 5.0 o superior, PHP 7.4 o superior y una cuenta activa de SoyAgentia.

¿Cómo se actualiza el plugin Agentia Chat cuando sale una versión nueva?

Como cualquier plugin del directorio de WordPress.org: el escritorio te avisa en Escritorio > Actualizaciones y en la lista de plugins instalados, y desde ahí lo actualizas. También puedes activar las actualizaciones automáticas de ese plugin en la pantalla de plugins, una función que WordPress incluye desde la versión 5.5. Antes de actualizar cualquier plugin, la documentación de WordPress recomienda tener una copia de seguridad reciente del sitio.

¿Qué pasa con las conversaciones si desactivo el plugin?

No se borran. Las conversaciones, los datos de los visitantes y los leads se guardan en el panel de SoyAgentia, no en tu base de datos de WordPress, así que siguen disponibles en el centro de mensajes y en el CRM. Al desactivar el plugin, el chat deja de mostrarse en tu sitio, y el plugin conserva su configuración local para que no empieces de cero si lo reactivas. Si lo que quieres es quitar la conexión con tu cuenta, usa Cerrar sesión en su tablero.

¿Puedo instalar el chatbot en un sitio de desarrollo antes de publicarlo?

El plugin se instala igual, pero ten en cuenta la regla de un sitio por empresa: al iniciar sesión, el plugin registra la dirección del sitio en tu cuenta, y el sitio definitivo será rechazado mientras esa dirección no cambie. Si conectas primero la copia de desarrollo, actualiza la URL del sitio en el panel antes de instalar el plugin en el dominio final. Así conservas la configuración y las instrucciones que ya ajustaste.

¿El chat aparece también dentro del administrador de WordPress?

No. El widget solo se carga en las páginas públicas del sitio. Dentro del administrador ves el tablero del plugin, con el flujo activo, las respuestas de hoy y del mes, los clientes únicos, la actividad de los últimos 30 días y los últimos clientes. Para leer las conversaciones completas o gestionar los leads, usa el botón Gestionar mi cuenta, que abre el panel de SoyAgentia sin volver a iniciar sesión.