| @@ -1,137 +1,86 @@ | ||
| 1 | -=== MxChat - AI Chatbot & Content Generation for WordPress === | |
| 1 | +=== MxChat - AI Chatbot for WordPress === | |
| 2 | 2 | Contributors: mxchat |
| 3 | 3 | Author: [MxChat](https://mxchat.ai) |
| 4 | -Tags: ai chatbot, chatgpt, woocommerce, customer support, content generation | |
| 4 | +Tags: AI, Chatbot, ChatGPT, Live Chat, Live Support | |
| 5 | 5 | Requires at least: 5.0 |
| 6 | -Tested up to: 7.0.1 | |
| 6 | +Tested up to: 6.8 | |
| 7 | 7 | Requires PHP: 7.2 |
| 8 | -Stable tag: 3.2.15 | |
| 8 | +Stable tag: 2.4.1 | |
| 9 | 9 | License: GPLv2 or later |
| 10 | 10 | License URI: https://www.gnu.org/licenses/gpl-2.0.html |
| 11 | 11 | |
| 12 | -Free AI chatbot and content generation for WordPress. Train ChatGPT, Claude, Gemini or Grok on your content. WooCommerce ready with RAG. | |
| 12 | +AI chatbot with OpenAI, Gemini, Claude, Grok, DeepSeek, live agent, PDF uploads, WooCommerce, and training on website data. | |
| 13 | 13 | |
| 14 | 14 | == Description == |
| 15 | 15 | |
| 16 | -**MxChat is the most powerful free AI chatbot and content generation plugin for WordPress** — connecting your website to ChatGPT, Claude, Gemini, Grok, DeepSeek, and 100+ AI models through a single, easy-to-use interface. Train your AI chatbot on your website content, WooCommerce products, PDFs, YouTube videos, and more using advanced RAG (Retrieval-Augmented Generation) technology. Now with a built-in AI Content Generator to create full blog posts and landing pages complete with images, SEO metadata, and inline AI editing. | |
| 16 | +[Documentation](https://mxchat.ai/documentation/) | [MxChat Pro](https://mxchat.ai/) | |
| 17 | 17 | |
| 18 | -[Documentation](https://mxchat.ai/documentation/) | [Demo Videos](https://www.youtube.com/@MxChat/videos) | |
| 18 | +### 🎥 Product Demo Videos: | |
| 19 | +- [AI Theme Generator Add-On](https://www.youtube.com/watch?v=rSQDW2qbtRU&t) - Transform your chatbot's appearance in seconds with AI-powered design | |
| 20 | +- [Admin Assistant Add-On](https://www.youtube.com/watch?v=AdEA1k-UCFM) - ChatGPT-like experience directly inside your WordPress dashboard | |
| 21 | +- [WooCommerce Add-On](https://www.youtube.com/watch?v=WsqAppHRGdA) - Display product cards, recommendations, and supercharge your store | |
| 22 | +- [MxChat Forms Add-On](https://www.youtube.com/watch?v=3MrWy5dRalA&t) - Convert conversations into data collection with smart forms that trigger during chats | |
| 23 | +- [Chat with PDF & Word](https://www.youtube.com/watch?v=j_c45WWCTG0) - Let users upload and interact with documents | |
| 19 | 24 | |
| 20 | -## Why Choose MxChat as Your WordPress AI Chatbot? | |
| 25 | +[Explore all product videos on YouTube](https://www.youtube.com/@MxChat/videos) | |
| 21 | 26 | |
| 22 | -✅ **6 Major AI Providers in One Plugin**: OpenRouter, OpenAI GPT, Claude, Gemini, xAI Grok, and DeepSeek - switch between 100+ models instantly | |
| 23 | -✅ **Train on Your Website Data**: Advanced RAG technology learns from sitemaps, PDFs, URLs, YouTube videos, or manual input for ultra-relevant responses | |
| 24 | -✅ **Live Agent Handoff via Slack**: Seamlessly escalate from AI to human support when customers need personal assistance | |
| 25 | -✅ **Real-Time Debug Panel**: See exactly what your chatbot retrieves and triggers with our admin testing interface | |
| 26 | -✅ **Boost Sales with WooCommerce**: Product cards, cart management, and AI-powered shopping assistance | |
| 27 | -✅ **AI Content Generator**: Create full blog posts and landing pages with AI-generated images, SEO metadata, and real-time preview editing | |
| 28 | -✅ **Extensive Add-On Ecosystem**: Forms, moderation, recommendations, theme customization, and more | |
| 27 | +## 💬 Why Choose MxChat AI Chatbot for Your WordPress Website? | |
| 29 | 28 | |
| 30 | -🎬 [Quick Setup with MxChat](https://www.youtube.com/watch?v=3BqoiyWaQiM) – Learn how to quickly setup and understand how your chatbot works | |
| 29 | +✅ **5 Major AI Providers in One Plugin**: OpenAI GPT, Claude, Gemini, xAI Grok, and DeepSeek - switch between 25+ models instantly | |
| 30 | +✅ **Train on Your Website Data**: Advanced RAG technology learns from sitemaps, PDFs, URLs, or manual input for ultra-relevant responses | |
| 31 | +✅ **Live Agent Handoff via Slack**: Seamlessly escalate from AI to human support when customers need personal assistance | |
| 32 | +✅ **Real-Time Debug Panel**: See exactly what your chatbot retrieves and triggers with our admin testing interface | |
| 33 | +✅ **Boost Sales with WooCommerce**: Product cards, cart management, and AI-powered shopping assistance | |
| 34 | +✅ **Extensive Add-On Ecosystem**: Forms, moderation, recommendations, theme customization, and more | |
| 31 | 35 | |
| 32 | -### 📦 Optional Premium Add-Ons | |
| 33 | -Extend the free plugin with these optional premium features: | |
| 36 | +## 🔥 What's New in Version 2.4.0 | |
| 37 | +🎥 **NEW: MxChat Video Generation Add-on** – Generate stunning AI videos using Google's cutting-edge Veo 2 and Veo 3 models directly from your WordPress dashboard. Features include audio generation with Veo 3, multiple aspect ratios, and seamless media library integration. | |
| 38 | +🔧 **Essential Elements Error Fix** – Fixed console error when "Require email to chat" is disabled. System now properly checks if the option is enabled before validating email elements. | |
| 39 | +💬 **Chat Persistence Error Resolution** – Resolved "error chat history not found" message when chat persistence is enabled but user has no existing chat history. | |
| 40 | +🔄 **Slack Live Agent Switching Fix** – Fixed agent indicator not updating properly when switching between live agent and chatbot modes without page refresh. | |
| 34 | 41 | |
| 35 | -- [MCP Server Add-On](https://mxchat.ai/add-ons/mxchat-mcp/) – Turn your MxChat install into a Model Context Protocol server so Claude, ChatGPT, and Claude Code list transcripts, push knowledge, and inspect bots natively — JSON-RPC 2.0 + OAuth + bearer auth, no per-message fees | |
| 36 | -- [Advanced Content Editor Add-On](https://mxchat.ai/add-ons/mxchat-advanced-content/) – Smart internal linking, AI image management, readability analysis, Google Search Console integration, advanced SEO optimization, and 30-day AI Content Calendar for automated blog scheduling | |
| 37 | -- [WooCommerce Add-On](https://mxchat.ai/add-ons/mxchat-woo/) – AI-powered shopping assistance with product-aware conversations, native product cards with images and pricing, upselling and recommendations, order inquiry handling, cart management, and real-time inventory awareness | |
| 38 | -- [Forms Add-On](https://mxchat.ai/add-ons/mxchat-forms/) – Capture leads and data with custom in-chat forms | |
| 39 | -- [MxChat Anywhere Add-On](https://mxchat.ai/add-ons/mxchat-embed/) – Deploy your chatbot on any website with one script tag — Shopify, Squarespace, Wix, static HTML, and more | |
| 40 | -- [AI Chatbot Theme Customizer Add-On](https://mxchat.ai/add-ons/mxchat-theme/) – Instantly design chatbot themes with natural language using AI | |
| 41 | -- [Multi-Bot Add-On](https://mxchat.ai/add-ons/mxchat-multi-bot/) – Run unlimited AI chatbots with custom knowledge and personalities | |
| 42 | -- [Image Analysis Add-On](https://mxchat.ai/add-ons/mxchat-vision/) – Enable AI-powered image analysis and OCR inside chats | |
| 42 | +## 🚀 Core Features That Set MxChat Apart | |
| 43 | 43 | |
| 44 | -👉 [Visit our website to view all add-ons](https://mxchat.ai) | |
| 44 | +🟢 **Advanced Action Recognition** – Smart vector embedding system understands user intent and triggers precise actions automatically | |
| 45 | +🟢 **AI Theme Generator** – Describe your ideal design in plain English and watch AI create custom CSS styling in real-time | |
| 46 | +🟢 **Pinecone Vector Storage** – Lightning-fast knowledge retrieval for large datasets and enterprise-scale deployments | |
| 47 | +🟢 **Document Processing** – Users can upload and chat with PDFs and Word documents directly on your frontend | |
| 48 | +🟢 **Web Search Integration** – Brave search provides real-time information beyond your knowledge base | |
| 49 | +🟢 **Image Generation** – DALL-E integration for visual content creation within chat conversations | |
| 50 | +🟢 **Streaming Responses** – Real-time response streaming for OpenAI, Claude, and Grok models for the fastest possible chat experience | |
| 45 | 51 | |
| 46 | -## Core Features That Set MxChat Apart | |
| 52 | +## 🤖 Choose from 25+ Premium AI Models | |
| 47 | 53 | |
| 48 | -🟢 **100+ AI Models** – Access ChatGPT, Claude, Gemini, Grok, DeepSeek, and 100+ models from OpenRouter with a single plugin | |
| 49 | -🟢 **Lead Management Dashboard** – Dedicated Leads tab inside Transcripts shows every captured email and name deduplicated by lead, with filters, bulk delete, CSV export, and one-click jump to each lead's latest conversation | |
| 50 | -🟢 **Chat Transcripts Dashboard** – Review all conversations, analyze chat history, track user engagement, and see exactly which knowledge sources the AI used for each response | |
| 51 | -🟢 **WooCommerce Product Training** – Train your AI chatbot on your entire product catalog including descriptions, pricing, SKUs, and categories for intelligent shopping assistance | |
| 52 | -🟢 **Live Agent Handoff** – Seamlessly escalate conversations from AI to human support via Slack when customers need personal assistance | |
| 53 | -🟢 **ACF Field Control** – Choose exactly which Advanced Custom Fields are included in your knowledge base—perfect for excluding private notes or internal data | |
| 54 | -🟢 **Advanced Action Recognition** – Trigger Phrases use a smart vector embedding system to understand user intent and fire lead capture, appointments, redirects, and custom actions automatically — precise, deterministic control over when each action runs | |
| 55 | -🟢 **AI Tools (Function Calling)** – Let the chatbot decide on its own when to run an enabled action straight from natural language, with no phrases to set up. Use Trigger Phrases, AI Tools, or both together (function calling needs a tool-capable AI model) | |
| 56 | -🟢 **Document Processing** – Let visitors upload and chat with PDFs and Word documents directly on your frontend | |
| 57 | -🟢 **Pinecone Vector Storage** – Optional lightning-fast knowledge retrieval for large datasets and enterprise-scale deployments | |
| 58 | -🟢 **Web Search Integration** – Brave search provides real-time information beyond your knowledge base | |
| 59 | -🟢 **AI Content Generator** – Create full blog posts and landing pages from a prompt with AI images, SEO metadata, real-time preview, and inline AI editing via chat | |
| 60 | -🟢 **Image Generation** – OpenAI GPT Image and Google Imagen for visual content creation within chat conversations | |
| 61 | -🟢 **Streaming Responses** – Real-time response streaming for OpenAI, Claude, Grok, and DeepSeek models for the fastest possible chat experience | |
| 62 | -🟢 **REST API** – Bearer-token endpoints to read transcripts, push knowledge, and bulk-delete sessions — wire MxChat into n8n, Zapier, analytics dashboards, GDPR workflows, or your own agents | |
| 63 | - | |
| 64 | -## Choose from 100+ Premium AI Models | |
| 65 | 54 | Access the world's most advanced AI models based on your specific needs: |
| 66 | 55 | |
| 67 | -**OpenRouter**: 100+ models from multiple providers with a single API key – including OpenAI, Anthropic, Google, Meta, Mistral, and more! | |
| 68 | -**OpenAI**: | |
| 69 | -GPT-5.5, GPT-5.4, GPT-5.4 Mini, GPT-5.4 Nano, GPT-5.3 Chat, GPT-5.2, GPT-5.1 Chat Latest, GPT-5.1, GPT-5, GPT-5 Mini, GPT-5 Nano | |
| 70 | -**Anthropic Claude**: | |
| 71 | -Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 4.6, Claude Opus 4.5, Claude Sonnet 4.5, Claude Opus 4.1, Claude Haiku 4.5, Claude 4 Opus, Claude 4 Sonnet | |
| 72 | -**X.AI**: | |
| 73 | -**Grok 4.1 Fast (Reasoning)**, **Grok 4.1 Fast (Non-Reasoning)**, Grok 4, Grok-3, Grok-3 Fast, Grok-3 Mini, Grok-3 Mini Fast | |
| 74 | -**Google Gemini**: | |
| 75 | -Gemini 3.5 Flash, Gemini 3.1 Pro, Gemini 3 Flash, Gemini 3.1 Flash-Lite, Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.5 Flash-Lite | |
| 76 | -**DeepSeek**: | |
| 77 | -DeepSeek V3 | |
| 56 | +**OpenAI**: GPT-5, GPT-5-mini, GPT-5-nano, GPT-4.1, GPT-4o, GPT-4o-mini, GPT-4-turbo, GPT-4, GPT-3.5-turbo | |
| 57 | +**X.AI**: Grok-4, Grok-3, Grok-3 Fast, Grok-3 Mini, Grok-3 Mini Fast, Grok-2 | |
| 58 | +**Claude**: Claude 4 Sonnet, Claude 4 Opus, Claude 3.7 Sonnet, Claude 3.5 Sonnet, Claude 3 Opus | |
| 59 | +**DeepSeek**: DeepSeek V3 | |
| 60 | +**Google Gemini**: Gemini 2.0 Flash, Gemini 2.0 Flash-Lite, Gemini 1.5 Pro, Gemini 1.5 Flash | |
| 78 | 61 | |
| 79 | -## Lead Management Dashboard — Turn Chat Traffic Into a Real Lead List | |
| 62 | +## 🛒 Supercharge Your eCommerce with AI | |
| 80 | 63 | |
| 81 | -Every email and name your chatbot captures now lands in one clean, sortable dashboard — so you can finally see your leads as a list instead of hunting through individual transcripts. | |
| 64 | +Transform online shopping with intelligent assistance through direct WooCommerce integration: | |
| 82 | 65 | |
| 83 | -**What You Get:** | |
| 66 | +- Engage visitors in real time with product-aware conversations | |
| 67 | +- Recommend products and upsell with native WooCommerce product cards | |
| 68 | +- Access order history, inventory, and customer data seamlessly | |
| 69 | +- Convert passive users into paying customers with live support | |
| 70 | +- Handle order inquiries and status updates directly through chat | |
| 84 | 71 | |
| 85 | -- **One Row Per Lead** — emails captured across multiple sessions are automatically deduplicated, so each lead appears once with a conversation count and a "last seen" timestamp | |
| 86 | -- **Top Pages Capturing Leads** — instantly see which pages on your site are driving the most lead captures; click any page to filter the list to leads from that page only | |
| 87 | -- **Powerful Filtering** — search by email or name, filter by date range (24h / 7d / 30d / 90d / all-time), or filter by status (leads with a conversation vs. orphan leads who submitted the form but never chatted) | |
| 88 | -- **Orphan Lead Tracking** — visitors who drop their email in the pre-chat form but never send a message are surfaced separately so you never lose a captured contact | |
| 89 | -- **One-Click View Conversation** — jump from any lead straight into their latest full conversation in the transcripts viewer | |
| 90 | -- **Bulk Delete + CSV Export** — select multiple leads to delete or export in one action; CSV export supports email-only or email + name + conversation count + last-seen + top page | |
| 91 | -- **Clean, Responsive, Native** — works beautifully on desktop, tablet, and phone with the same polished dashboard feel as the rest of MxChat | |
| 92 | -- **Zero Setup, Zero Migration** — uses your existing chat data, no new database tables, no configuration — turn on lead capture and the dashboard just works | |
| 72 | +## 🔧 Powerful Add-On Ecosystem | |
| 93 | 73 | |
| 94 | -**Perfect for** sales teams managing inbound leads, agencies reporting to clients, and anyone who wants to see the actual ROI of their chatbot at a glance without digging through individual conversations. | |
| 74 | +**Pro Add-Ons:** | |
| 75 | +🟢 **Video Generation** – Generate stunning AI videos using Google's Veo 2 and Veo 3 models with audio support and multiple aspect ratios | |
| 76 | +🟢 **Admin Assistant** – ChatGPT-like interface in WordPress admin with thread management and image generation | |
| 77 | +🟢 **Theme Customizer** – Visual design editor with AI-powered chatbot theme generation from natural language | |
| 78 | +🟢 **MxChat Forms** – Create chatbot-triggered forms for lead capture and support tickets | |
| 79 | +🟢 **Chat Moderation** – Advanced security with email/IP banning and content filtering | |
| 80 | +🟢 **Smart Recommender** – Intelligent recommendation flows with customizable matching algorithms | |
| 81 | +🟢 **Perplexity Integration** – Real-time web search with authoritative, well-sourced responses | |
| 95 | 82 | |
| 96 | -## AI Content Generator — Create Blog Posts & Landing Pages with AI | |
| 97 | - | |
| 98 | -MxChat includes a built-in AI Content Generator that lets you create full blog posts and landing pages directly from your WordPress dashboard — no external tools or copy-pasting required. | |
| 99 | - | |
| 100 | -**How It Works:** | |
| 101 | - | |
| 102 | -1. **Describe Your Content** — Enter a topic, title, or detailed prompt and choose between a blog post or landing page layout | |
| 103 | -2. **AI Generates Everything** — The AI produces fully styled HTML with responsive CSS, ready-to-publish content, and optional AI-generated images using OpenAI GPT Image, Gemini, or Grok | |
| 104 | -3. **Real-Time Preview** — See your content exactly as it will appear on your site with a live scaled preview, including desktop and mobile viewport switching | |
| 105 | -4. **Edit with AI Chat** — Use the built-in AI chat panel to request changes like "make the heading bigger" or "change the background to blue" — the AI updates your content in real time | |
| 106 | -5. **Publish Instantly** — Content is saved as a native WordPress post or page with clean HTML, SEO metadata, and responsive design that works with any theme | |
| 107 | - | |
| 108 | -**Key Content Generator Features:** | |
| 109 | - | |
| 110 | -- Choose from multiple AI models for content generation (GPT-5, Claude, Gemini, Grok, and more) | |
| 111 | -- AI-generated images placed directly into your content with automatic media library uploads | |
| 112 | -- SEO title and meta description generation for search engine optimization | |
| 113 | -- Built-in SEO analysis with real-time scoring and one-click AI auto-optimization | |
| 114 | -- Fullwidth and standard layout options with automatic theme compatibility | |
| 115 | -- Content history to revisit and manage previously generated posts | |
| 116 | -- Works with popular page builders and themes including Elementor, Bricks, Divi, Astra, Kadence, and more | |
| 117 | -- Optional [Advanced Content Editor Add-On](https://mxchat.ai/add-ons/mxchat-advanced-content/) for Google Search Console analytics, smart internal linking, readability analysis, and advanced SEO optimization | |
| 118 | - | |
| 119 | -## MxChat Anywhere — Deploy Your Chatbot on Any Website | |
| 120 | - | |
| 121 | -Your WordPress site powers the AI, but your chatbot doesn't have to live there. The [MxChat Anywhere Add-On](https://mxchat.ai/add-ons/mxchat-embed/) lets you deploy your fully configured chatbot on any website with a single script tag — Shopify, Squarespace, Wix, static HTML, SaaS apps, documentation sites, or anything with an HTML page. | |
| 122 | - | |
| 123 | -**Key Features:** | |
| 124 | - | |
| 125 | -- One script tag to add your chatbot to any site — no coding or framework required | |
| 126 | -- Full style isolation via Shadow DOM so host page CSS never breaks your chatbot | |
| 127 | -- All your MxChat settings carry over automatically — colors, themes, quick questions, email collection, streaming, and more | |
| 128 | -- Multi-bot support lets you deploy different chatbot configurations on different sites | |
| 129 | -- Secure domain whitelisting and API key authentication prevent unauthorized usage | |
| 130 | -- Lightweight vanilla JS widget with zero dependencies — no jQuery needed on the target site | |
| 131 | - | |
| 132 | -**Ideal for** SaaS products with a WordPress blog but a separate web app, e-commerce brands on Shopify, documentation sites, or any business that needs their chatbot beyond WordPress. | |
| 133 | - | |
| 134 | 83 | ## 📱 Mobile-Friendly & Fully Customizable |
| 135 | 84 | |
| 136 | 85 | MxChat’s chatbot widget adapts seamlessly to all devices — desktop, tablet, or mobile. Customize colors, greetings, and placement to match your brand and provide a smooth experience across your entire website. |
| 137 | 86 | |
| @@ -149,422 +98,442 @@ | ||
| 149 | 98 | ## 🆓 Start with MxChat’s Powerful Free Plan |
| 150 | 99 | |
| 151 | 100 | MxChat offers a fully functional free plan that includes everything you need to get started with AI chatbot and customer support. With no credit card required, you can: |
| 152 | 101 | |
| 153 | -- Access all AI models from 6 major providers | |
| 154 | -- AI Content Generator for blog posts and landing pages with SEO scoring and AI auto-optimization | |
| 155 | -- Train chatbot on unlimited website content | |
| 156 | -- Loops email capture for lead generation | |
| 157 | -- Web search and image generation capabilities | |
| 158 | -- Real-time admin debug panel | |
| 159 | -- Chat transcript review and export | |
| 160 | -- RAG support & contextual awareness | |
| 102 | +- Access all AI models from 5 major providers | |
| 103 | +- Train chatbot on unlimited website content | |
| 104 | +- Loops email capture for lead generation | |
| 105 | +- Web search and image generation capabilities | |
| 106 | +- Real-time admin debug panel | |
| 107 | +- Chat transcript review and export | |
| 108 | +- RAG support & contextual awareness | |
| 161 | 109 | |
| 162 | 110 | Whether you're running a small business or launching a new online store, MxChat’s free plan gives you the tools to offer intelligent customer support and grow your business — without paying a cent. |
| 163 | 111 | |
| 164 | -== Installation == | |
| 112 | +## ✅ Get Started with MxChat AI Chatbot Today | |
| 165 | 113 | |
| 166 | -1. Upload the `mxchat-basic` folder to the `/wp-content/plugins/` directory. | |
| 167 | -2. Activate the plugin through the 'Plugins' menu in WordPress. | |
| 168 | -3. Navigate to the 'MxChat' settings page to configure your OpenAI API key and other settings. | |
| 114 | +Installing MxChat for WordPress takes just a few clicks. Get started with our free plan and upgrade anytime to access our complete add-on ecosystem and premium features. | |
| 169 | 115 | |
| 170 | -== Frequently Asked Questions == | |
| 116 | +## 💰 Pricing | |
| 171 | 117 | |
| 172 | -= What AI models does MxChat support? = | |
| 118 | +Most powerful features are included in the free plan. Upgrade to Pro for the complete add-on ecosystem and advanced capabilities. | |
| 119 | +[View all pricing options](https://mxchat.ai/) | |
| 173 | 120 | |
| 174 | -MxChat supports 100+ AI models including OpenAI GPT-5.5, GPT-5.1 Chat Latest, GPT-5, Anthropic Claude Opus 4.8, Claude Sonnet 4.6, Claude Haiku 4.5, Google Gemini 3.5 Flash, Gemini 3.1 Pro, xAI Grok 4, Grok 3, DeepSeek V3, and many more. With OpenRouter integration, you get access to models from OpenAI, Anthropic, Google, Meta, Mistral, and other providers with a single API key. | |
| 121 | +== Use of Third-Party Services == | |
| 175 | 122 | |
| 176 | -= How do I get API keys for the AI chatbot? = | |
| 123 | +This plugin connects to AI service providers to generate responses: | |
| 177 | 124 | |
| 178 | -For OpenAI, visit platform.openai.com and create an account. For Anthropic Claude, visit console.anthropic.com. For Google Gemini, visit ai.google.dev. For xAI Grok, visit x.ai. For DeepSeek, visit platform.deepseek.com. For OpenRouter (100+ models), visit openrouter.ai. Each provider offers different pricing tiers and free credits for new users. | |
| 125 | +**Service Providers:** | |
| 126 | +- [OpenAI](https://openai.com/) - [Terms](https://openai.com/policies/terms-of-use/) | [Privacy](https://openai.com/policies/privacy-policy/) | |
| 127 | +- [Anthropic](https://anthropic.com/) - [Terms](https://www.anthropic.com/terms) | [Privacy](https://www.anthropic.com/privacy) | |
| 128 | +- [Google](https://ai.google.dev/) - [Terms](https://ai.google.dev/terms) | [Privacy](https://policies.google.com/privacy) | |
| 129 | +- [X.AI](https://x.ai/) - [Terms](https://x.ai/terms-of-service) | [Privacy](https://x.ai/privacy-policy) | |
| 130 | +- [DeepSeek](https://deepseek.com/) - [Terms](https://deepseek.com/terms) | [Privacy](https://deepseek.com/privacy) | |
| 179 | 131 | |
| 180 | -= Can I train the AI chatbot on my website content? = | |
| 132 | +Please ensure compliance with applicable terms and data privacy laws. | |
| 181 | 133 | |
| 182 | -Yes. MxChat supports unlimited knowledge base training using RAG (Retrieval-Augmented Generation) technology. Import content from WordPress pages, posts, WooCommerce products, custom post types, PDFs, Word documents, text files, sitemaps, and manual Q&A entries. The AI chatbot will use your content to provide accurate, contextually relevant responses. | |
| 134 | +== Installation == | |
| 183 | 135 | |
| 184 | -= What is RAG technology and how does it work? = | |
| 136 | +1. Upload the `mxchat` folder to the `/wp-content/plugins/` directory. | |
| 137 | +2. Activate the plugin through the 'Plugins' menu in WordPress. | |
| 138 | +3. Navigate to the 'MxChat' settings page to configure your OpenAI API key and other settings. | |
| 185 | 139 | |
| 186 | -RAG (Retrieval-Augmented Generation) is an AI technique that retrieves relevant information from your knowledge base before generating responses. When a visitor asks a question, MxChat searches your trained content using vector embeddings, finds the most relevant matches, and provides that context to the AI model. This ensures accurate, factual answers based on your actual website content rather than generic AI responses. | |
| 140 | +== Frequently Asked Questions == | |
| 187 | 141 | |
| 188 | -= Does MxChat work with WooCommerce? = | |
| 142 | +### How do I obtain an API key for OpenAI? | |
| 189 | 143 | |
| 190 | -Yes. MxChat includes full WooCommerce integration. The AI chatbot can be trained on your product catalog including titles, descriptions, pricing, SKUs, categories, and custom fields. Enable auto-sync to automatically update the knowledge base when products change. Your chatbot can answer questions about products, pricing, availability, and help customers find what they need. | |
| 144 | +You can obtain an API key by signing up on the OpenAI website. Once you have the API key, enter it in the plugin settings to start using the AI chatbot. | |
| 191 | 145 | |
| 192 | -= Can I customize the AI chatbot appearance? = | |
| 146 | +### Can I customize the chatbot’s appearance? | |
| 193 | 147 | |
| 194 | -Yes. MxChat offers extensive customization options including custom colors, chatbot icon, AI avatar, chat bubble size, light/dark/system themes, positioning (left/right), custom CSS, greeting messages, placeholder text, and widget layouts. Use the built-in AI Theme Generator to describe your ideal design and let AI create custom styling automatically. | |
| 148 | +Yes, the **Pro version** offers extensive **theme customization options**, including the ability to change the chatbot’s colors, fonts, and background to match your website’s design. | |
| 195 | 149 | |
| 196 | -= How do I add the chatbot to my WordPress site? = | |
| 150 | +### How do I add the chatbot to my site? | |
| 197 | 151 | |
| 198 | -You can add the chatbot using the shortcode `[mxchat_chatbot floating="yes"]` for a floating widget or `[mxchat_chatbot floating="no"]` for an embedded chat. Alternatively, enable "Append to Body" in settings to automatically display the chatbot on all pages without shortcodes. | |
| 152 | +You can add the chatbot to your site using the `[mxchat_chatbot floating="yes"]` or `[mxchat_chatbot floating="no"]` shortcode. Additionally, you can automatically append the chatbot to your site’s body element from the settings page. | |
| 199 | 153 | |
| 200 | -= Does MxChat support streaming responses? = | |
| 154 | +### How does the knowledge submission feature work? | |
| 201 | 155 | |
| 202 | -Yes. MxChat supports real-time streaming responses for OpenAI, Anthropic Claude, xAI Grok, and DeepSeek models. Streaming displays AI responses word-by-word as they're generated, providing a faster, more engaging chat experience for your visitors. | |
| 156 | +You can submit custom content to the knowledge base from the 'Knowledge' submenu. This content is processed using vector embeddings, allowing the AI chatbot to provide more accurate and contextually relevant responses. | |
| 203 | 157 | |
| 204 | -= What is the Chat Transcripts feature? = | |
| 158 | +### What is the sitemap submission feature? | |
| 205 | 159 | |
| 206 | -The Chat Transcripts dashboard provides comprehensive conversation management. View all chat histories, see detailed conversation flows, track which knowledge sources the AI used for each response, monitor user engagement, and analyze chat analytics including daily activity, peak hours, and user distribution. | |
| 160 | +The sitemap submission feature allows you to submit a sitemap URL. The plugin will fetch, extract, and add content from the URLs listed in the sitemap to the chatbot’s knowledge base, enhancing the AI’s ability to provide precise and contextually relevant answers. | |
| 207 | 161 | |
| 208 | -= Can I see which content the AI chatbot used to answer questions? = | |
| 162 | +== Screenshots == | |
| 209 | 163 | |
| 210 | -Yes. MxChat includes full knowledge source transparency. In the Chat Transcripts and the optional debug panel, you can see exactly which pages, posts, products, or Q&A entries the AI retrieved and used to generate each response, along with relevance scores. | |
| 164 | +1. **Knowledge & Sitemap Submission** - Submit custom content to enhance the chatbot's responses. | |
| 165 | +2. **Action Page** - Set custom action triggers to complete specific actions. | |
| 166 | +3. **Plugin Settings Page** - Configure your API key and other settings. | |
| 167 | +4. **Add-ons Page** - Extend MxChat’s functionality with add-ons to customize your needs. | |
| 168 | +5. **Activation Page** - Easily upgrade to MxChat Pro by entering your activation key. Unlock advanced features like theme customization directly from the MxChat settings page. | |
| 169 | +6. **Chat Transcripts** - Review and analyze conversations to refine your AI chatbot. | |
| 211 | 170 | |
| 212 | -= Is Pinecone vector database required? = | |
| 171 | +*(Note: Screenshots will be added in future updates)* | |
| 213 | 172 | |
| 214 | -No. MxChat includes free, unlimited local vector storage in your WordPress database. Pinecone integration is optional and recommended only for enterprise-scale knowledge bases with thousands of entries requiring faster search performance. | |
| 173 | +== Changelog == | |
| 215 | 174 | |
| 216 | -= Does MxChat support multiple languages? = | |
| 175 | += 2.4.1 - September 4, 2025 = | |
| 176 | +Fixed: Email collection form not submitting properly when "Require email to chat" is enabled. | |
| 177 | +Improved: PDF processing now provides clearer error messages with repair suggestions when corrupted files are detected. | |
| 217 | 178 | |
| 218 | -Yes. The AI chatbot supports multi-language conversations and automatically responds in the language your visitors use. MxChat also supports right-to-left (RTL) languages like Arabic and Hebrew. | |
| 179 | += 2.4.0 - September 3, 2025 = | |
| 180 | +- Added new MxChat Video Generation add-on with support for Google Veo 2 and Veo 3 models, featuring audio generation and multiple aspect ratios. | |
| 181 | +- Fixed console error when "Require email to chat" option is disabled by adding proper validation check. | |
| 182 | +- Resolved "error chat history not found" message when chat persistence is enabled but user has no existing chat history. | |
| 183 | +- Fixed agent indicator not updating properly when switching between live agent and chatbot modes without page refresh. | |
| 219 | 184 | |
| 220 | -= How much do AI API calls cost? = | |
| 185 | += 2.3.9 - August 17, 2025 = | |
| 186 | +- Updated Slack channel naming logic to prioritize client’s name, falling back to email, then chat ID. | |
| 187 | +- Added streaming response support for DeepSeek models. | |
| 188 | +- Enabled multiple direct content entries without requiring a source URL. | |
| 189 | +- Fixed auto sync drafts so posts moved from posted to draft are removed from the knowledge database. | |
| 190 | +- Implemented role-based chatbot information access restrictions for enhanced security and relevance. | |
| 191 | +- Added option in the admin panel’s post edit page to hide the floating chatbot on specific pages. | |
| 221 | 192 | |
| 222 | -API costs depend on your chosen provider and model. OpenAI, Anthropic, Google, and others charge based on token usage. DeepSeek and Google Gemini offer generous free tiers. MxChat includes intelligent token optimization to minimize API costs. You can also set rate limits for guests and logged-in users to control usage. | |
| 193 | += 2.3.8 - August 12, 2025 = | |
| 194 | +- Fixed extra backslashes appearing in knowledgebase content during editing. | |
| 195 | +- Added optional name field to Require Email to Chat form; transcripts now display email and name if enabled. | |
| 196 | +- Updated Slack channel naming for live agent notifications: uses user's email if logged in, email if Require Email to Chat is enabled, or chat ID otherwise. | |
| 223 | 197 | |
| 224 | -= Is MxChat GDPR compliant? = | |
| 198 | += 2.3.7 - August 8, 2025 = | |
| 199 | +- New Models: Added GPT-5 family (GPT-5, GPT-5 Mini, GPT-5 Nano) to expand capabilities with faster, smarter, and more cost-efficient options. | |
| 200 | += 2.3.6 - August 6, 2025 = | |
| 201 | +- Bug Fix: Fixed streaming fallback to properly display responses when streaming fails, preventing blank chat bubbles. | |
| 202 | +- New Feature: Added streaming test button to help users verify if streaming is compatible with their setup. | |
| 225 | 203 | |
| 226 | -Yes. All conversation data is stored locally on your WordPress site, giving you complete control. Configure automatic data retention policies, export chat transcripts, or delete conversations as needed for compliance. | |
| 204 | += 2.3.5 - August 6, 2025 = | |
| 205 | +- Redesigned chat transcript UI for a cleaner, more professional experience. | |
| 206 | +- Transcripts now show the page where the chat started and any links clicked. | |
| 207 | +- Added ability to select and delete transcripts directly from the header. | |
| 227 | 208 | |
| 228 | -= Can I restrict chatbot access to certain users? = | |
| 209 | += 2.3.4 - July 30, 2025 = | |
| 210 | +- Fixed streaming compatibility issues with Cloudflare and WP Engine by implementing automatic fallback to regular chat when streaming is buffered. | |
| 211 | +- Enhanced email capture intents to use AI-generated conversational responses instead of hard-coded messages, allowing for more natural user interactions while maintaining the same functionality. | |
| 229 | 212 | |
| 230 | -Yes. MxChat includes role-based access controls. Restrict the chatbot to logged-in users only, specific user roles, or keep it public. You can also restrict specific knowledge base content to certain user roles. | |
| 213 | += 2.3.3 - July 29, 2025 = | |
| 214 | +- Improved streaming performance by fixing output buffering issues using enhanced flush logic. | |
| 215 | +- Added contextual awareness support via the new `data-mxchat-context` HTML attribute. | |
| 216 | +- Revamped license key management system with domain linking, deactivation, and real-time usage dashboard. | |
| 217 | +- Fixed transcript timestamp display to use WordPress site's local timezone correctly. | |
| 231 | 218 | |
| 232 | -= Does MxChat support live chat handoff? = | |
| 219 | += 2.3.2 - July 24, 2025 = | |
| 220 | +- Added full support for OpenAI Assistants API via the new Assistant add-on. | |
| 221 | +- Improved email collection form performance and reliability with better loading states and timeout handling. | |
| 222 | +- Enhanced WooCommerce product labeling accuracy in WordPress import with improved URL matching. | |
| 223 | +- Fixed ACF field processing errors when handling WP_Post objects and relationship fields. | |
| 233 | 224 | |
| 234 | -Yes. MxChat integrates with Slack for live agent handoff. When the AI cannot help or a visitor requests human support, conversations can be seamlessly transferred to your team via Slack. | |
| 225 | += 2.3.1 - July 20, 2025 = | |
| 226 | +- Enhanced hyperlink functionality to include mailto links, enabling email addresses in bot responses to be clickable. | |
| 227 | +- Added full support for the new MxChat Image Analysis add-on, allowing users to upload and analyze images directly in chat using OpenAI Vision and Grok APIs. | |
| 228 | +- Added message filtering hooks system for developers to customize prompts and responses without modifying core plugin files. | |
| 235 | 229 | |
| 236 | -= What are Actions and how do they work? = | |
| 230 | += 2.3.0 - July 13, 2025 = | |
| 231 | +- Added Grok-4 model support, the world's smartest AI model available. | |
| 232 | +- Added streaming response support for all Grok models (Grok-4, Grok-3, etc.), delivering real-time response generation for faster and smoother chat experiences. | |
| 237 | 233 | |
| 238 | -Actions are capabilities your chatbot can perform — lead capture, appointment booking, support tickets, page redirects, image generation, web search, or custom JavaScript. MxChat gives you two ways to fire them, and you can use either one or both together: | |
| 234 | += 2.2.9 - July 6, 2025 = | |
| 235 | +- Improved quick question UI: suggestions now collapse after user input and can be toggled with up/down icons | |
| 236 | +- Increased sitemap batch processing limit from 5 to 50 for faster indexing | |
| 237 | +- Expanded action similarity threshold range to support values from 10 to 95 | |
| 239 | 238 | |
| 240 | -* **Trigger Phrases** – the original system. A smart vector embedding match fires an action when a visitor's message matches a phrase you've set up. Precise, deterministic control over exactly when each action runs. | |
| 241 | -* **AI Tools (function calling)** – the chatbot decides on its own when to run an enabled action, straight from natural language, with no phrases to configure. The easiest way to get started; it needs a tool-capable AI model. | |
| 239 | += 2.2.8 - June 27, 2025 = | |
| 240 | +- Added brand new contextual awareness option that automatically provides chatbot access to current page content and URL for contextually relevant responses | |
| 241 | +- Enhanced WordPress knowledge base import to include Advanced Custom Fields (ACF) data for more comprehensive content training | |
| 242 | +- Major README structure update with improved formatting and visual presentation | |
| 242 | 243 | |
| 243 | -Manage both from the Actions area in your MxChat settings, which holds Trigger Phrases and AI Tools side by side. | |
| 244 | += 2.2.7 = | |
| 245 | +- Fixed a bug that occured when deleting all pinecone records & added support for markdown hyperlinking in rate limit messages. | |
| 244 | 246 | |
| 245 | -= Can visitors upload documents to chat? = | |
| 247 | += 2.2.6 = | |
| 248 | +- Brand New Admin Debug Panel – Added a comprehensive frontend debug panel for administrators! You can now see retrieved documents, triggered actions, and other debug and setting information in real-time while testing your chatbot, making it easier than ever to fine-tune your bot's performance. | |
| 249 | +- Fixed Pinecone Single Entry Deletion – Resolved a bug that prevented individual entries from being properly deleted from Pinecone vector storage. | |
| 250 | +- Improved Pinecone UI Records Retrieval – Enhanced the Pinecone database panel with better record loading and display functionality for smoother management of your vector database. | |
| 251 | +- Fixed WordPress KB Entry Editing – Resolved an issue where editing knowledge base entries in the WordPress database wasn't working properly, ensuring seamless content management. | |
| 246 | 252 | |
| 247 | -Yes. Enable document uploads to let visitors chat with PDFs and Word documents. The AI extracts and processes document content in real-time, allowing contextual Q&A about uploaded files. | |
| 253 | += 2.2.5 = | |
| 254 | +- Streaming Response Support – You can now enable streaming responses for OpenAI and Claude models. This delivers a faster, smoother chat experience for users by displaying replies in real-time as they’re generated. | |
| 255 | +- Slack Live Agent Fix – Resolved a minor bug that occasionally caused duplicate messages in Slack during live agent conversations. | |
| 256 | +- Pinecone UI Update – Fixed a UI display issue in the Pinecone database panel when using the TE3 model. | |
| 248 | 257 | |
| 249 | -= Does MxChat support image generation? = | |
| 258 | += 2.2.4 = | |
| 259 | +- Critical update to error when working with large databases in Pinecone. | |
| 250 | 260 | |
| 251 | -Yes. With OpenAI GPT Image and Google Imagen integration, the AI chatbot can generate images based on user descriptions directly within the chat conversation. | |
| 261 | += 2.2.3 = | |
| 262 | +- Various critical bug fixes that occured from the codebase refactoring. | |
| 252 | 263 | |
| 253 | -= How does the knowledge base auto-sync work? = | |
| 264 | += 2.2.2 = | |
| 265 | +- Enhanced Slack integration: live agent handoff now creates new Slack channels per conversation; agents can reply directly in channel to chat with website users. | |
| 266 | +- Major codebase refactoring for improved organization and optimization. | |
| 267 | +- Improved sitemap and PDF processing: added retry mechanism, display of failed pages/URLs, and manual batch processing button. | |
| 268 | +- Fixed Pinecone setting not toggling on for users who previously did not have the add-on. | |
| 254 | 269 | |
| 255 | -Enable auto-sync for posts, pages, WooCommerce products, or custom post types. When you publish or update content, MxChat automatically updates the knowledge base with the new information. No manual re-importing required. | |
| 270 | += 2.2.1 = | |
| 271 | +- Added Claude Sonnet 4 and Claude Opus 4 chat models. | |
| 272 | +- Integrated Google Gemini embedding model (gemini-embedding-exp-03-07). | |
| 273 | +- Built Pinecone vector database support directly into core plugin. | |
| 274 | +- Removed dependency on separate Pinecone add-on. | |
| 256 | 275 | |
| 257 | -= Can I use Advanced Custom Fields (ACF) with MxChat? = | |
| 276 | += 2.2.0 = | |
| 277 | +- Added WordPress Content Importer for posts and pages. | |
| 278 | +- Implemented tabbed interface for knowledge base management. | |
| 279 | +- Added content filtering by type and knowledge base status. | |
| 280 | +- Added bulk import with real-time progress tracking. | |
| 258 | 281 | |
| 259 | -Yes. MxChat fully supports Advanced Custom Fields. ACF field data is automatically included when importing content. Use the ACF Field Settings to control which custom fields are included or excluded from the knowledge base—perfect for hiding private notes or internal data from the chatbot. | |
| 282 | += 2.1.9 = | |
| 283 | +- Added email notification feature for new chat sessions. | |
| 284 | +- Implemented pagination on transcripts page (50 per page) to improve performance. | |
| 285 | +- Fixed bug with Brave image search not returning images correctly from the API. | |
| 286 | +- Enhanced performance by changing chat transcripts to disable autoload. | |
| 260 | 287 | |
| 261 | -= What embedding models does MxChat support? = | |
| 288 | += 2.1.7 = | |
| 289 | +- Fixed Pro activation issues when the plugin has been translated. | |
| 290 | +- Improved tab behavior to always default to the first tab. | |
| 291 | +- Major rework to rate limits: added custom rate limit timeframes and messages for each individual role. | |
| 292 | +- Added support for new MxChat Smart Recommender add-on. | |
| 293 | +- Fixed bug with Loops where manual list selection from dropdown was required for functionality. | |
| 262 | 294 | |
| 263 | -MxChat supports multiple embedding models for vector search including OpenAI text-embedding-ada-002, text-embedding-3-small, text-embedding-3-large, Google Gemini embedding, and Voyage AI embeddings. Choose the model that best fits your accuracy and cost requirements. | |
| 295 | += 2.1.6 = | |
| 296 | +- Added new AI models: GPT-4.1 and the complete suite of Grok 3 models. | |
| 297 | +- Updated AI service providers to use their official SVG logos for better visual representation. | |
| 298 | +- Fixed an issue where API key fields would try to autosave when no data was entered. | |
| 299 | +- Various other minor bug fixes for improved stability and performance. | |
| 264 | 300 | |
| 265 | -= Is there a free version of MxChat? = | |
| 301 | += 2.1.5 = | |
| 302 | +- Added RTL Language support, allowing languages that align right to automatically do so in both chat input and AI responses. | |
| 303 | +- Improved error messaging for API calls in the frontend of the chatbot, and enhanced error messages when submitting sitemaps, URLs, and PDFs. | |
| 304 | +- Fixed an auto save issue that caused an error if no changes were made. | |
| 305 | +- Various other minor bug fixes for improved stability and performance. | |
| 266 | 306 | |
| 267 | -Yes. MxChat is available for free on the WordPress plugin repository with full AI chatbot functionality. Premium add-ons are available for advanced features like the AI Theme Generator and priority support. | |
| 307 | += 2.1.4 = | |
| 308 | +- Added the ability to easily customize the "AI Agent" text displayed in the top bar for greater personalization. | |
| 309 | +- Fixed a bug where data scraping failed to retrieve all content from certain websites. | |
| 310 | +- Added HTML support in the intro message for richer customization. | |
| 311 | +- Resolved an issue where API input fields triggered browser autofill, improving user input accuracy. | |
| 268 | 312 | |
| 269 | -== Developer Hooks & Filters == | |
| 313 | += 2.1.3 = | |
| 314 | +- Added support for Google Gemini models: Gemini 2.0 Flash, Gemini 2.0 Flash-Lite, Gemini 1.5 Pro, and Gemini 1.5 Flash. | |
| 315 | +- Improved chat model selection UI for a more intuitive user experience. | |
| 316 | +- Redesigned embedding model selection UI for better clarity and usability. | |
| 317 | +- Enhanced error handling for sitemap submissions with more helpful user feedback. | |
| 318 | +- Fixed an issue in the knowledge database where editing entries erased or prevented changes to citation URLs. | |
| 270 | 319 | |
| 271 | -MxChat provides WordPress filter hooks so developers can extend and customize chatbot behavior without modifying core plugin files. [View full documentation with code examples](https://mxchat.ai/mxchat-developer-hooks-filters/). | |
| 320 | += 2.1.2 = | |
| 321 | +- Rebranded intents page to "Actions" with a revamped UI, displaying pro/add-on requirements and brief descriptions. | |
| 322 | +- Added ability to toggle actions on/off without deleting; moved image generation action from pro to free tier. | |
| 323 | +- Introduced advanced knowledge base sync feature to pull in custom post data. | |
| 272 | 324 | |
| 273 | -= mxchat_before_process_post = | |
| 325 | += 2.1.1 = | |
| 326 | +- Made Claude and X.AI API models available to all users. | |
| 327 | +- Improved API key management UI - only showing relevant API key fields based on selected models. | |
| 328 | +- Enhanced knowledge import interface with clear credit requirement warnings. | |
| 329 | +- Fixed embedding error notifications for better clarity. | |
| 274 | 330 | |
| 275 | -Runs during knowledge base indexing and lets you modify a post's data before MxChat processes it. Use this to include custom field data (e.g. product specifications or ACF fields), strip internal content you don't want the chatbot to learn, or transform posts based on bot ID. Receives the WP_Post object and the bot ID. | |
| 331 | += 2.1.0 = | |
| 332 | +- Fixed a bug impacting the header color in the output. | |
| 333 | +- Updated embedding error notification when submitting sitemaps or PDFs. | |
| 334 | +- Improved context extraction parser. | |
| 276 | 335 | |
| 277 | -= mxchat_system_instructions = | |
| 336 | += 2.0.9 = | |
| 337 | +- Revamped UI on the main settings page to match the rest of the plugin. | |
| 338 | +- Added real-time updates for sitemap and PDF processing. | |
| 339 | +- Renamed "MxChat Intent Tester" add-on to "MxChat Similarity Tester". | |
| 340 | +- Various minor bug fixes and improvements. | |
| 278 | 341 | |
| 279 | -Dynamically modify the system prompt before every AI response. Use this to inject live data such as business hours, inventory status, or user-specific context into the prompt at runtime. Receives the instructions text, bot ID, and session ID. MxChat also supports WordPress shortcodes directly in the system prompt field — any registered shortcodes are automatically expanded before being sent to the AI. | |
| 342 | += 2.0.8 = | |
| 343 | +- Minor bug fix impacting similarity adjustment. | |
| 280 | 344 | |
| 281 | -## ✅ Get Started with MxChat AI Chatbot Today | |
| 345 | += 2.0.7 = | |
| 346 | +- **Perplexity Integration Add-On** – Added Perplexity web search, integrated into intent management with a toolbar toggle. | |
| 347 | +- **Sonnet 3.7 Support** – Introduced Anthropic’s Claude Sonnet 3.7, the latest high-intelligence model. | |
| 348 | +- **Bug Fixes & Improvements** – Fixed title tag formatting in responses and tightened knowledge database similarity range to 20. | |
| 282 | 349 | |
| 283 | -Installing MxChat for WordPress takes just a few clicks. Get started with our free plan and upgrade anytime to access our complete add-on ecosystem and premium features. | |
| 350 | += 2.0.5 = | |
| 351 | +- **Auto-Expanding AI Instructions** – AI instructions text field now auto-expands to fit content. | |
| 352 | +- **Chat Transcripts UI & Export** – Redesigned chat transcripts UI and added Excel export feature. | |
| 353 | +- **Quick Questions Rebrand** – Renamed "Popular Questions" to "Quick Questions" with updated copy. | |
| 354 | +- **Security Enhancement** – Improved security to better prevent XSS attacks. | |
| 355 | +- **Intent Testing Add-On** – Integrated new Intent Tester add-on for enhanced chatbot performance. | |
| 284 | 356 | |
| 285 | -## 💰 Pricing | |
| 357 | += 2.0.4 = | |
| 358 | +- **Markdown Response Fix** – Resolved markdown formatting issues in the chatbot UI. | |
| 359 | +- **Agent Mode Customization** – Improved indicator text theme and background styling. | |
| 360 | +- **WooCommerce Core Extraction** – Moved WooCommerce features to the dedicated MxChat WooCommerce add-on. | |
| 286 | 361 | |
| 287 | -Most powerful features are included in the free plan. Upgrade to Pro for the complete add-on ecosystem and advanced capabilities. | |
| 288 | -[View all pricing options](https://mxchat.ai/) | |
| 362 | += 2.0.3 = | |
| 363 | +- **Bug Fix:** Resolved issues preventing DeepSeek and Claude models from working correctly. | |
| 364 | +- **New:** Added integration for the MxChat Form Collection add-on (Pro only). | |
| 365 | +- **New:** Forms now display dynamically within the chat interface in real-time. | |
| 366 | +- **New:** Automatic intent handling for seamless form triggering. | |
| 367 | +- **Update:** Improved submission management with CSV export functionality. | |
| 289 | 368 | |
| 290 | -== Use of Third-Party Services == | |
| 369 | += 2.0.2 = | |
| 370 | +- **Bug Fix:** Auto-sync now properly deletes posts/pages when enabled. | |
| 371 | +- **Update:** Theme customization moved to an add-on with live preview support. | |
| 372 | +- **New:** Added MxChat Moderation plugin to ban users by email or IP. | |
| 291 | 373 | |
| 292 | -This plugin connects to AI service providers to generate responses: | |
| 374 | += 2.0.1 = | |
| 375 | +- **Bug Fix:** Fixed a DivisionByZeroError in sitemap processing that occurred when submitting an empty or malformed sitemap. | |
| 376 | +- **Bug Fix:** Resolved a similar DivisionByZeroError in PDF processing to prevent crashes when handling PDFs with 0 pages. | |
| 293 | 377 | |
| 294 | -**Service Providers:** | |
| 295 | -- [OpenRouter](https://openrouter.ai/) - [Terms](https://openrouter.ai/terms) | [Privacy](https://openrouter.ai/privacy) | |
| 296 | -- [OpenAI](https://openai.com/) - [Terms](https://openai.com/policies/terms-of-use/) | [Privacy](https://openai.com/policies/privacy-policy/) | |
| 297 | -- [Anthropic](https://anthropic.com/) - [Terms](https://www.anthropic.com/terms) | [Privacy](https://www.anthropic.com/privacy) | |
| 298 | -- [Google](https://ai.google.dev/) - [Terms](https://ai.google.dev/terms) | [Privacy](https://policies.google.com/privacy) | |
| 299 | -- [X.AI](https://x.ai/) - [Terms](https://x.ai/terms-of-service) | [Privacy](https://x.ai/privacy-policy) | |
| 300 | -- [DeepSeek](https://deepseek.com/) - [Terms](https://deepseek.com/terms) | [Privacy](https://deepseek.com/privacy) | |
| 378 | += 2.0.0 = | |
| 379 | +- **New UI & Branding:** Redesigned the entire plugin interface to align with the new MXChat brand for a modern and seamless experience. | |
| 380 | +- **Add-Ons System Introduced:** Added a dedicated Add-Ons page, allowing users to extend the plugin with optional features. Add-ons are completely optional and do not impact core functionality. | |
| 381 | +- **First Add-On Released – Pinecone DB Manager:** Now available for free! This add-on provides an intuitive interface for managing your Pinecone vector database directly within MXChat. | |
| 301 | 382 | |
| 302 | -Please ensure compliance with applicable terms and data privacy laws. | |
| 383 | += 1.6.5 = | |
| 384 | +- Optimized knowledge database retrieval to prevent memory issues with large product databases (2000+ products) | |
| 385 | +- Fixed bug with tab switching control in chat interface | |
| 303 | 386 | |
| 304 | -== Screenshots == | |
| 387 | += 1.6.4 = | |
| 388 | +- Added chat notifications for improved user experience when chat persistence is enabled. | |
| 389 | +- Made the entire plugin fully translatable, allowing compatibility with translation services like Loco Translate. | |
| 390 | +- Improved Slack integration: When a user requests a live agent, the last five messages from the conversation are now sent to Slack for better context. | |
| 305 | 391 | |
| 306 | -1. **Chat Transcripts Insights** - Review and analyze conversations insights to see engagement rate, peak activity, and user distribution. | |
| 307 | -2. **Chat Transcripts Insights** - View 7 day activity trend graph. | |
| 308 | -3. **Knowledge & Sitemap Submission** - Submit custom content to enhance the chatbot's responses. | |
| 309 | -4. **Action Page** - Set up Trigger Phrases and AI Tools (function calling) to complete specific actions. | |
| 310 | -5. **Plugin Settings Page** - Configure your API key and other settings. | |
| 311 | -6. **MxChat Debug Panel** - Easily debug and view your content matching scores, citation URLs, triggered actions and more. | |
| 392 | += 1.6.4 = | |
| 393 | +- Added chat notifications for improved user experience when chat persistence is enabled. | |
| 394 | +- Made the entire plugin fully translatable, allowing compatibility with translation services like Loco Translate. | |
| 395 | +- Improved Slack integration: When a user requests a live agent, the last five messages from the conversation are now sent to Slack for better context. | |
| 312 | 396 | |
| 313 | -*(Note: Screenshots will be added in future updates)* | |
| 397 | += 1.6.3 = | |
| 398 | +- Added the new "Rate Limit by User Role" feature, replacing the previous rate limit for logged-in users. | |
| 399 | +- Introduced DeepSeek as a new AI service provider, with full support for their models. | |
| 400 | +- Integrated DeepSeek V3, enhancing chatbot natural language understanding and performance. | |
| 314 | 401 | |
| 315 | -== Changelog == | |
| 402 | += 1.6.2 = | |
| 403 | +- Fixed a bug preventing the ability to save edits in the knowledge database. | |
| 316 | 404 | |
| 317 | -= 3.2.15 - July 28, 2026 = | |
| 318 | -* Fixed: DeepSeek chat works again. DeepSeek retired its older API model names on July 24, 2026, which broke every DeepSeek-powered chat; the model picker now offers DeepSeek V4 Flash and V4 Pro, and sites still set to an older DeepSeek model switch to V4 Flash automatically on update. | |
| 319 | -* New: Claude Opus 5 is available in the model picker — Anthropic's newest Opus model, the same price as Claude Opus 4.8, working across chat, streaming and the AI content tools. | |
| 320 | -* New: Optional performance setting to load chatbot files only on pages where the chatbot actually appears. Off by default, and helpful for reduce-unused-CSS-and-JS findings in performance audits. | |
| 321 | -* New: Slack live agent handoff can route every conversation into one shared channel your team already monitors, one thread per visitor, instead of creating a channel per visitor. Leave the new field blank and nothing changes. | |
| 322 | -* New: Optional setting to archive a conversation's Slack channel when an agent ends the chat, so channels stop piling up. Off by default. | |
| 323 | -* New: Place your knowledge base content anywhere in your AI instructions using the context placeholder. Leave it out and MxChat works exactly as before. | |
| 324 | -* New: The SEO content table now shows an average search position column from the last 28 days, available with the Advanced Content add-on connected to Search Console. | |
| 325 | -* Improved: When Search Console is not connected yet, the SEO content table now explains that connecting it fills the clicks, impressions and position columns, with a link to the Settings tab, instead of showing unexplained dashes. | |
| 326 | -* Improved: SEO content table sorting now keeps every post in the list on every filter, with posts that have no data grouped at the end. | |
| 327 | -* Improved: X.AI errors now include the provider's specific reason, such as the exact model name it could not find, alongside the general explanation. | |
| 328 | -* Improved: Sites using a delayed or on-interaction script loading strategy no longer perform an unnecessary database write on every page view. | |
| 329 | -* Fixed: The chat widget now defends itself against website themes whose styles bleed into it, including the header menu. Your own custom widget CSS keeps working unchanged. | |
| 330 | -* Fixed: When an AI provider returns a successful but empty reply, the chatbot now shows a clear message asking the visitor to try again instead of an empty chat bubble. Streaming chats close out the same way. | |
| 331 | -* Fixed: Provider errors now pass along the provider's actual explanation instead of a generic Unknown error, across image providers, embeddings, knowledge base search, web search, streamed replies and OpenRouter. | |
| 332 | -* Fixed: Conversations handled by a human now show as Live Agent in the Transcripts viewer and in emailed transcripts, instead of everything being labeled AI Assistant. | |
| 333 | -* Fixed: The streaming test button on the settings page now works with the newest Claude models, which previously returned an error even though chat itself worked. | |
| 334 | -* Fixed: Turning on developer mode no longer re-runs the plugin's activation and database migration routine on every page load. | |
| 335 | -* Fixed: The hourly rate-limit reset now re-creates itself if the scheduled task ever goes missing, so visitors are never left rate-limited longer than intended. | |
| 336 | -* Fixed: On sites where WordPress scheduled tasks are disabled, the hourly fallback check no longer loads a duplicate copy of the plugin's internals mid-request. | |
| 405 | += 1.6.0 = | |
| 406 | +- Redesigned knowledgebase UI for a cleaner, more user-friendly interface. | |
| 407 | +- Introduced auto-sync functionality for posts and pages, enabling automatic addition of new or updated content to the knowledgebase. | |
| 408 | +- Enhanced XML sitemap submission to prevent duplicate entries by checking and updating existing pages or adding new ones as needed. | |
| 409 | +- Reworked chatbot settings to enable individual autosave after updates, removing the need for manual saving. | |
| 410 | +- Fixed paragraph formatting in the chatbot UI to display line breaks and improve readability. | |
| 337 | 411 | |
| 338 | -= 3.2.14 - July 18, 2026 = | |
| 339 | -* New: Editor Assistant — optional AI writing actions right inside the WordPress block editor. Select a paragraph, heading, list, or quote block and rewrite it (concise, expanded, formal, or casual), summarize it, translate it to another language, continue writing, or fix grammar and spelling, then Accept or Discard. It is off by default and uses the AI model you already configured. | |
| 340 | -* New: You can now add YouTube videos to your knowledge base. A new YouTube option on the Import screen takes a video link and, per video, either auto-fetches its title, channel, and captions or lets you write your own description. When a visitor's question matches a video, the answer includes it as a playable embed right inside the chat that loads no YouTube player or Google cookies until the visitor taps play. | |
| 341 | -* New: Live agent handoff can now follow an availability schedule, so visitors are only offered a human during the days and hours your team is actually reachable, and the chatbot simply keeps answering outside them. Slack and Telegram each get their own independent schedule on their own settings tab, so a channel staffed at different hours keeps its own calendar. It is off by default and uses your site timezone. | |
| 342 | -* New: Added the latest OpenAI GPT-5.6 models — Sol, Terra, and Luna — for both your chatbot and content generation. | |
| 343 | -* New: MxChat AI Search now appears on the Pro and Extensions page alongside the other add-ons, so you can discover it from inside your dashboard. | |
| 344 | -* New: Developers can now add their own trusted links to the chatbot's allowed-links list with the new mxchat_valid_urls filter, so links returned by custom function-calling tools stay clickable in replies. | |
| 345 | -* Fixed: Editing a Knowledge Base entry no longer throws away your work. Clicking outside the edit box, or selecting text and releasing the mouse just past its edge, used to close it and discard everything you had typed. The box now closes only when you ask it to — the close or cancel button, the Escape key, or a successful save — and confirms first if you have unsaved changes. The same fix applies to the Add Tool and Edit Tool dialog on the Actions screen. | |
| 346 | -* Fixed: Product and image search now correctly refine your search terms when a GPT-5 model is selected. Previously the refinement step silently stopped working and fell back to the raw text, weakening results. | |
| 347 | -* Fixed: The Telegram live-agent webhook is no longer accepted without verification when a secret token has not been set; requests are now validated by origin and a reminder is shown to configure a secret. | |
| 348 | -* Fixed: The Testing page's chatbot replica now uses the exact same knowledge base as your live chatbot. On sites running Pinecone with the Multi-Bot add-on active, the testing chat was quietly searching the WordPress database instead. | |
| 349 | -* Fixed: Automatic transcript deletion now repairs its own schedule if the scheduled cleanup task is ever lost, so old transcripts no longer stop being deleted while your settings still say retention is on. The Transcripts settings also now show when the next cleanup will run. | |
| 412 | += 1.5.9 = | |
| 413 | +- Enhanced transcripts page with new analytics dashboard and improved UI | |
| 414 | +- Added support for X.AI's Grok model | |
| 415 | +- Improved message formatting to preserve paragraphs in intro messages | |
| 416 | +- Updated admin panel interface with better organization and styling | |
| 417 | +- Added better mobile responsiveness across admin screens | |
| 350 | 418 | |
| 351 | -= 3.2.13 - July 10, 2026 = | |
| 352 | -* New: Claude Sonnet 5 is now selectable as both a chat model and a content generation model. | |
| 353 | -* New: The Knowledge Base Custom Post Meta section can scan your content and suggest custom meta keys as clickable options, so you can add non-ACF meta to the embedding whitelist without knowing the exact key names. | |
| 354 | -* Fixed: Knowledge Base imports of PDFs and web pages no longer fail with a 403 error on firewall-protected hosts (SiteGround, Wordfence, Cloudflare) — MXChat now identifies itself with an honest, versioned MXChatBot user agent you can allowlist if needed. | |
| 355 | -* Fixed: PDFs a visitor links in a live chat now use the same MXChatBot identity, so a firewall that allowlists MXChatBot lets them through too. | |
| 356 | -* Fixed: The close button on the pre-chat greeting bubble now works on chatbots with a custom bot ID, including Multi-Bot setups, not just the default chatbot. | |
| 357 | -* Improved: The Custom Post Meta help text now points to the built-in key scanner and notes that array and repeater values are flattened during embedding. | |
| 419 | += 1.5.8 = | |
| 420 | +- Introduced a new setting to require an email address before starting a chat. When enabled, this email will be displayed at the top of the chat transcript if needed. | |
| 358 | 421 | |
| 359 | -= 3.2.12 - June 30, 2026 = | |
| 360 | -* Fixed: Resolved a WordPress.org packaging issue from the previous release that could cause the update to fail to download or appear to hang in the WordPress dashboard on some sites. This maintenance release republishes the plugin so every site can update normally and receive the recent improvements from 3.2.11 — including the per-provider Test API key buttons, built-in WPML and Polylang translation for the chat widget, Google Gemini web search, the optional Max Input Length character counter, cleaner Slack live-agent links, the Knowledge View indexed content panel, and the security and Pinecone matching fixes. No functional changes from 3.2.11; no settings or data are affected. | |
| 422 | += 1.5.7 = | |
| 423 | +- Enhanced Complianz plugin integration to support the premium version and improve reliability. | |
| 424 | +- Fixed an issue where names were not appearing in chat transcripts for logged-in users. | |
| 425 | +- Added the ability to customize the title bar icon in the theme settings. | |
| 426 | +- Grouped intents by category in dropdown menus for better organization and usability. | |
| 361 | 427 | |
| 362 | -= 3.2.11 - June 29, 2026 = | |
| 363 | -* New: Each AI provider API key field (OpenAI, X.AI, Claude, DeepSeek, Google Gemini, OpenRouter) now has a Test key button that checks whether the key actually works in one click, so you can confirm a key is valid right after pasting it instead of finding out only when a chat fails. It runs a quick, free validation check and never spends credits. | |
| 364 | -* Fixed: When restricting knowledge by tag under Knowledge then Role Restrictions, you can now enter a tag by its display name or its slug. Previously only the exact slug worked, so typing a real tag's name returned a confusing error; the field is now labeled Tag (name or slug) and gives an actionable message when no matching tag exists. | |
| 365 | -* Fixed: On sites using Pinecone for knowledge, answers added directly through Knowledge then Import Options then Direct Content (manual entries with no source link) are now used by the chatbot when they are the best match. Previously the bot could reply that it did not have the information even though the manual entry clearly matched, and the testing panel showed zero sources used; both are now correct. | |
| 366 | -* New: Built-in WPML and Polylang compatibility for the chat widget text. The widget's visible strings (top bar title, greeting, AI agent label, input placeholder, the email and name capture form copy, and the satisfaction prompts) now show up automatically in WPML String Translation, so you can translate the widget into each language without registering every field by hand. | |
| 367 | -* New: Optional Max Input Length setting caps how many characters a visitor can type or paste into a single message, so you can stop overly long pastes from being sent to the AI. It sits just below the Input Placeholder option in the chatbot settings. Leave it at 0 for unlimited, which is the default and keeps existing behavior unchanged. | |
| 368 | -* Fixed: Security hardening for the chat intro message setting, following a Wordfence advisory. The intro message is now escaped when shown on the settings page and sanitized when saved, so a crafted value can no longer run script in the admin area on multisite sites or sites where unfiltered HTML is disabled. | |
| 369 | -* Fixed: When a live agent replies from Slack with a link, the website visitor now sees a clean, clickable link instead of Slack's raw formatting with a stray closing bracket. Slack user and channel mentions and escaped characters are also tidied up before the message reaches the visitor. | |
| 370 | -* New: The Slack live-agent channel now shows the visitor's name and email at the top of the conversation when they were captured at the start of the chat, so your agent can see who they are talking to instead of just a session ID and a user ID of zero for guests. | |
| 371 | -* Improved: When a maximum message length is set, the chat box now shows a small live character counter as the visitor nears the limit, ramping from a neutral color to amber to red, with a gentle nudge if they reach the cap. This replaces the old behavior where typing past the limit silently did nothing and looked broken. The counter uses only numbers, so it reads correctly on sites in any language. | |
| 372 | -* New: When the built-in Web Search option is on, chatbots using a Google Gemini model now answer using live Google Search results, just like OpenAI models already do. Previously the Web Search setting only affected OpenAI models and silently did nothing for Gemini, so Gemini users had to add the separate Perplexity add-on to get web-grounded answers. Gemini's built-in search uses the Google API key you already configured, at no extra cost. | |
| 373 | -* New: Each Knowledge entry now has a View indexed content button that opens a read-only panel showing exactly what the chatbot indexed for it: the stored text broken into the same chunks the search uses, each chunk's length, and for Pinecone the stored metadata fields. This makes it easy to confirm what was actually saved and searched for a page or a manual entry, so you can tell at a glance why a piece of content is or is not being matched, without changing anything. | |
| 428 | += 1.5.6 = | |
| 429 | +- Improved "Add to Cart" and product recommendation intents for WooCommerce. | |
| 430 | +- Enhanced Brave Search intent for more accurate and structured results. | |
| 431 | +- Added an **Edit** button to the intent management section for easier adjustments. | |
| 432 | +- Fixed the Word document upload toolbar button for seamless functionality. | |
| 374 | 433 | |
| 375 | -= 3.2.10 - June 19, 2026 = | |
| 376 | -* New: AI Tools (function calling) — the chatbot can now decide on its own when to use your enabled tools, such as web search, image generation, answering from an uploaded PDF, and active add-on actions like WooCommerce, straight from natural language with no trigger phrases to set up. Turn it on under Actions then AI Tools (off by default; needs a tool-capable AI model), add the tools you want with a guided picker, and optionally tell the assistant in plain language when to use each one. Tools that spend money, expose customer data, or hand off to a human stay off until you enable them deliberately | |
| 377 | -* New: Optional "Start new chat" button in the chat window menu — lets visitors clear the current conversation and start fresh in one click, without turning off chat persistence (off by default; enable it under Chatbot then Display, with a customizable label) | |
| 378 | -* Improved: The Actions area is clearer — the original phrase-matching system is now called Trigger Phrases and sits alongside AI Tools under one Actions menu, with AI Tools listed first as the recommended path and a plain-language explainer of when to use each | |
| 379 | -* Improved: Readable, leak-safe AI error messages now cover every provider (Claude, OpenAI, xAI, Google Gemini, DeepSeek and OpenRouter) for both API errors and connection or timeout failures — site admins get an actionable hint such as choosing another model in Settings, while visitors only ever see a friendly fallback and never raw API or network details | |
| 380 | -* Improved: Applying or changing an AI theme, and toggling Pinecone, now auto-clears supported page caches the same way other settings changes do — no more stale widget appearance after a theme change | |
| 381 | -* Fixed: On multi-bot sites, non-streaming replies now correctly use the bot assigned to the visitor's session instead of falling back to the default bot's prompt and knowledge, and a repeated PHP notice in the debug log is gone | |
| 382 | -* Fixed: Images created with the Gemini image generator now display correctly in the chat window — previously the bot reported it had made an image but nothing appeared, because the file was saved with the wrong file type | |
| 383 | -* Fixed: The Slack live-agent setup notice in Settings now links to the current setup guide on the MxChat Core documentation page | |
| 384 | -* Fixed: Two older Claude models that Anthropic has now retired (Claude 4 Opus and Claude 4 Sonnet, the May 2025 versions) have been removed from the model pickers; if your site had either one selected, it is automatically switched to the current equivalent (Claude Opus 4.8 or Claude Sonnet 4.6) so chat keeps working without any action from you | |
| 385 | -= 3.2.9 - June 11, 2026 = | |
| 386 | -* New: Claude Fable 5 — Anthropic's newest flagship model — available in the Select AI Model picker and the Content Generator | |
| 387 | -* Fixed: Claude Opus 4.7 and 4.8 now work as the Content Generator model (these models reject the temperature setting; it is no longer sent) | |
| 388 | -* New: Stop button — visitors can halt a streaming response mid-answer; the text already written is kept | |
| 389 | -* New: "Show Download Transcript Button" toggle to hide the chat menu's Download Transcript item (on by default) | |
| 390 | -* Improved: Settings changes now apply immediately on cached sites — MxChat purges supported page caches on save, and the chat widget fetches fresh settings when opened, so toggles no longer require clearing caches | |
| 391 | -* New: "Images per Article" slider (1–5, default 3) in the Content Generator's image settings | |
| 392 | -* Fixed: Chat widget interface text no longer appears in your pages' Google search-result snippets | |
| 393 | -* Fixed: Admin navigation now displays correctly on right-to-left language sites (Arabic, Hebrew, Persian, and others) | |
| 394 | -* Fixed: In-chat PDF and Word document upload works again, including for signed-in administrators | |
| 395 | -* Fixed: Messages sent right after a bot reply no longer vanish on sites running the Image Analysis add-on | |
| 396 | -* Fixed: The "Was this helpful?" rating prompt only appears when its setting is turned on | |
| 397 | -* Fixed: Rebuilt translation template (mxchat.pot) — syncing a translation no longer discards existing translations | |
| 398 | -* Fixed: PHP 8.2 deprecation notices no longer logged during chat requests | |
| 434 | += 1.5.5 = | |
| 435 | +- Chat transcripts now display in newest-to-oldest order and are mobile responsive. | |
| 436 | +- Updated various setting texts with clearer descriptions for better usability. | |
| 437 | +- Fixed issue with rate limit not working properly. | |
| 438 | +- Added Word document upload to the frontend toolbar for direct chatbot interface use. | |
| 439 | +- Improved chatbot's contextual response accuracy. | |
| 440 | +- Major enhancements to "Add to Cart," "Checkout," and "Chat with PDF via URL" intents. | |
| 399 | 441 | |
| 400 | -= 3.2.8 - June 4, 2026 = | |
| 401 | -* New: Total chatbot message limit — one cap across all users and roles per timeframe, with a live usage readout and one-click reset | |
| 402 | -* New: Global and per-role rate limits accept custom values beyond the presets | |
| 403 | -* Improved: Custom Provider and Azure OpenAI embeddings work end-to-end for indexing and live queries (re-index if you had this enabled) | |
| 404 | -* Fixed: Feedback "Send" button no longer renders as an invisible white-on-white block | |
| 442 | += 1.5.4 = | |
| 443 | +- Enhanced chat transcripts layout for improved readability, better formatting support (e.g., bold, italics), and inclusion of test agent names from **MxChat AI Agents**. | |
| 444 | +- Introduced **MxChat AI Agents**, now available free for Pro users for a limited time, providing a revolutionary way to test and deploy your chatbot. | |
| 405 | 445 | |
| 406 | -= 3.2.7 - May 29, 2026 = | |
| 407 | -* New: Guided onboarding wizard for first-time setup — reopen any time from Settings → Tutorials | |
| 408 | -* New: Claude Opus 4.8 and the Google Gemini 3.x lineup; sites on retired models are migrated automatically | |
| 409 | -* Improved: First message is reliable behind full-page caches (WP Rocket, LiteSpeed, FlyingPress, W3 Total Cache, Cloudflare APO) | |
| 410 | -* Improved: Streaming and standard chat retry transient provider errors before showing a failure | |
| 411 | -* Improved: Floating chat button is fully keyboard-operable (WCAG 2.1 Level A) | |
| 446 | += 1.5.3 = | |
| 447 | +- Major bug fix to the similarity threshold comparison which prevented the chatbot from finding relevant content. | |
| 412 | 448 | |
| 413 | -= 3.2.6 - May 21, 2026 = | |
| 414 | -* New: Custom Provider (OpenAI-compatible) — point MxChat at Ollama, LM Studio, vLLM, llama.cpp, or Azure OpenAI, with a Test Connection button | |
| 415 | -* New: End-of-session "Was this helpful?" satisfaction rating with admin reporting and a dashboard card | |
| 416 | -* New: ACF PDF auto-indexing — PDF text from ACF file fields is extracted into the knowledge base (opt-in) | |
| 417 | -* New: Image Quality control for OpenAI GPT Image in the Content Generator | |
| 418 | -* New: Claude Opus 4.7, GPT-5.5, and GPT Image 2 in the model picker | |
| 419 | -* New: REST bulk-delete endpoint for chat sessions and an embedding chunk-metadata filter for developers | |
| 420 | -* Improved: Page-cache plugins are automatically told not to cache the chat endpoint, with a per-plugin status card | |
| 421 | -* Fixed: Intermittent "Access denied" on the first chat message under full-page caching | |
| 422 | -* Fixed: Print preview was blank on pages with MxChat installed | |
| 449 | += 1.5.2 = | |
| 450 | +- Enhanced checkout intent functionality to work more robustly, no longer requiring add-to-cart intent trigger. | |
| 451 | +- Fixed issue with send button not displaying properly on iPhone/iOS devices. | |
| 452 | +- Added admin control for similarity threshold matching to fine-tune relevant content results. | |
| 423 | 453 | |
| 424 | -= 3.2.5 - May 12, 2026 = | |
| 425 | -* New: REST API with bearer-token auth — read transcripts, push knowledge, bulk-delete sessions (disabled by default) | |
| 426 | -* New: Download Transcript menu item — saves the conversation as a Markdown file (replaces Print Conversation) | |
| 427 | -* New: Redesigned chat-widget header with X-close icon and keyboard-accessible 3-dot menu | |
| 428 | -* New: Content Generator writes SEO-title meta for Rank Math/Yoast/AIOSEO and syncs image alt text to the media library | |
| 429 | -* New: Transcript retention setting (1–3650 days) with automatic daily cleanup | |
| 430 | -* Fixed: Header dropdown menu inherits the bubble theme colors instead of hardcoded white | |
| 454 | += 1.5.1 = | |
| 455 | +- Vastly improved the ability for the chatbot to give contextually relevant responses from the knowledge database. | |
| 456 | +- Fixed the issue with loops in the lead capture intent. | |
| 457 | +- Updated the PDF upload icon in the frontend chatbot UI to a clearer design, now showing a PDF file icon. | |
| 458 | +- Enhanced the order history intent, recommendation intent, and product card intent for more robust and contextually relevant responses. | |
| 431 | 459 | |
| 432 | -= 3.2.4 - May 3, 2026 = | |
| 433 | -* Fixed: WooCommerce product Short Description Visual tab broken by a script 404 | |
| 434 | -* Fixed: User's last message scrolls to the top after streaming replies | |
| 460 | += 1.5 = | |
| 461 | +- **Live Agent Transfer**: Seamless integration for live agent handoffs and AI chatbot switching. | |
| 462 | +- **PDF Toolbar**: Added PDF upload to the chatbot interface and knowledge base processing with cron jobs. | |
| 435 | 463 | |
| 436 | -= 3.2.3 - April 29, 2026 = | |
| 437 | -* New: Embedding model switch protection — warning dialog and admin notice when stored embeddings don't match the selected model | |
| 438 | -* Improved: Landing Page Generator plans more sections and writes fuller copy | |
| 439 | -* Fixed: Landing Page "Full Width" option honored on WordPress block themes | |
| 440 | -* Fixed: Manual knowledge entries no longer cited with internal placeholder URLs | |
| 464 | += 1.4.6 = | |
| 465 | +- **Product Recommendation Intent**: Added personalized product recommendations based on order history, cart contents, and trending items. | |
| 466 | +- **Custom Chatbot Icon**: Users can upload custom PNG icons for a more personalized chatbot appearance. | |
| 467 | +- **Codeblock Copy Button**: Introduced a copy button for codeblocks to simplify copying code snippets. | |
| 468 | +- **Expanded Popular Questions**: Increased flexibility by allowing more than the default three popular questions. | |
| 469 | +- **CSS Compatibility Fixes**: Improved chatbot CSS for better theme compatibility. | |
| 441 | 470 | |
| 442 | -= 3.2.2 - April 21, 2026 = | |
| 443 | -* New: Lead Management Dashboard — deduplicated lead list with filters, top-pages analytics, CSV export, and one-click jump to conversations | |
| 444 | -* Fixed: Orphaned Pinecone vectors removed when posts or products are unpublished, deleted, or renamed | |
| 445 | -* Fixed: Source and chunk count settings now apply on all retrieval paths | |
| 471 | += 1.4.5 = | |
| 472 | +- **Fixed "Open Links in New Tab" Setting**: Resolved an issue where the setting to open links in a new tab was not functioning as expected. | |
| 446 | 473 | |
| 447 | -= 3.2.1 - April 17, 2026 = | |
| 448 | -* Fixed: Admin Testing Tab debug panel missing similarity scores and sources when web search and streaming were both enabled | |
| 449 | -* Fixed: Web search responses now save their sources to chat transcripts | |
| 474 | += 1.4.4 = | |
| 475 | +- **Custom Rate Limits**: Set different rate limits for logged-in and logged-out users. | |
| 476 | +- **PDF Intent Enhancements**: Added customizable trigger, success, and error messages, plus a max PDF page limit setting. | |
| 477 | +- **Improved Flexibility**: Greater control over chatbot behavior and user interactions. | |
| 450 | 478 | |
| 451 | -= 3.2.0 - April 15, 2026 = | |
| 452 | -* New: mxchat_similarity_results filter hook for add-ons | |
| 453 | -* Fixed: Removed attribute injection that conflicted with cache and optimization plugins | |
| 479 | += 1.4.3 = | |
| 480 | +- **PDF Intent**: Added support for processing and analyzing PDF content via provided URLs using vector embeddings. | |
| 481 | +- **Compatibility Fix**: Fixed a rendering issue that prevented the chatbot from displaying in certain environments. | |
| 454 | 482 | |
| 455 | -= 3.1.9 - April 7, 2026 = | |
| 456 | -* Fixed: "Session expired" errors caused by session-ownership issues | |
| 483 | += 1.4.2 = | |
| 484 | +- **Fixed Knowledge Search**: Fixed a bug impacting the ability to search knowledge database information. | |
| 457 | 485 | |
| 458 | -= 3.1.8 - April 6, 2026 = | |
| 459 | -* New: Admin Testing Tab — embedded chatbot replica with a real-time debug panel | |
| 460 | -* New: Individual trigger-phrase embeddings for more accurate action matching | |
| 461 | -* New: Loading indicator while chat initializes | |
| 462 | -* Improved: "Delete All" in the Knowledge Base respects the active content-type filter | |
| 486 | += 1.4.1 = | |
| 487 | +- **Fixed Intent Loading Issue**: Fixed a bug which prevented new intents from being shown on certain installs. | |
| 463 | 488 | |
| 464 | -= 3.1.7 - April 1, 2026 = | |
| 465 | -* New: Google Drive PDF links auto-convert to direct downloads for knowledge import | |
| 466 | -* Fixed: Chat history not appearing for returning visitors with persistence on and email collection off | |
| 467 | -* Fixed: Lead capture form not displaying for new visitors when email collection is enabled | |
| 468 | -* Fixed: Editing a legacy manual knowledge entry no longer deletes others sharing the same source URL | |
| 489 | += 1.4 = | |
| 490 | +- **Customizable Sensitivity Threshold**: Added support for individual sensitivity thresholds on each intent, offering more precise control over intent recognition. | |
| 491 | +- **Enhanced Usability Improvements**: Introduced a "Delete All" button for quick knowledgebase management, resolved activation key UI issues to prevent unnecessary re-activation, and improved chatbot viewport scrolling for better visibility of longer responses. | |
| 469 | 492 | |
| 470 | -= 3.1.6 - March 30, 2026 = | |
| 471 | -* Fixed: Pre-chat popup stays dismissed for 24 hours instead of reappearing on every refresh | |
| 472 | -* Fixed: Chat history not loading for returning visitors | |
| 473 | -* Fixed: Links with special characters being cut off or rendered as plain text | |
| 493 | += 1.3 = | |
| 494 | +- **Advanced Intent Recognition**: Introduced vector embedding for enhanced intent detection, improving chatbot responsiveness. | |
| 495 | +- **New Integrations**: Added **Brave Web Search**, **Brave Image Search**, and **DALL-E Image Generation** intents. | |
| 496 | +- **Security Update**: Minor update to unserialization handling for enhanced security. | |
| 474 | 497 | |
| 475 | -= 3.1.5 - March 25, 2026 = | |
| 476 | -* New: RAG Chunks Limit setting and tuned source defaults to balance answer quality and token cost | |
| 477 | -* New: Per-page chatbot visibility control from the page editor meta box | |
| 478 | -* Improved: Debugger and transcripts show the actual sources and chunks used | |
| 498 | += 1.2.1 = | |
| 499 | +- **Product Card Display**: Added a dynamic product card for WooCommerce users, showing product image, price, and an "Add to Cart" button triggered by product-related keywords. | |
| 500 | +- Enhanced **Popular Questions** and **Pre-Chat Message** functionalities for improved user engagement and streamlined chat initiation. | |
| 479 | 501 | |
| 480 | -= 3.1.4 - March 22, 2026 = | |
| 481 | -* New: OpenAI GPT-5.4 family and GPT-5.3 Chat models | |
| 482 | -* New: Editable default prompts for blog posts and landing pages in the Content Generator | |
| 483 | -* New: Inline knowledge-entry editing with automatic re-chunking and re-embedding | |
| 484 | -* New: Sitemap import supports PDF URLs | |
| 502 | += 1.2 = | |
| 503 | +- Added **Popular Questions Buttons** with one free question and two available in the **Pro version**. | |
| 504 | +- Added **Inline Edit Button** to the Knowledge Database for easy content management. | |
| 485 | 505 | |
| 486 | -= 3.1.3 - March 16, 2026 = | |
| 487 | -* New: Content Calendar tab on the Content page | |
| 488 | -* New: Multi-line chat teaser pop-up messages | |
| 489 | -* Improved: Session cookies deferred until first interaction — passive visitors no longer create sessions | |
| 490 | -* Improved: Markdown table rendering with column alignment and responsive scrolling | |
| 506 | += 1.1.9 = | |
| 507 | +- Added integration with Claude (Anthropic) API (Pro feature) for advanced conversational models like `Claude 3.5 Sonnet` and `Claude 3 Haiku`. | |
| 491 | 508 | |
| 492 | -= 3.1.2 - March 13, 2026 = | |
| 493 | -* New: Per-check AI fix buttons and batch "Optimize Selected" on the SEO dashboard | |
| 494 | -* Improved: Image generation upgraded from deprecated DALL-E 3 to GPT Image and Gemini Imagen 4 | |
| 495 | -* Fixed: Emojis in bot responses no longer prevent transcripts from saving | |
| 496 | -* Fixed: WooCommerce product cards display correctly in chat transcripts | |
| 497 | -* Fixed: "Optimize All" runs SEO fixes sequentially so they no longer overwrite each other | |
| 509 | += 1.1.8 = | |
| 510 | +- Added integration with X.AI API (Pro feature) for advanced chat completions using models like `grok-beta`. | |
| 511 | +- Introduced new model selection dropdown that separates OpenAI and X.AI models, with X.AI models disabled for free users. | |
| 512 | +- Enhanced API key management, allowing users to input and manage both OpenAI and X.AI API keys in settings. | |
| 498 | 513 | |
| 499 | -= 3.1.1 - March 4, 2026 = | |
| 500 | -* New: SEO analysis panel with real-time scoring and one-click AI Auto-Optimize | |
| 501 | -* New: Google Search Console integration (Pro) in the Content editor | |
| 502 | -* New: Slack agents can hand the conversation back to AI with !endchat, optionally with a farewell message | |
| 503 | -* Fixed: Stale nonce causing "Invalid nonce" errors on sites with full-page caching | |
| 504 | -* Fixed: Security-scanner false positives on transcript and PDF temp files | |
| 514 | += 1.1.7 = | |
| 515 | +* Added chat session persistence option for users to maintain conversations across visits for up to 24 hours. | |
| 516 | +* Updated navigation tabs CSS and scripts to prevent conflicts with other plugins. | |
| 517 | +* Rate limit settings are now available to all users, offering better control over chat usage. | |
| 505 | 518 | |
| 506 | -= 3.1.0 - March 1, 2026 = | |
| 507 | -* New: mxchat_before_process_post and mxchat_system_instructions filter hooks, with shortcode support in the system prompt | |
| 508 | -* Fixed: Manually entered knowledge content not used despite high similarity scores | |
| 509 | -* Fixed: Chat input remaining blocked after live-agent handoff | |
| 510 | -* Fixed: Pinecone scans failing with text-embedding-3-large (wrong vector dimension) | |
| 511 | -* Fixed: Shortcode stripping losing content on pages with large or deeply nested shortcodes | |
| 519 | += 1.1.6 = | |
| 520 | +* Minor CSS update. | |
| 512 | 521 | |
| 513 | -= 3.0.9 - February 24, 2026 = | |
| 514 | -* New: AI Content Generator — full blog posts and landing pages from a prompt, with AI images, SEO metadata, live preview, and inline AI editing | |
| 515 | -* New: Advanced Content Editor premium add-on | |
| 516 | -* Improved: Compatibility with optimization and caching plugins | |
| 522 | += 1.1.5 = | |
| 523 | +* Fixed error when users didn't have WooCommerce it would return "Error communicating with server". | |
| 517 | 524 | |
| 518 | -= 3.0.8 - February 20, 2026 = | |
| 519 | -* New: Debug and optimization tools with log viewer, settings export, and reset options | |
| 520 | -* New: Claude Sonnet 4.6 model | |
| 525 | +== Upgrade Notice == | |
| 521 | 526 | |
| 522 | -= 3.0.7 - February 15, 2026 = | |
| 523 | -* Fixed: GPT-5.1 Chat Latest returning an API error when web search was disabled | |
| 527 | += 2.4.1 = | |
| 528 | +Fixed: Email collection form not submitting properly when "Require email to chat" is enabled. | |
| 529 | +Improved: PDF processing now provides clearer error messages with repair suggestions when corrupted files are detected. | |
| 524 | 530 | |
| 525 | -= 3.0.6 - February 11, 2026 = | |
| 526 | -* New: RAG Sources Limit slider and {visitor_name} placeholder for personalized greetings | |
| 527 | -* New: Claude Opus 4.6 and Claude Opus 4.5 models | |
| 528 | -* Fixed: Chat persistence OFF now starts a fresh AI context on page reload | |
| 529 | -* Updated: Deprecated OpenAI GPT-4/GPT-3.5 and Claude 3.x models removed; affected sites migrated automatically | |
| 531 | +== License & Warranty == | |
| 530 | 532 | |
| 531 | -= 3.0.5 - January 28, 2026 = | |
| 532 | -* Fixed: Gemini embedding model updated to the stable gemini-embedding-001 | |
| 533 | -* Fixed: Notification settings not saving on new installations | |
| 534 | -* Fixed: Save indicators not visible on several settings fields | |
| 533 | +This plugin is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. | |
| 535 | 534 | |
| 536 | -= 3.0.4 - January 24, 2026 = | |
| 537 | -* New: Latest Google Gemini models | |
| 538 | -* New: Transcript translation — auto-translate chat transcripts to any language | |
| 539 | -* Fixed: Lead capture forms broken by multi-bot class ID changes | |
| 540 | - | |
| 541 | -= 3.0.3 - January 21, 2026 = | |
| 542 | -* Fixed: Chat input not re-enabling when web search was on | |
| 543 | - | |
| 544 | -= 3.0.2 - January 21, 2026 = | |
| 545 | -* New: Telegram Live Agent integration for live chat handoff | |
| 546 | -* New: Citation Links toggle to show or hide source URLs in AI responses | |
| 547 | - | |
| 548 | -= 3.0.1 - January 18, 2026 = | |
| 549 | -* New: OpenAI Vector Store integration and custom post-meta whitelist for embeddings | |
| 550 | -* New: Multi-select with bulk "Delete Selected" in the knowledge base | |
| 551 | -* Improved: Chatbot CSS migrated from IDs to classes for multi-bot support (Theme Customizer users: update the add-on and click "Migrate") | |
| 552 | - | |
| 553 | -= 3.0.0 - January 14, 2026 = | |
| 554 | -* New: Complete admin UI overhaul with modern sidebar navigation across all pages | |
| 555 | -* New: Automatic sitemap detection with one-click processing | |
| 556 | -* New: Real-time knowledge base updates and improved mobile responsiveness | |
| 557 | - | |
| 558 | -Older releases are archived in the plugin's full version history on WordPress.org. | |
| 559 | - | |
| 560 | -== Upgrade Notice == | |
| 561 | - | |
| 562 | -= 3.2.15 = | |
| 563 | -Restores DeepSeek chat after DeepSeek retired its older API model names on July 24, 2026, automatically switching affected sites to DeepSeek V4 Flash. Adds Claude Opus 5, a shared-channel mode for Slack live agent handoff, a context placeholder for positioning knowledge base content in your AI instructions, and an optional setting to load chatbot files only on pages where the chatbot appears. Also hardens the chat widget against theme style bleed and fixes empty AI replies, provider error messages, live agent transcript labels and several scheduled-task issues. | |
| 564 | - | |
| 565 | -= 3.2.14 = | |
| 566 | -Adds the Editor Assistant, YouTube videos in the knowledge base with consent-safe in-chat embeds, independent Slack and Telegram live agent availability schedules, and the latest GPT-5.6 models. Also fixes a Knowledge Base edit data-loss bug, GPT-5 product and image search, and self-healing automatic transcript deletion — existing sites are unaffected until you turn the new features on. | |
| 535 | +This plugin is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. | |
| 567 | 536 | |
| 568 | 537 | == Credits == |
| 569 | 538 | |
| 570 | 539 | This plugin incorporates the following third-party library: |
