About this plugin
Sparxio is a free AI chatbot for WordPress that answers customer questions 24/7 — using your own website content, FAQs and documents. Add your AI key, teach it about your business, and it starts helping visitors in minutes: answering questions, capturing leads, and guiding people toward a purchase, a booking or an enquiry.
You use your own API key from OpenAI (ChatGPT), Anthropic (Claude), Google Gemini or 7 other providers, so you pay the provider directly — no Sparxio subscription, no per-message markup, no middleman.
How it works
- Connect your AI — paste an API key from OpenAI, Claude, Gemini, DeepSeek, OpenRouter (free models available) or another provider.
- Teach it your business — add FAQs, upload PDF/DOCX/TXT files, or import pages and your sitemap into the knowledge base.
- Go live — the chat widget appears on your site automatically. Visitors get instant answers; you get the leads and chat logs.
Perfect for
- Customer support — answer common questions instantly, day and night, and reduce support emails
- Lead generation — collect names, emails and phone numbers right inside the chat
- Small businesses and local shops — share opening hours, services, prices and contact details accurately
- Agencies and freelancers — set up a branded AI assistant for client sites in minutes
- Online stores — product questions and order help (WooCommerce features in Sparxio Pro)
- Multilingual sites — the AI replies in the visitor’s language, and the widget interface ships in 30 languages
Why Sparxio
- Free and fully working — no message limits, no time limits, no license key needed
- Bring your own AI key — full control of cost; most conversations cost a fraction of a cent
- Answers from your content — grounded in your knowledge base, not generic replies
- Doesn’t make things up — “Only answer from what you know” (on by default) stops the bot inventing phone numbers, prices or policies
- Fast and lightweight — loads after your page, isolated with Shadow DOM, no theme conflicts, mobile-friendly
Free features
- 10 AI providers — OpenAI (ChatGPT / GPT), Anthropic (Claude), Google Gemini, xAI (Grok), DeepSeek, Mistral, Groq, OpenRouter (hundreds of models, including free ones), a local Ollama model, or any OpenAI-compatible API (Together, Fireworks, Cerebras, Perplexity, LM Studio…). Use any model ID, including newer ones
- Backup AI provider — if the main provider fails, a backup answers automatically, so your chatbot never goes silent
- Unlimited knowledge base — FAQs, documents (PDF, DOCX, TXT, MD, CSV), web pages and whole sitemaps
- Lead capture & CSV export — collect contact details in the chat, manage them in Sparxio → Leads, export to CSV
- Chat logs — read every conversation, with device and page (and country behind Cloudflare)
- Full branding control — colour presets or your own colours, header icon, brand name, greeting and CTA button. No “powered by” link unless you add one
- 30-language widget — English, Arabic, Chinese, Dutch, French, German, Hindi, Italian, Japanese, Korean, Polish, Portuguese, Russian, Spanish, Turkish, Ukrainian and more, with browser language auto-detection
- OpenRouter model browser — search live models, free ones first, with prices
- Ready-made prompt templates — e-commerce, SaaS, travel, healthcare, education and real estate
- Cost controls — history limits, rolling summaries and session timeouts keep API usage low
- Dashboard and setup guide — activity at a glance and a live checklist that walks you through setup
Sparxio Pro (optional, separate plugin)
Everything above is free. For stores and teams that want more, Sparxio Pro adds:
- WooCommerce AI chatbot — product search with product cards, add to cart, and verified order-status lookups in the chat
- Live chat agent takeover — jump into any conversation in real time, then hand it back to the AI
- Advanced analytics — conversations, leads, top questions, and revenue from orders placed after a chat
- Proactive engagement & office hours — greet visitors by time on page, scroll or exit intent
Learn more about Sparxio Pro
External Services
This plugin contacts the third-party services below only when you configure or choose them. Nothing is sent to any third party unless you add an AI provider key, or opt in to Freemius when activating the plugin.
AI providers. When a visitor sends a chat message, the plugin sends that message, the recent conversation history, your system prompt, and any matching knowledge-base excerpts to the AI provider you selected in AI Settings, using your own API key. Nothing is sent until you add a key and select a provider.
Only the selected provider is contacted — plus the backup provider you may choose in AI Settings, and only when the selected one fails.
- Anthropic API (api.anthropic.com) — used when Anthropic is the selected or backup provider. Terms / Privacy
- OpenAI API (api.openai.com) — used when OpenAI is the selected or backup provider. Terms / Privacy
- Google Gemini API (generativelanguage.googleapis.com) — used when Gemini is the selected or backup provider. Terms / Privacy
- DeepSeek API (api.deepseek.com) — used when DeepSeek is the selected or backup provider. Terms / Privacy
- OpenRouter API (openrouter.ai) — used when OpenRouter is the selected or backup provider. OpenRouter forwards the request to the model you choose (and to your backup models, if set). Your site URL and site name are also sent as attribution headers. When OpenRouter is selected or has a key and an administrator opens AI Settings, the public model list (openrouter.ai/api/v1/models) is fetched, without a key or any site data, and cached for six hours. Terms / Privacy
- xAI API (api.x.ai) — used when xAI (Grok) is the selected or backup provider. Terms / Privacy
- Mistral AI API (api.mistral.ai) — used when Mistral is the selected or backup provider. Terms / Privacy
- Groq API (api.groq.com) — used when Groq is the selected or backup provider. Terms / Privacy
- Custom OpenAI-compatible endpoint — used when “Custom” is the selected or backup provider. Requests go only to the address you enter (for example Together, Fireworks, Cerebras, Perplexity, or your own LM Studio / vLLM server); that service’s own terms and privacy policy apply.
- Ollama (your own server, default http://localhost:11434) — used when Ollama is the selected or backup provider. Requests go only to the Ollama server address you enter; no third party is contacted.
Other services.
- Freemius (api.freemius.com) — only if you choose to opt in when activating the plugin (you can skip it). Sends your site URL, WordPress and plugin versions, and your admin name and email, so you can receive optional security and feature notices and manage a Pro license. Terms / Privacy
Knowledge base imports. When you import a web page or sitemap, your site fetches that address (and the pages a sitemap lists) directly. Only the address you enter is requested; downloads are size-limited and private/internal addresses are refused.
Cookies and browser storage. The widget keeps the conversation in this browser according to your Chat Persistence setting (memory only, this tab, or this browser). A sparxio_seen cookie remembers returning visitors.
On WooCommerce stores with Sparxio Pro, a sparxio_attr cookie (a signed conversation number, not the conversation itself), set once the visitor has sent a message, lets an order placed later be counted as chat-assisted.
No data is sent to any AI service until you enter an API key and a visitor starts a chat. The plugin does not look up visitor locations with any outside service. API keys are stored in your own WordPress database.
Payments, licensing, and Pro updates are handled by our partner Freemius (checkout, invoicing, and license management). See the Freemius Privacy Policy.
Source Code and Build
This plugin ships its complete, human-readable source. No build step, bundler, or minifier is used.
- assets/js/widget.js — the chat widget script. This is the original hand-written source (written by hand; it is not minified).
- All admin scripts in assets/js/ are likewise plain, hand-written source.
Bundled third-party code: the Freemius SDK (vendor/freemius, GPL), used for opt-in usage analytics and to offer the optional Pro version. com/Freemius/wordpress-sdk. org/) for its analytics charts.
The widget uses your visitors’ system fonts, so no web fonts are downloaded.