Chatbot conversacional con conocimiento de tus archivos y catalogo WooCommerce. Multi-proveedor con failover.
Inicio rapido
aGo AI Chatbot es un widget de chat para WordPress. El visitante pregunta, el bot responde con conocimiento de tus archivos (PDF, TXT, CSV, MD, JSON) y de tu catalogo WooCommerce. Cuando no puede responder, abre un formulario que recolecta el contacto del visitante y lo envia a tu email con la transcripcion completa.
En 90 segundos
Compra una licencia en store.ago.cl (USD 29.9 pago unico, lifetime, 3 sitios).
Instala el ZIP en Plugins → Anadir → Subir plugin.
Activa el plugin. Veras la pantalla de licencia con un candado.
Pega tu clave de licencia y pulsa Activar.
En Proveedores de IA agrega Gemini con una API key gratis de Google AI Studio.
Sube uno o varios archivos en Conocimiento.
Activa el switch verde. El chat aparece en el frontend.
Instalacion
Requisitos
WordPress 6.0 o superior.
PHP 8.1 o superior.
Licencia Pro activa.
Al menos una API key de un proveedor de IA. Google AI Studio entrega keys gratis al instante en aistudio.google.com/app/apikey.
Coexistencia con el Lite
Si tienes instalado el plugin gratuito ago-ai-chatbot de WP.org, el Pro lo detecta y el Lite se hace a un lado con un aviso. Los settings y archivos no se pierden.
Proveedores de IA (multi-proveedor con failover)
Configuras una lista ordenada de proveedores. El plugin intenta el primero, si falla pasa al siguiente automaticamente. El visitante nunca ve un error si al menos uno responde.
Proveedores soportados: Google Gemini, OpenAI, Anthropic Claude, Groq, Cohere.
Como agregar un proveedor
Pulsa + Anadir proveedor.
Elige proveedor, pega API key.
Pulsa Refrescar: el plugin llama a la API del proveedor y muestra los modelos disponibles agrupados por costo.
Pulsa Probar conexión: el pill superior derecho debe quedar verde.
Marca Activado y guarda.
Base de conocimiento
El bot solo sabe lo que tu le ensenes. Sube documentos en PDF, TXT, CSV, Markdown o JSON. Cuando el visitante pregunta, el plugin calcula el embedding de la pregunta (modelo gemini-embedding-001, 3072 dimensiones), busca por similitud coseno los chunks mas relevantes, e inyecta solo esos fragmentos como contexto al LLM.
Resultado: respuestas con tu conocimiento, sin enviar el documento completo en cada llamada (costo bajo) y sin alucinar fuera de tu material.
WooCommerce
Si tienes WooCommerce, el plugin indexa tu catalogo completo: nombre, precio, stock, URL, descripcion, categorías. El bot responde preguntas como "que cursos tienen", "cuanto cuesta el taller", "tienen algo sobre X". Si lo que pregunta no esta, abre el form de captura.
El plugin detecta dos momentos para mostrar el formulario:
Despues de N mensajes: configurable, minimo 2 mensajes para no ser invasivo.
Cuando el bot no puede responder: el modelo agrega [CANT_HELP] al final, el plugin lo detecta, lo borra del texto visible y abre el form. Ningun lead se pierde.
Form inline
El form aparece como tarjeta dentro del chat, no centrada bloqueando todo. Pide nombre y email; opcional telefono.
Que pasa al enviar
El lead se guarda en BD con su conversacion vinculada.
Email al admin con todos los datos, transcripcion completa y links al admin.
Badge rojo en menu lateral.
Lista en aGo Herramientas → Leads con filtros y export CSV.
Widget en el frontend
Burbuja flotante en la esquina inferior. Posicion (izq/der), desplazamiento vertical (3 niveles para no chocar con otros botones flotantes), color, avatar (URL o Media Library), nombre del bot, mensaje de bienvenida, tono.
Header del widget abierto: silenciar voz, nueva conversacion, cerrar. Respeta prefers-color-scheme: dark automaticamente.
Boton WhatsApp
Boton flotante verde opcional junto al chat. Abre wa.me/[numero] con mensaje precargado en nueva pestaña. Se apila correctamente con el chat sin solapar.
Config: numero internacional completo (ej. +56912345678), mensaje precargado, posicion.
Voz (Web Speech API)
Dos botones opcionales:
Microfono: visitante habla, browser convierte voz a texto y envia.
Altavoz: bot lee respuestas en voz alta. Silenciable desde el header.
Todo corre en el browser (Web Speech API nativa). Sin servicio externo, el audio nunca sale del dispositivo, sin costo. Chrome, Edge, Safari. Firefox limitado.
Marca blanca
Para agencias. Oculta firma aGo Lab y la cambias por la tuya:
Logo (URL o Media Library).
Titulo personalizado.
CSS personalizado: se inyecta solo cuando el widget se renderiza. Etiquetas HTML eliminadas por seguridad.
Ocultar credito aGo Lab.
Licencia (LemonSqueezy)
El Pro requiere licencia activa. Sin licencia: widget no se renderiza, paneles admin con candado.
Activacion
Compra en store.ago.cl.
Recibes clave por email.
Pega la clave en el splash y pulsa Activar.
Modelo de licencia
Pago único de USD 29.9. La licencia es lifetime: una sola compra, sin suscripción, sin renovación. Incluye 3 sitios WordPress simultáneos y actualizaciones automáticas mientras el producto esté mantenido.
Gestion
Gestionar mis licencias → app.lemonsqueezy.com/my-orders. Puedes desactivar un sitio y activar otro desde el panel.
Periodo de gracia
Si la validación con LemonSqueezy falla (red, downtime), el plugin sigue funcionando 14 días con banner informativo, luego reintenta.
Resiliencia
Si LemonSqueezy esta inaccesible, el plugin honra la ultima validacion hasta 7 dias. No te quedas sin chat por downtime de terceros.
Auto-updates
El plugin chequea cada 12 horas si hay nueva version en ago.cl/updates/ago-ai-pro.json. Si hay, aparece la notificacion estandar de WP en Plugins → Plugins instalados.
Al pulsar "Actualizar ahora", WP descarga el ZIP nuevo y reemplaza el plugin sin perder configuración, archivos, conversaciones, leads ni indexado.
Lite vs Pro
El Lite vive en WP.org y es 100% funcional como chatbot Gemini single-provider. El Pro suma capacidades nuevas, no es un trial.
No. El bot esta entrenado para nunca decir "te conecto con un humano". Cuando no puede responder, ofrece tomar los datos del visitante para que el equipo escriba por email despues.
Mis API keys salen del sitio?
No. La key se guarda enmascarada en tu BD y solo se usa server-side. El frontend nunca la ve. El plugin no envia datos a aGo Lab.
Que pasa si un proveedor se cae?
Con failover configurado, el plugin pasa al siguiente sin que el visitante note. Con un solo proveedor, el bot responde con error generico y abre el form de captura para no perder el contacto.
Cuanto cuesta operar?
Con gemini-2.0-flash-lite en el free tier de Google y trafico moderado, casi cero. Modelos premium escalan con uso.
Funciona con Bricks / Elementor / Divi?
Si. El widget se inyecta via wp_footer, independiente del page builder.
Donde se guardan las conversaciones?
En tu BD WP. Las IPs se hashean con SHA-256 (privacy by design). Politica de retencion configurable (default 90 dias) con purga automática.
Como contacto soporte?
Email a soporte@ago.cl. Respondemos en menos de 24 horas habiles. Incluye URL del sitio y version del plugin.
