=== AI Chatbot - ChatGPT, Gemini 2.5 & WordPress Chat === Contributors: limbdev, raffiyeghiazaryan, vahangrigoryan, gorgaranyan Tags: chatbot, ai chatbot, chatgpt, gemini, live chat Requires at least: 5.8 Tested up to: 6.8 Requires PHP: 7.4 Stable tag: 1.0.3 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html AI chatbot with ChatGPT, Gemini 2.5, RAG technology, WooCommerce integration, and unlimited knowledge training. Quick 3-step setup wizard gets you live in minutes. == Description == Transform your WordPress site with an AI chatbot that understands your content. Train on unlimited website data using advanced RAG technology, choose from 15+ leading AI models, and customize everything to match your brand—no coding required. [Live Demo](https://wpaichatbot.com/demo) | [Documentation](https://wpaichatbot.com/documentation/) = Why Choose AI Chatbot? = ⭐ **Experience True Quality — Intuitive and 100% WordPress Native.** Professional-grade AI chatbot with clean code, polished UI, and extensible architecture built with industry best practices. **What You Get:** ✅ **15+ AI Models** - GPT-5, GPT-5 Mini, Gemini 2.5 Flash, Gemini 2.5 Pro, GPT-4.1, GPT-4o, and more ✅ **Advanced RAG Technology** - Intelligent retrieval for accurate, contextually relevant responses ✅ **Cost-Optimized Usage** - Smart token management minimizes API charges ✅ **Knowledge Transparency** - See exactly which content AI used for each response ✅ **Unlimited Knowledge Base** - Train on pages, posts, PDFs, text files, or Q&A entries ✅ **Conversations Dashboard** - Complete chat history with AI source visibility ✅ **3-Step Setup Wizard** - Live in under 5 minutes with guided onboarding ✅ **Rate Limiting** - Control usage for guests and logged-in users ✅ **Theme Support** - Light mode, dark mode, and system theme options ✅ **True WordPress Native** - Real platform integration, not an iframe 🚀 **Designed to Scale** Flexible architecture that grows with your business. Start simple, expand seamlessly. = Core Features = Your AI chatbot includes everything you need for intelligent customer engagement: ✅ **Quick 3-Step AI Chatbot Setup** Guided wizard launches after activation. Connect your AI provider, configure personality, add knowledge sources, and customize appearance—live in under 5 minutes. ✅ **Advanced AI Chatbot RAG Technology** Train on unlimited WordPress content using Retrieval-Augmented Generation. Supports pages, posts, custom post types, PDFs, text files, rich text input, and Q&A entries. Intelligent intent recognition retrieves the most relevant knowledge for accurate responses. ✅ **Chat Discussions Dashboard** Complete conversation management with detailed insights. View all transcripts, see which knowledge sources AI used, add missing Q&A entries directly, and track user information including guest/logged-in status and IP addresses. ✅ **Cost-Optimized AI Usage** Smart token management minimizes API charges. Intelligent request optimization ensures you pay only for what you need. Configure rate limits to control expenses. ✅ **Customizable Chat Experience** Unlimited widgets including Message Starters, Message Prompts, Chat History, Links, and custom announcements. Fully customizable greetings with emoji support. ✅ **Flexible Vector Storage** Choose local WordPress database (free, unlimited) or Pinecone for enterprise-scale knowledge bases. Vector embeddings enable fast, contextually relevant retrieval. ✅ **Complete Customization** Customize colors, chatbot icon, AI avatar, chat box size, themes (light/dark/system), positioning, emojis, and greeting messages. Adapts seamlessly to all devices. ✅ **Multi-Language Support** Conversations in multiple languages with RTL compatibility. The AI chatbot responds in your visitors' language. ✅ **GDPR Compliant** All conversation data stored locally on your WordPress site. You control data retention, export, and deletion policies. = Supported AI Models = **Google Gemini** - Gemini 2.5 Flash, Gemini 2.5 Flash Lite, Gemini 2.5 Pro - Gemini 2.0 Flash - Gemini Embedding 001 (for knowledge base) **OpenAI GPT** - GPT-5, GPT-5 Mini, GPT-5 Nano - GPT-4.1, GPT-4.1 Mini, GPT-4.1 Nano - GPT-4o, GPT-4o Mini - GPT-4 Turbo, GPT-4 - Text Embedding 3 Small, Text Embedding 3 Large, Text Embedding ada 002 (for knowledge base) 🔜 Claude (Anthropic), Grok (X.AI), and DeepSeek coming soon. = Knowledge Sources = Train your AI chatbot on multiple content types: - WordPress Pages & Posts - Custom Post Types - PDF Documents - Text Files (.txt) - Rich Text Editor (unlimited input) - Simple Q&A Entries Content is processed using vector embeddings and stored in your WordPress database or Pinecone for fast, contextually relevant retrieval. = Coming Soon = 🚀 **Smart Actions** - Advanced intent recognition with automated workflows for contact forms, lead generation, and support tickets 🛒 **WooCommerce Integration** - Product recommendations, add-to-cart, order status tracking, and inventory questions 💬 **Slack Integration** - Seamless live agent handoff with bidirectional messaging ⚡ **Streaming Responses** - Real-time word-by-word AI replies for faster conversations 🎓 **OpenAI Fine-Tuning** - Train custom models on your Q&A dataset for domain-specific conversations = Quick Setup = Your AI chatbot launches in 3 simple steps: 1️⃣ **Activate Plugin** - Setup wizard appears automatically 2️⃣ **Connect AI Provider** - Enter your API key and configure AI agent personality 3️⃣ **Add Knowledge** - Import pages, posts, or upload documents for RAG training Live in under 5 minutes with no technical knowledge required. == Installation == = Automatic Installation = 1. Go to your WordPress dashboard 2. Navigate to **Plugins > Add New** 3. Search for "AI Chatbot" or "Limb Chatbot" 4. Click **Install Now**, then **Activate** 5. Follow the setup wizard to configure your chatbot = Manual Installation = 1. Download the plugin ZIP file 2. Upload to `/wp-content/plugins/` directory 3. Extract the files 4. Activate through the **Plugins** menu in WordPress 5. Follow the setup wizard to configure your chatbot = Getting Your API Keys = **OpenAI:** Visit [platform.openai.com](https://platform.openai.com), sign up, navigate to API keys, create a new key, and paste into the plugin setup wizard. **Google Gemini:** Visit [ai.google.dev](https://ai.google.dev), get started with Gemini API, generate your key, and paste into the plugin setup wizard. **Pinecone (Optional):** Visit [pinecone.io](https://pinecone.io), sign up for free, create a new index, copy your API key, and paste into plugin settings. == Frequently Asked Questions == = What AI models does the AI chatbot support? = The AI chatbot supports 15+ models including GPT-5, GPT-5 Mini, Gemini 2.5 Flash, Gemini 2.5 Pro, GPT-4.1, GPT-4o, GPT-4 Turbo, and various embedding models. Claude, Grok, and DeepSeek coming soon. = How do I get API keys? = For OpenAI, visit platform.openai.com and create an account. For Google Gemini, visit ai.google.dev and follow the setup process. = Can I train the chatbot on my website content? = Yes. The AI chatbot supports unlimited knowledge training using RAG technology from WordPress pages, posts, custom post types, PDFs, text files, and manual Q&A entries. = What is RAG technology? = RAG (Retrieval-Augmented Generation) retrieves relevant information from your knowledge base before generating responses, ensuring accurate, contextually appropriate answers based on your actual content. = Is there a setup wizard? = Yes. A guided 3-step setup wizard appears automatically after activation, walking you through AI provider connection, personality configuration, knowledge sources, and customization. = How long does setup take? = Most users complete setup in under 5 minutes. The wizard guides you through each step with clear instructions. = How does cost optimization work? = The AI chatbot uses intelligent token management to minimize API charges through optimized requests and efficient caching. Configure rate limits for guests and logged-in users to control costs. = What is the Chat Discussions Dashboard? = A comprehensive conversation management interface showing all chat transcripts with detailed conversation views. See which knowledge sources AI used for each response, add missing Q&A entries directly, and track user information. = Can I see which content the AI used? = Yes. The Chat Discussions Dashboard shows knowledge source transparency—you can see exactly which pages, posts, or Q&A entries the AI chatbot used to generate each response. = Is Pinecone required? = No. The AI chatbot includes free, unlimited local vector storage in your WordPress database. Pinecone is optional for enterprise-scale knowledge bases with 10,000+ entries. = Is the plugin GDPR compliant? = Yes. The AI chatbot stores conversation data locally on your WordPress site, giving you complete control. Configure data retention policies and export or delete conversations as needed. = Can I customize the AI chatbot appearance? = Yes. Customize colors, chatbot icon, AI agent avatar, chat box size, themes (light/dark/system), positioning, emojis, greeting messages, and widget layouts without coding. = Does it support multiple languages? = Yes. The AI chatbot supports multi-language conversations and right-to-left (RTL) languages, responding in the language your visitors use. = How much do API calls cost? = API usage depends on your chosen provider and models. OpenAI and Google Gemini charge based on token usage with rates varying by model. Gemini offers generous free tiers. The AI chatbot's intelligent cost optimization minimizes charges by reducing unnecessary calls and optimizing token usage. Check current pricing: platform.openai.com and ai.google.dev = Can I control costs? = Yes. Configure rate limits for guests and logged-in users. The AI chatbot's intelligent token management minimizes costs automatically. = Can I see conversation history? = Yes. The Chat Discussions Dashboard includes comprehensive chat transcripts with conversation history, user context, knowledge sources used, and detailed analytics. = When are Smart Actions launching? = Smart Actions, WooCommerce integration, Slack integration, and streaming responses are launching soon as free updates. == Screenshots == 1. **Setup Wizard** - 3-step guided onboarding: AI provider connection, ChatGPT/Gemini setup, personality configuration, and knowledge training 2. **Chat Discussions Dashboard** - Complete conversation management with AI knowledge source transparency, RAG insights, and user analytics 3. **Knowledge Base Manager** - Unlimited RAG training from WordPress pages, posts, PDFs, text files with vector embeddings 4. **Customizable Chat Widget** - Responsive AI chatbot with ChatGPT/Gemini, light/dark themes, and mobile-optimized design 5. **AI Model Settings** - Choose from 15+ models: Gemini 2.5 Flash, Gemini 2.5 Pro, GPT-4.1, GPT-4o with easy provider switching 6. **Appearance Customization** - Complete visual control: color schemes, chatbot icons, AI avatars, themes, and positioning 7. **Widget Configuration** - Message Starters, Chat History, Prompts, Links, and custom homepage chat elements == Changelog == = 1.0.3 - Current Release = * Fixed: PDF knowledge collecting timeout issue * Fixed: Assets caching issue * Fixed: Chatbot buttons hover bg-color issue * Added: AI reply reload button * Added: OpenAI GPT-5 support * Changed: Chatbot admin menu ordering * Improved: Knowledge collecting = 1.0.2 = * Fixed: UI/UX issues on iOS Safari with latest update * Added: "Text" knowledge source type for flexible content input (old "Manual" is now "Q&A") * Added: Uninstall page for clean plugin removal * Changed: Removed "Storage" page from menu (consolidated into settings) * Changed: "Informational" page renamed to "Sources" for clarity * Changed: Training page temporarily marked as "Coming Soon" while we refine features * Improved: Overall admin interface clarity and navigation * Improved: Cost optimization for API token usage = 1.0.1 = * Fixed: Hub theme custom post type fetching issue resolved * Changed: Redesigned message layout for better readability * Added: Feature preview with upcoming launches * Added: Knowledge source transparency in chat logs = 1.0.0 = * Initial release of AI Chatbot * Feature: Multi-provider AI support (OpenAI GPT, Google Gemini) * Feature: Unlimited knowledge base with RAG technology * Feature: Customizable widgets (Message Starters, Prompts, Links, Chat History) * Feature: Chat Discussions Dashboard with knowledge source visibility * Feature: Full appearance customization with theme support * Feature: Cost-optimized API usage * Feature: Conversation logging and chat transcripts * Feature: GDPR-compliant data handling * Feature: Multi-language and RTL support * Feature: Responsive mobile-first design * Feature: Rate limiting and cost control == Upgrade Notice == = 1.0.3 = Critical fixes for PDF timeout and asset caching issues. Added GPT-5 support, AI reply reload button, and improved knowledge collection process. Recommended update for enhanced stability and new features. = 1.0.2 = Improved iOS Safari compatibility, new Text knowledge source type, and simplified admin interface. Enhanced cost optimization and knowledge source transparency. Update recommended for the best experience. = 1.0.1 = Bug fixes for Hub theme users and improved message design with knowledge source tracking. = 1.0.0 = Welcome to AI Chatbot! The chatbot with RAG technology, unlimited knowledge training, and cost-optimized AI usage. == External Services == This plugin connects to third-party AI services to generate chatbot responses. You must provide your own API keys and comply with each provider's terms of service. **AI Service Providers:** * **OpenAI** - Chat completions, embeddings, image generation - API Endpoint: https://api.openai.com - [Terms of Use](https://openai.com/policies/terms-of-use) - [Privacy Policy](https://openai.com/policies/privacy-policy) * **Google Gemini** - Chat completions, embeddings, image generation - API Endpoint: https://generativelanguage.googleapis.com - [Terms of Service](https://policies.google.com/terms) - [Privacy Policy](https://policies.google.com/privacy) * **Pinecone** *(Optional)* - Vector database for knowledge storage - API Endpoint: https://api.pinecone.io - [Terms of Service](https://www.pinecone.io/terms-of-service/) - [Privacy Policy](https://www.pinecone.io/privacy/) * **DeepSeek** *(Coming Soon)* - Chat completions and embeddings - API Endpoint: https://api.deepseek.com - [Terms of Service](https://cdn.deepseek.com/policies/en-US/deepseek-open-platform-terms-of-service.html) - [Privacy Policy](https://cdn.deepseek.com/policies/en-US/deepseek-privacy-policy.html) **You are responsible for:** - Obtaining and managing your own API keys - Monitoring your API usage and costs - Complying with each service provider's terms and policies - Ensuring your use case meets provider requirements == Libraries & Credits == **Third-Party Libraries:** * **WP Background Processing** by Delicious Brains - Efficient asynchronous job management - Repository: [github.com/deliciousbrains/wp-background-processing](https://github.com/deliciousbrains/wp-background-processing) - License: GPLv2 or later **Development Team:** AI Chatbot is developed and maintained by the team at [wpaichatbot.com](https://wpaichatbot.com). == Support & Documentation == **Need Help?** * 📚 [Full Documentation](https://wpaichatbot.com/documentation/) * 💬 [Community Forum](https://wordpress.org/support/plugin/limb-chatbot/) * 🌐 [Official Website](https://wpaichatbot.com) * 📧 [Email Support](mailto:support@wpaichatbot.com) == Privacy & Data == **Your Data, Your Control:** - All chat conversations are stored locally in your WordPress database - No data is sent to external services except AI providers (OpenAI, Gemini) for response generation - You have complete control over data retention and deletion policies - GDPR-compliant data handling with export and erasure capabilities - User data is handled according to WordPress privacy standards == Roadmap == **Launching Soon:** 🚀 Smart Actions - Intent recognition with automated workflows 🛒 WooCommerce & SureCart Integration - Shopping assistance and order tracking 💬 Slack Integration - Human support handoff with bidirectional messaging ⚡ Streaming Responses - Real-time word-by-word AI replies **Coming Later:** 🤖 Claude (Anthropic) AI models ⚡ Grok (X.AI) AI models 🧠 DeepSeek AI models 🎓 OpenAI fine-tuning support 🔗 Additional integrations == Upgrade to Pro == ⭐ The Pro version includes advanced features: * 🤖 Multi-Agent Publishing - Deploy multiple AI agents across different sites * 🎨 White Label Branding **(Coming Soon)** - Custom logos and icons for chatbot and AI agent * ⚡ Advanced Smart Actions **(Coming Soon)** - Multiple callbacks per action, premium parameters * 🧩 Chatbot & Prompt Blocks - Gutenberg integration for inline chat and prompt inputs * 🎯 Premium Widgets - Advanced UI components and interactive elements [Learn more about Pro features](https://wpaichatbot.com/pricing)