Conversational chatbot with knowledge of your files and WooCommerce catalog. Multi-provider with failover.
Quick start
aGo AI Chatbot is a chat widget for WordPress. The visitor asks, the bot answers using knowledge from your files (PDF, TXT, CSV, MD, JSON) and your WooCommerce catalog. When it can't answer, it opens a form that captures the visitor's contact details and sends them to your inbox with the full transcript.
In 90 seconds
Buy a license at store.ago.cl (USD 29.9 one-time payment, lifetime, 3 sites).
Install the ZIP at Plugins → Add new → Upload plugin.
Activate the plugin. You'll see the license screen with a padlock.
Paste your license key and click Activate.
In AI Providers add Gemini with a free API key from Google AI Studio.
Upload one or more files in Knowledge.
Toggle the green switch. The chat appears on the frontend.
Installation
Requirements
WordPress 6.0 or higher.
PHP 8.1 or higher.
Active Pro license.
At least one API key from an AI provider. Google AI Studio offers free keys instantly at aistudio.google.com/app/apikey.
Coexistence with Lite
If you have the free ago-ai-chatbot plugin from WP.org installed, Pro detects it and Lite steps aside with a notice. Settings and files are preserved.
AI Providers (multi-provider with failover)
You configure an ordered list of providers. The plugin tries the first one; if it fails, it falls back to the next automatically. The visitor never sees an error as long as at least one responds.
Supported providers: Google Gemini, OpenAI, Anthropic Claude, Groq, Cohere.
How to add a provider
Click + Add provider.
Pick provider, paste API key.
Click Refresh: the plugin calls the provider's API and lists available models grouped by cost.
Click Test connection: the top-right pill should turn green.
Check Enabled and save.
Knowledge base
The bot only knows what you teach it. Upload documents in PDF, TXT, CSV, Markdown or JSON. When the visitor asks, the plugin computes the question's embedding (gemini-embedding-001, 3072 dimensions), runs cosine similarity to find the most relevant chunks and injects only those fragments as context for the LLM.
Result: answers grounded in your knowledge, without sending the whole document on every call (low cost) and without hallucinating outside your material.
WooCommerce
If you run WooCommerce, the plugin indexes your full catalog: name, price, stock, URL, description, categories. The bot answers questions like "what courses do you offer", "how much is the workshop", "do you have anything about X". If what's asked isn't there, it opens the capture form.
After N messages: configurable, minimum 2 messages to avoid being intrusive.
When the bot can't help: the model appends [CANT_HELP] at the end; the plugin detects it, strips it from the visible text and opens the form. No lead is lost.
Inline form
The form appears as a card inside the chat, not as a centered overlay blocking everything. It asks for name and email; phone is optional.
What happens on submit
The lead is stored in the DB linked to its conversation.
Email to admin with full details, complete transcript and deep-links to admin.
Red badge in the side menu.
List under aGo Tools → Leads with filters and CSV export.
Frontend widget
Floating bubble in the bottom corner. Position (left/right), vertical offset (3 levels to avoid clashing with other floating buttons), color, avatar (URL or Media Library), bot name, welcome message, tone.
Open widget header: mute voice, new conversation, close. Respects prefers-color-scheme: dark automatically.
WhatsApp button
Optional green floating button next to the chat. Opens wa.me/[number] with a preloaded message in a new tab. Stacks correctly with the chat without overlapping.
Config: full international number (e.g. +56912345678), preloaded message, position.
Voice (Web Speech API)
Two optional buttons:
Microphone: visitor speaks, browser converts speech to text and sends.
Speaker: bot reads replies out loud. Mutable from the header.
Everything runs in the browser (native Web Speech API). No external service, audio never leaves the device, no cost. Chrome, Edge, Safari. Limited in Firefox.
White-label
For agencies. Hide the aGo Lab signature and replace it with yours:
Logo (URL or Media Library).
Custom title.
Custom CSS: injected only when the widget renders. HTML tags are stripped for security.
Hide aGo Lab credit.
License (LemonSqueezy)
Pro requires an active license. Without a license: the widget doesn't render and admin panels stay locked.
Activation
Buy at store.ago.cl.
Receive your key by email.
Paste the key on the splash and click Activate.
License model
One-time payment of USD 29.9. The license is lifetime: a single purchase, no subscription, no renewal. Includes 3 simultaneous WordPress sites and automatic updates while the product is maintained.
Management
Manage my licenses → app.lemonsqueezy.com/my-orders. You can deactivate one site and activate another from the panel.
Grace period
If validation with LemonSqueezy fails (network, downtime), the plugin keeps working for 14 days with an informational banner and then retries.
Resilience
If LemonSqueezy is unreachable, the plugin honors the last validation for up to 7 days. You don't lose your chat to third-party downtime.
Auto-updates
The plugin checks every 12 hours for a new version at ago.cl/updates/ago-ai-pro.json. If there's one, the standard WP notice appears under Plugins → Installed plugins.
Clicking "Update now" downloads the new ZIP and replaces the plugin without losing configuration, files, conversations, leads or indexing.
Lite vs Pro
Lite lives on WP.org and is 100% functional as a single-provider Gemini chatbot. Pro adds new capabilities, it is not a trial.
No. The bot is trained never to say "I'll put you through to a human". When it can't help, it offers to take the visitor's details so the team can email back later.
Do my API keys leave the site?
No. The key is stored masked in your DB and only used server-side. The frontend never sees it. The plugin doesn't send data to aGo Lab.
What happens if a provider goes down?
With failover configured, the plugin moves to the next one without the visitor noticing. With a single provider, the bot returns a generic error and opens the capture form so the contact isn't lost.
How much does it cost to run?
With gemini-2.0-flash-lite on Google's free tier and moderate traffic, almost zero. Premium models scale with usage.
Does it work with Bricks / Elementor / Divi?
Yes. The widget is injected via wp_footer, independent of the page builder.
Where are conversations stored?
In your WP DB. IPs are hashed with SHA-256 (privacy by design). Retention policy is configurable (default 90 days) with automatic purge.
How do I contact support?
Email soporte@ago.cl. We respond within 24 business hours. Include site URL and plugin version.
