aGo AI Chatbot, documentación

Versión del plugin: 1.3.1 · Documentación actualizada: 2026-06-28

aGo AI Chatbot añade a tu sitio WordPress un widget de chat con inteligencia artificial que responde las preguntas de tus visitantes a partir de tus propios archivos de conocimiento (PDF, TXT, CSV, Markdown y JSON). El motor es Google Gemini, con tu propia clave API. Es la edición gratuita y funciona por completo: sin límites de chats, sin tope de archivos, sin registro y sin servidores intermedios de aGo.

Cómo funciona la privacidad. Los mensajes de los visitantes y tus archivos de conocimiento viajan directamente desde tu servidor a Google Gemini, usando tu clave API. El plugin no almacena las conversaciones ni envía datos a aGo Lab. Como titular del sitio, tú decides qué archivos subes y aceptas las condiciones de uso de Google al configurar tu clave.

1. Instalación y activación

1. En tu panel de WordPress ve a Plugins → Añadir nuevo plugin → Subir plugin, elige el ZIP, instala y activa. Como alternativa, sube la carpeta ago-ai a /wp-content/plugins/ por FTP.
2. Consigue una clave API gratuita de Google Gemini en Google AI Studio. La gestionas y la pagas (o usas el nivel gratuito) directamente con Google.
3. Abre aGo Tools → AI Chatbot en el menú lateral del admin.

El plugin no necesita ninguna cuenta ni servidor de aGo. Toda la inteligencia corre con tu clave de Gemini.

2. Configuración inicial

En aGo Tools → AI Chatbot completa, en este orden, la tarjeta General:

• Activar Chatbot. Marca esta casilla para mostrar el widget en el frontend. El widget solo aparece si está activado y hay una clave API guardada.
• Clave API de Gemini. Pega tu clave y guarda. Al guardar una clave nueva, el plugin la valida contra la API de Gemini antes de almacenarla: si es incorrecta, la rechaza con el mensaje de error real en lugar de guardarla en silencio. La clave se muestra enmascarada (********) una vez guardada.
• Modelo. Elige el modelo de Gemini que usará el bot. Pulsa Refrescar modelos para que el selector liste todos los modelos de texto Lite, Flash y Pro disponibles para tu clave. Cada modelo indica su nivel de costo (menor costo, costo medio, mayor calidad). Flash Lite es el más económico; Flash es más capaz. Verifica los precios en ai.google.dev/pricing.

Cuando termines de configurar todas las tarjetas, pulsa Guardar ajustes al final de la página.

3. Personalidad del bot

En la tarjeta Personalidad defines cómo se presenta y cómo escribe el asistente:

• Nombre del bot. El nombre que aparece en el widget. Si lo dejas vacío, se usa “Asistente”.
• Mensaje de bienvenida. El saludo inicial que ve el visitante al abrir el chat.
• Estilo de respuesta. Controla la forma de escribir del bot: amigable con emojis (recomendado), amigable sin emojis, profesional o formal.
• Tono. Amigable, profesional, casual o formal. El tono casual hace que el bot escriba de forma más relajada y cercana.
• Prompt de sistema. Instrucciones libres para afinar el comportamiento: industria, audiencia, reglas, temas en los que enfocarse. Es el campo donde le explicas al bot qué debe saber y cómo comportarse.
• Avatar. Imagen del bot en el widget (JPG, PNG o WebP, máximo 1 MB, recomendado 96x96 px). Si no subes ninguna, se usa el avatar por defecto.

Por defecto el bot está instruido para responder solo con la información de tus archivos de conocimiento. Si un visitante pregunta algo fuera de tema, lo redirige con amabilidad. Puedes suavizar o reforzar este comportamiento con el prompt de sistema.

4. Base de conocimiento

En la tarjeta Base de conocimiento subes los archivos con los que el bot responderá. Formatos admitidos: PDF, TXT, CSV, Markdown (.md) y JSON. El número de archivos es ilimitado.

• Selecciona un archivo y pulsa Subir. El plugin lo envía a Google Gemini.
• La primera subida crea automáticamente un File Search Store (almacén de búsqueda de archivos) de Gemini asociado a tu sitio. Los documentos se indexan una sola vez, y en cada consulta solo se envían al modelo los fragmentos relevantes, lo que mantiene bajo el costo de tu API.
• Cada archivo aparece en la tabla con su nombre, tipo y fecha. Puedes eliminarlo desde ahí; al borrar el último archivo, el plugin elimina también el almacén en Gemini.

Esta base de conocimiento es la fuente de las respuestas: el bot se apoya en tus documentos en lugar de inventar información a partir de datos genéricos de entrenamiento.

5. Apariencia del widget

En la tarjeta Apariencia del widget ajustas dónde y cómo se ve el chat:

• Posición. Abajo a la derecha o abajo a la izquierda.
• Posición vertical. Estándar, un nivel arriba (+80 px) o dos niveles arriba (+160 px), para que el widget no se superponga a otros botones flotantes (por ejemplo, WhatsApp).
• Color. Color principal del widget.

El widget es responsivo y se adapta a pantallas pequeñas. Se inserta mediante wp_footer, así que funciona con cualquier tema y constructor de páginas (Elementor, Divi, Bricks, Beaver Builder, Gutenberg o clásico) sin tocar el tema.

6. Límites y notificaciones

En la tarjeta Límites y notificaciones controlas el consumo de tu cuota de Gemini:

• Máximo de tokens de entrada. Por mensaje (por defecto 1000).
• Máximo de tokens de salida. Por respuesta (por defecto 1000).
• Límite de frecuencia. Mensajes por minuto y por IP (por defecto 60). No es un tope de uso del plugin: es una protección antiabuso que evita que una sola IP inunde tu cuota de Gemini con solicitudes automatizadas. Si un visitante supera el límite, recibe un aviso para esperar un momento y reintentar.

7. El widget en el sitio

Una vez activado el chatbot y guardada la clave API, el widget aparece en todas las páginas del frontend. El visitante abre el chat, escribe su pregunta y el bot responde apoyándose en tus archivos de conocimiento.

• El bot responde en el mismo idioma en que escribe el visitante.
• Las conversaciones no se almacenan: el plugin no guarda el historial de chats en tu base de datos.
• Si el bot no encuentra la respuesta en tus archivos, lo dice con honestidad y sugiere usar las opciones de contacto visibles en el sitio (teléfono, correo, formulario).

El plugin no usa shortcodes ni páginas dedicadas: el widget se inyecta de forma global mientras esté activado en los ajustes. El control por página individual está previsto para una versión futura.

8. Idiomas de la interfaz

El bot conversa en el idioma que use cada visitante. La interfaz de administración del plugin está disponible en español, inglés y portugués (Brasil), y sigue el idioma configurado en tu perfil de usuario de WordPress.

9. Servicio externo: Google Gemini

El plugin se apoya en Google Gemini, un servicio operado por Google, para:

• Generar las respuestas del chat a partir de tus archivos de conocimiento y los mensajes del visitante.
• Subir, almacenar e indexar tus archivos en un File Search Store de Gemini.
• Listar los modelos de Gemini disponibles para tu clave API.

Qué se envía a Google: cada mensaje del visitante y el historial de la conversación mientras el chat está abierto, tus archivos de conocimiento y tu clave API en las cabeceras de la solicitud. No se envía nada sin una acción explícita del administrador (subir un archivo, configurar la clave) o sin que un visitante interactúe con el widget que has activado.

Endpoint base del servicio: https://generativelanguage.googleapis.com/

Al usar el plugin aceptas las condiciones y la política de privacidad de Google:

• Condiciones de la API de Gemini: ai.google.dev/gemini-api/terms
• Política de privacidad de Google: policies.google.com/privacy

El plugin no contacta ningún otro servicio remoto. No se envía ningún dato a aGo Lab. (“Gemini” es una marca de Google LLC. aGo Lab no está afiliado a Google.)

10. Funciones de la versión Pro

Existe un producto complementario de pago, distribuido fuera de WordPress.org desde store.ago.cl, que añade capacidades que esta edición gratuita no incluye. La versión gratuita funciona por completo por sí sola; el Pro es puramente aditivo:

• Historial de conversaciones y búsqueda.
• Formulario de captura de leads dentro del chat.
• Motor de tareas (el bot crea tareas).
• Varios proveedores de IA con conmutación ante fallos (OpenAI, Anthropic, Groq).
• Panel de analítica.
• Entrada y síntesis de voz.
• Derivación a un humano (correo, Slack, Telegram).
• Conocimiento de productos de WooCommerce.
• Widget de marca blanca.

11. Desinstalación

Desactiva y elimina el plugin desde la pantalla de Plugins. Al desinstalarlo, el plugin borra sus opciones de la base de datos. Tus ajustes viven en la base de datos de WordPress y tus archivos de conocimiento residen en Google Gemini bajo tu propia clave API.

12. Soporte

aGo AI Chatbot es un plugin gratuito de código abierto bajo licencia GPL-2.0+.

Foro de soporte oficial: https://wordpress.org/support/plugin/ago-ai-chatbot/

Las dudas, reportes de bugs y solicitudes de mejora se atienden en ese foro. Respondemos según disponibilidad: el plugin es de código abierto bajo licencia GPL-2.0+ y atendemos la comunidad cuando podemos.

No damos soporte por correo electrónico para la versión gratuita. Para uso comercial con soporte directo y SLA, próximamente lanzaremos planes de suscripción anual y lifetime.

Este plugin ofrece un asistente de chat con IA que se apoya en tus propios archivos de conocimiento. La calidad de las respuestas depende de tus documentos, del modelo de Gemini elegido y de las instrucciones que configures. El plugin ayuda a atender a tus visitantes, no reemplaza la revisión humana de la información que publicas.