Changeset 3756496

Timestamp:

10/20/2026 10:56:17 AM (21 hours ago)

Author:

haamzaa

Message:

Readme: improved description, tags, FAQ

File:

• sparxio-ai-chatbot/tags/3.7.5/readme.txt (modified) (6 diffs)

sparxio-ai-chatbot/tags/3.7.5/readme.txt

@@ -1 +1 @@
 === Sparxio – AI Chatbot, Live Chat & Lead Generation ===
 Contributors: haamzaa, freemius
-Tags: ai chatbot, live chat, chatbot, woocommerce, lead generation
+Tags: ai chatbot, chatbot, chatgpt, customer support, live chat
 Requires at least: 5.8
 Tested up to: 7.1
@@ -9 +9 @@
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
 
-AI chatbot for WordPress. Use your own Claude, GPT, Gemini, DeepSeek or OpenRouter key. Unlimited knowledge base, lead capture, 30 languages.
+Free AI chatbot that answers your visitors 24/7 from your own content. Use your own ChatGPT, Claude or Gemini key. Lead capture, 30 languages.
 
 == Description ==
 
-Sparxio adds a fully customizable AI-powered chat widget to your WordPress site. Visitors chat with an AI assistant that replies in their own language, answers from your knowledge base, and guides them toward your goals — making a purchase, booking a demo, or submitting an enquiry.
+**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.
 
 https://www.youtube.com/watch?v=NJcJYjQYUNM
 
-You connect your own AI provider with your own API key, so you stay in full control of usage and cost. Nothing is routed through a third-party middleman.
-
-**Why Sparxio**
-
-* Bring your own AI key — no per-message markup, no forced subscription to use the chat
-* Answers grounded in your own content, not generic replies
-* Genuinely multilingual — the interface ships in 30 languages
-* Built for WordPress: Shadow DOM isolation, mobile-optimised, no theme conflicts
-
-**Free Features**
-
-* **10 AI providers** — Anthropic (Claude), OpenAI (GPT), Google Gemini, xAI (Grok), DeepSeek, Mistral, Groq, OpenRouter (hundreds of models), a local Ollama model, or any OpenAI-compatible API (Together, Fireworks, Cerebras, Perplexity, LM Studio…) — with your own key. Use any model ID, including ones released after this version
-* **Never goes silent** — pick a backup AI provider that answers automatically if the main one fails. Requests adapt to each model's options, and a retired model is replaced by a current one (you are told in AI Settings)
-* **Accurate answers** — the bot only states addresses, numbers, prices and policies it was actually given; otherwise it says so instead of guessing
-* **OpenRouter model browser** — search hundreds of live models, free ones first, with prices, plus up to three backup models
-* **Full branding control** — colour presets or custom colours, header icon, brand name, and CTA button. No attribution is shown unless you add your own footer text.
-* **30-language widget UI** — including German, Spanish, French, Italian, Portuguese, Dutch, Polish, Swedish, Danish, Finnish, Norwegian, Greek, Czech, Hungarian, Romanian, Ukrainian, Russian, Arabic, Turkish, Hindi, Chinese, Japanese, Korean, and more
-* **Unlimited knowledge base** — teach the AI from FAQ entries, documents, web pages, and sitemaps so answers reflect your business
-* **Lead capture & CSV export** — collect name, email, and phone inside the chat, then view, manage, and export leads to CSV
-* **Chat logs** — full transcript of every conversation with the visitor's device and page (and country, when your site is behind Cloudflare)
-* **Basic dashboard** — sessions, messages, and activity at a glance
-* **Live typing indicator** — shown the moment a visitor sends a message, until the answer arrives
-* **Cost controls** — history limits, rolling summarisation, and session timeouts keep API usage low
-* **Built-in setup guide** — a live checklist walks you through configuration
-
-**Sparxio Pro (separate plugin)**
-
-Everything above is free and fully functional. For stores and teams that want more, Sparxio Pro is a separate plugin, sold on our website, that adds:
-
-* **WooCommerce chat** — product search, add-to-cart, and verified order-status lookups inside the chat
-* **Live agent takeover** — jump into any conversation in real time, then hand back to the AI
-* **Advanced analytics** — conversations, leads and top questions for a chosen period, plus WooCommerce orders placed after a chat (paid orders only, minus refunds, per currency)
-* **Proactive engagement** — greet visitors based on time on page, exit intent, or the page they are viewing
+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 =
+
+1. **Connect your AI** — paste an API key from OpenAI, Claude, Gemini, DeepSeek, OpenRouter (free models available) or another provider.
+2. **Teach it your business** — add FAQs, upload PDF/DOCX/TXT files, or import pages and your sitemap into the knowledge base.
+3. **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](https://skillssparx.com/sparxio/)
@@ -84 +98 @@
 == Installation ==
 
-1. In your WordPress admin, go to Plugins → Add New and search for "Sparxio", or upload the `sparxio` folder to `/wp-content/plugins/`.
-2. Activate the plugin through the Plugins menu.
-3. Open Sparxio → Setup Guide and follow the live checklist.
-4. Enter your AI provider API key in Sparxio → AI Settings.
-5. Customise the look in Sparxio → Appearance.
-6. The chat widget appears on your site automatically.
+1. In your WordPress admin, go to Plugins → Add New, search for "Sparxio" and click Install Now (or upload the `sparxio-ai-chatbot` folder to `/wp-content/plugins/`).
+2. Activate the plugin.
+3. Go to Sparxio → AI Settings, choose a provider and paste your API key. Click Test Connection.
+4. Add your business information in Sparxio → Knowledge Base (FAQs, files, pages or your sitemap).
+5. Match your brand in Sparxio → Appearance.
+6. Visit your site — the chat widget is live. Sparxio → Setup Guide shows a checklist of anything left to do.
 
 == Frequently Asked Questions ==
 
+= Is Sparxio really free? =
+
+Yes. The plugin is free and fully functional, with no message limits, time limits or license checks. You only pay your AI provider for usage. Sparxio Pro is an optional separate plugin for WooCommerce chat, live agent takeover, advanced analytics and proactive engagement.
+
 = Do I need an API key? =
 
-Yes. Sparxio uses your own key from one of the supported providers (Anthropic, OpenAI, Google Gemini, DeepSeek, OpenRouter, or a local Ollama model). This keeps you in control of usage and cost. Free keys or trials are available from most providers.
-
-= Is the plugin free? =
-
-Yes. This plugin is free and fully functional, with no limits, time restrictions, or license checks. A separate plugin, Sparxio Pro, adds WooCommerce chat, live agent takeover, advanced analytics, and proactive engagement for those who need them.
+Yes. Sparxio uses your own key, so you stay in control of usage and cost. Supported: OpenAI, Anthropic (Claude), Google Gemini, xAI, DeepSeek, Mistral, Groq, OpenRouter, a local Ollama model, or any OpenAI-compatible API.
+
+= Can I use it as a ChatGPT chatbot for my website? =
+
+Yes. Choose OpenAI in AI Settings, paste your OpenAI API key, and pick a GPT model. You can switch to Claude, Gemini or another provider at any time without losing your knowledge base or settings.
+
+= Is there a free AI option? =
+
+Yes. OpenRouter offers free models, and Google Gemini and Groq have free tiers. Free tiers have rate limits set by the provider, so for busy sites a low-cost paid model is recommended.
 
 = How much does the AI cost to run? =
 
-You pay your provider directly for API usage. On the most affordable models this is typically a fraction of a cent per conversation. Built-in history limits, summarisation, and timeouts keep usage low.
+You pay your provider directly. On affordable models this is usually a fraction of a cent per conversation. History limits, summaries and session timeouts keep usage low.
+
+= How do I train the chatbot on my business? =
+
+Open Sparxio → Knowledge Base and add FAQs, upload PDF, DOCX, TXT, MD or CSV files, or import web pages or your whole sitemap. The bot uses this content to answer questions.
+
+= Will the chatbot make things up? =
+
+With "Only answer from what you know" (on by default), the bot only states facts like phone numbers, addresses, prices and policies that you have given it. If it doesn't know, it says so and offers a next step instead of guessing.
+
+= Can it capture leads? =
+
+Yes. Turn on lead capture and the chat asks for name, email and phone after a number of messages you choose. Leads appear in Sparxio → Leads and can be exported to CSV.
 
 = Will it slow down my site? =
 
-No. The widget loads asynchronously after your page content and uses Shadow DOM, so it never conflicts with your theme's CSS or JavaScript.
+No. The widget loads after your page content and runs inside Shadow DOM, so it doesn't conflict with your theme's CSS or JavaScript.
+
+= What languages are supported? =
+
+The AI replies in whatever language the visitor writes in, and the widget interface ships in 30 languages. Set a default language and turn on browser auto-detection in Sparxio → Behavior.
 
 = Does it work with WooCommerce? =
 
-Yes, with Sparxio Pro. The AI can search products, add items to the cart, and look up order status (with identity verification) directly in the chat.
-
-= What languages are supported? =
-
-The widget interface ships in 30 languages and the AI replies in whatever language the visitor writes in. Turn on multi-language, choose a default language, and enable browser auto-detection in Sparxio → Behavior.
+The free plugin works on any WooCommerce site as a support chatbot. Product search, add-to-cart and order-status lookups inside the chat are part of Sparxio Pro.
 
 = Can I customise the AI's personality? =
 
-Completely. Write a system prompt that defines the assistant's identity, tone, knowledge, and rules. Sample templates for e-commerce, SaaS, travel, healthcare, education, and real estate are included.
+Yes. Write a system prompt that sets the assistant's name, tone, knowledge and rules, or start from one of the included templates.
+
+= Is my visitors' data safe? =
+
+API keys are stored in your own database, and messages go only to the AI provider you choose. No visitor location lookup service is used. See External Services above for every connection.
 
 = How do I remove all data when uninstalling? =
 
-By default your data is preserved across reinstalls. To wipe everything on uninstall, enable "Delete all data on uninstall" in Sparxio → AI Settings → Security before removing the plugin.
-
-= Is my visitors' data safe? =
-
-API keys are stored in your database and messages are sent only to the AI provider you choose. No visitor location lookup service is used. See the External Services section above for the full list of connections.
+Data is kept by default. To delete everything, enable "Delete all data on uninstall" in Sparxio → AI Settings → Security before removing the plugin.
 
 == Screenshots ==
@@ -137 +171 @@
 5. Chat logs with search and filtering
 6. Setup Guide with a live progress checklist
+7. Knowledge Base: add FAQs, files, web pages or a sitemap
+8. Leads captured in the chat, with CSV export
+9. Behavior settings: languages, greeting and session options
+10. The chat widget on a mobile screen
 
 == Source Code and Build ==
@@ -142 +180 @@
 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 (short variable names are hand-authored, not the output of a minifier).
+* 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.
 
@@ -215 +253 @@
 
 = 3.7.4 =
-Faster, more reliable replies; current AI models for every provider; new providers (Grok, Mistral, Groq, any OpenAI-compatible API); backup AI provider; answers that don't invent facts. Recommended for all users.
+Faster, more reliable replies; current AI models for every provider; new providers (Grok, Mistral, Grok, any OpenAI-compatible API); backup AI provider; answers that don't invent facts. Recommended for all users.
 
 = 3.7.3 =