WebChatAgent

<p>Add an AI chatbot and live chat to your WordPress site. Answer visitors 24/7, capture leads, book appointments and hand over chats to humans when it matters.</p>
<h3>🤖 Description</h3>
<p><strong>AI Chatbot & Live Chat for WordPress with ChatGPT and Gemini Support by WebChatAgent</strong> lets you add a powerful AI assistant and live chat widget to your WordPress website.</p>
<p>Use advanced features like <strong>RAG (Retrieval-Augmented Generation)</strong> with support for <strong>OpenAI ChatGPT</strong>, <strong>Google Gemini</strong>, <strong>xAI Grok</strong>, <strong>Mistral AI</strong> and other top AI models to give your visitors highly relevant answers based on your content. Combine this with <strong>human takeover (live chat)</strong> so your team can jump in whenever it matters.</p>
<p>You connect your site to your <strong>WebChatAgent</strong> account, where you manage all AI settings, design, live chat rules, WhatsApp integration, bookings and more. The WordPress plugin focuses on a smooth embed and a live preview in your WP admin.</p>
<p>Key integrations and tools include:</p>
<ul>
<li><strong>Action Bar & Form Builder</strong> – Add links, WhatsApp, Calendly scheduling, and custom lead-collection forms directly inside the chat widget</li>
<li><strong>Live Chat & Human Takeover</strong> – AI handles most questions, humans can take over any conversation in the inbox</li>
<li><strong>Proactive Triggers</strong> – Start conversations automatically based on visitor behavior (scroll depth, exit intent, inactivity and more)</li>
<li><strong>WhatsApp Business Integration</strong> – Engage users via your WhatsApp business number, with QR code and direct link in the chat widget</li>
<li><strong>API Connector for WooCommerce & More</strong> – Let customers check their WooCommerce order status, account info or support tickets directly in the chat</li>
<li><strong>Confluence & Notion Integration</strong> – Import wiki pages and databases as chatbot knowledge sources</li>
<li><strong>Zapier & n8n Integration</strong> – Automate workflows and connect to thousands of apps</li>
<li><strong>AI Team Wiki</strong> – Publish an AI-assisted team knowledge base on your subdomain</li>
<li><strong>Knowledge Tester</strong> – AI-powered quality testing that finds gaps in your chatbot’s knowledge</li>
<li><strong>Custom MCP (Model Context Protocol) Server Support</strong> – For advanced, self-hosted or custom AI models</li>
</ul>
<h4>✨ Key Features</h4>
<ul>
<li><strong>Generous Free Plan</strong> – Start free on WebChatAgent.com and upgrade only when you need more usage or advanced features</li>
<li><strong>Hybrid AI Chatbot + Live Chat</strong> – Let AI handle routine questions and let humans join any conversation in real time</li>
<li><strong>Human Takeover / Agent Inbox</strong> – View all conversations in one inbox and take over any chat with a single click</li>
<li><strong>Smart Contextual Answers</strong> – Uses RAG (Retrieval-Augmented Generation) to answer based on your website content and uploaded documents</li>
<li><strong>Multi-LLM Support</strong> – Switch between OpenAI ChatGPT, Google Gemini, xAI Grok, and Mistral AI models</li>
<li><strong>Message Streaming</strong> – Bot responses appear word by word in real time for a natural, modern chat experience</li>
<li><strong>Action Bar & Form Builder</strong> – Add a customizable action bar with up to 5 buttons: external links, WhatsApp contact, Calendly scheduling, and custom lead-collection forms</li>
<li><strong>Proactive Triggers</strong> – 9 intelligent trigger types (time on page, exit intent, scroll depth, inactivity, URL match, section visibility, returning visitor, pages visited, rage click) with AI-generated messages</li>
<li><strong>Calendly Integration</strong> – Embed your Calendly scheduling page directly inside the chat widget — no redirects</li>
<li><strong>WhatsApp Button in Widget</strong> – QR code on desktop, direct link on mobile — visitors can start a WhatsApp conversation from the chat widget header</li>
<li><strong>Knowledge Tester</strong> – AI generates test questions from your knowledge base, grades answers, and can fix gaps with one click</li>
<li><strong>Content Search</strong> – Search through the actual content of all your data sources with hybrid AI + keyword matching</li>
<li><strong>Custom MCP Server Support</strong> – Connect your own Model Context Protocol servers for self-hosted or specialized AI models</li>
<li><strong>Confluence & Notion Integration</strong> – Import wiki pages, knowledge bases, and databases directly into your chatbot (Premium+)</li>
<li><strong>AI Chat File Upload</strong> – Visitors can upload files and images in the chat for AI analysis (Premium+)</li>
<li><strong>Tool Integrations</strong> – Connect your chatbot with external services and systems to perform actions
<ul>
<li><strong>Lead Management</strong> – Automatically collect, qualify and manage potential customer information</li>
<li><strong>Feedback Management</strong> – Gather and analyze user feedback to improve your service and chatbot</li>
<li><strong>Questions Management</strong> – Track and categorize all questions asked to your chatbot</li>
</ul>
</li>
<li><strong>API Connector for WooCommerce & More</strong> – Connect your shop so customers get instant answers
<ul>
<li><strong>WooCommerce Order Status</strong> – Customers ask “Where is my order?” and your chatbot checks WooCommerce and answers in seconds</li>
<li><strong>WooCommerce Product Info</strong> – Let customers ask about product availability, prices or details from your shop</li>
<li><strong>Account & Order History</strong> – Look up customer accounts, past orders or membership status automatically</li>
<li><strong>Support Ticket Updates</strong> – Show real-time status of support requests without manual lookup</li>
<li><strong>Ready-Made WooCommerce Template</strong> – Get started in minutes with our pre-built WooCommerce connector — no coding needed</li>
<li><strong>Secure by Design</strong> – Customers must verify their identity (e.g. order email) before seeing personal data</li>
</ul>
</li>
<li><strong>WhatsApp Business Integration</strong> – Let your bot respond to customers on WhatsApp using your business number</li>
<li><strong>In-Chat Appointments & Bookings</strong> – Allow visitors to book appointments directly inside the chat (with Google Calendar sync on supported plans)</li>
<li><strong>Multilingual Support</strong> – Automatically responds in the user’s language; human replies can be translated as well</li>
<li><strong>WCAG 2.2 AA Accessibility</strong> – Ensures accessible use for all visitors regardless of disabilities</li>
<li><strong>Spam Protection</strong> – Prevents chatbot abuse and protects against unexpected usage spikes</li>
<li><strong>Drag & Drop File Upload</strong> – Upload PDF, Word, Excel, and text files by dragging them onto the Data Sources tab</li>
<li><strong>Bulk Actions</strong> – Select multiple data sources and delete or re-index them all at once</li>
<li><strong>Complete Customization</strong> – Customize appearance, persona, colors, fonts, behavior and more via the WebChatAgent dashboard</li>
<li><strong>Custom Role Presets</strong> – 6 ready-made chatbot personas to get started in seconds</li>
<li><strong>Live Preview</strong> – See your current widget in a live preview iframe inside the WordPress admin</li>
<li><strong>Responsive Design</strong> – Works perfectly on all devices and screen sizes</li>
<li><strong>Simple Embedding</strong> – Easy integration with your WordPress site using a single Chatbot ID</li>
</ul>
<h3>🚀 Installation</h3>
<ol>
<li>Upload the <code>webchatagent</code> folder to the <code>/wp-content/plugins/</code> directory of your WordPress installation <strong>or</strong> install it directly from the WordPress plugin directory.</li>
<li>Activate the plugin in the WordPress admin area under <strong>“Plugins”</strong>.</li>
<li>Register or log in at <strong>https://webchatagent.com</strong> and create your chatbot.</li>
<li>Copy your <strong>Chatbot ID</strong> from the WebChatAgent dashboard.</li>
<li>In WordPress, navigate to <strong>“WebChatAgent”</strong> in the admin menu and paste your Chatbot ID.</li>
<li>Enable the chatbot in the plugin settings to display the widget on your site.</li>
</ol>
<p>All design, AI, live chat, WhatsApp and behavior settings are managed in your WebChatAgent dashboard. The WordPress plugin handles the embed and displays a live preview based on your current configuration.</p>
<h3>⚙️ Frequently Asked Questions</h3>
<h4>Do I need an API key or account to use this plugin?</h4>
<p>You need to register at <strong>WebChatAgent.com</strong> to create a chatbot and get a <strong>Chatbot ID</strong>. You then enter this ID in the plugin settings to connect your WordPress site to your chatbot. API keys and model settings are managed in your WebChatAgent account.</p>
<h4>Is this plugin completely free?</h4>
<p>You can start with a <strong>free plan</strong> on WebChatAgent.com. There are paid plans available if you need higher limits, more pages, more traffic or advanced features like higher message quotas, team features and additional integrations.</p>
<h4>Can I customize the appearance of the chat widget?</h4>
<p>Yes. You customize the color scheme, avatar, fonts, welcome message, widget position, behavior and persona directly in the <strong>WebChatAgent dashboard</strong>. The WordPress plugin shows a live preview and uses your current configuration.</p>
<h4>Is the chat widget mobile-friendly?</h4>
<p>Yes, the chat widget is fully responsive and works well on all devices, including mobile phones and tablets.</p>
<h4>Does WebChatAgent support live chat and human takeover?</h4>
<p>Yes. WebChatAgent offers a <strong>hybrid model</strong>: AI answers most questions automatically, and your team can take over any chat at any time via the <strong>Agent Inbox</strong>. You can reply as a human and then hand control back to the bot if you like.</p>
<h4>Does the plugin support WhatsApp Business?</h4>
<p>Yes. You can connect your <strong>WhatsApp Business</strong> number in the WebChatAgent dashboard. Your AI chatbot can then reply to WhatsApp messages, and you can manage those conversations alongside website chats.</p>
<h4>How does the AI chatbot understand my website content?</h4>
<p>WebChatAgent uses <strong>RAG (Retrieval-Augmented Generation)</strong> to index and understand your website content and documents. When visitors ask questions, the AI combines this indexed content with a large language model (e.g. ChatGPT or Gemini) to provide accurate, context-aware answers.</p>
<h4>Which AI models are supported?</h4>
<p>The chatbot supports multiple large language models including <strong>OpenAI ChatGPT</strong>, <strong>Google Gemini</strong>, <strong>xAI Grok</strong>, and <strong>Mistral AI</strong>. You can choose which model to use in your WebChatAgent settings. Speed and quality indicators help you pick the right model. Additionally, you can connect <strong>custom MCP (Model Context Protocol) servers</strong> for self-hosted or specialized AI models.</p>
<h4>Does the chatbot support multiple languages?</h4>
<p>Yes, the chatbot automatically detects and responds in the user’s language, making it ideal for multilingual websites. Human replies in the inbox can also be auto-translated.</p>
<h4>Is the chat widget accessible for people with disabilities?</h4>
<p>Yes, the chat widget is designed to meet <strong>WCAG 2.2 AA</strong> accessibility standards, ensuring it’s usable for all visitors, including those using assistive technologies.</p>
<h4>Can the chatbot perform actions beyond just answering questions?</h4>
<p>Yes. With <strong>Tool Integrations</strong>, your chatbot can connect to external services and systems to perform actions such as submitting forms, booking appointments, updating records or querying databases. You configure these tools in your WebChatAgent dashboard.</p>
<h4>What is the API Connector and how does it work?</h4>
<p>The <strong>API Connector</strong> lets your chatbot answer questions that require live data from your WooCommerce shop or other business systems. Instead of just answering general questions, your chatbot can look up real information for each customer.</p>
<p><strong>WooCommerce examples:</strong></p>
<ul>
<li><strong>“Where is my order #12345?”</strong> – The chatbot checks your WooCommerce shop and tells the customer the current order status</li>
<li><strong>“Is the blue T-shirt in size M available?”</strong> – Looks up product stock and availability in WooCommerce</li>
<li><strong>“Show me my recent orders”</strong> – Displays the customer’s order history from your shop</li>
</ul>
<p><strong>Other systems:</strong></p>
<ul>
<li><strong>Support tickets</strong> – Show ticket status from helpdesk systems</li>
<li><strong>Account info</strong> – Look up balances, memberships or custom data from any system</li>
</ul>
<p><strong>How to set it up:</strong></p>
<ol>
<li>Select the <strong>WooCommerce template</strong> (or another template for your system)</li>
<li>The chatbot asks customers to verify their identity (e.g. their order email)</li>
<li>Once verified, the chatbot can look up their orders, products and personal data</li>
</ol>
<p>No programming knowledge required — the WooCommerce connector works out of the box.</p>
<h4>What analytics and management tools are included?</h4>
<p>From your WebChatAgent account, you can access:</p>
<ol>
<li><strong>Lead Management</strong> – Collect, categorize and follow up with leads generated through your chatbot  </li>
<li><strong>Feedback Management</strong> – Review and analyze user feedback to improve your chatbot and service  </li>
<li><strong>Questions Management</strong> – View all questions asked to your chatbot, identify common topics and improve your knowledge base  </li>
<li><strong>Analytics Dashboard</strong> – Track conversations, leads, bookings, human handovers and unanswered questions</li>
</ol>
<h4>How does the spam protection work?</h4>
<p>Built-in spam and abuse protection monitor usage patterns and prevent abusive or excessive requests. This helps protect your account from unexpected usage spikes and keeps your costs predictable on higher tiers.</p>
<h3>📷 Screenshots</h3>
<ol>
<li>WebChatAgent – AI Chatbot & Live Chat for WordPress settings page in the WordPress admin.</li>
<li>Live chat widget on your website – desktop view.</li>
<li>Mobile view of the chat widget.</li>
</ol>
<h3>📝 Changelog</h3>
<h4>1.0.3</h4>
<ul>
<li>Changed: Admin shows read-only values loaded from public endpoint</li>
<li>Changed: Only Chatbot ID and Enable are editable in WP; other settings managed in WebChatAgent dashboard</li>
<li>Added: Color swatches for theme and message colors in admin</li>
<li>Improved: Preview iframe sets html lang to current WP language</li>
</ul>
<h4>1.0.2</h4>
<ul>
<li>Added: Hide branding option in General tab</li>
<li>Added: Speech bubble text option in Messages tab</li>
<li>Added: Chat button image URL option in Appearance tab</li>
<li>Added: Live preview support for new options</li>
<li>Added: Documentation for dashboard tools (Leads, Feedback, Questions)</li>
<li>Added: Documentation for custom MCP server support</li>
<li>Improved: Widget rendering to include new attributes</li>
</ul>
<h4>1.0.0</h4>
<ul>
<li>Initial release</li>
</ul>
<h3>🔄 Upgrade Notice</h3>
<h4>1.0.3</h4>
<p>Adds admin read-only values, color swatches and language-aware preview. Also updates documentation for integrations (WhatsApp Business, Zapier, AI Team Wiki, MCP) and clarifies that most settings are managed in the WebChatAgent dashboard.</p>
<h4>1.0.2</h4>
<p>Initial release of the WebChatAgent – AI Chatbot for WordPress plugin.</p>
<h3>🔒 Privacy Policy</h3>
<p>WebChatAgent – AI Chatbot for WordPress processes user chat messages to provide AI-powered responses. When visitors interact with the chat widget, their messages are sent to WebChatAgent’s servers for processing. The chat widget also collects basic browser information and IP addresses (in anonymized form) for abuse prevention and geographical customization of services.</p>
<p>Chat conversations are typically stored for up to 30 days to maintain context and provide follow-up support. After this period, conversation data may be anonymized and retained for service improvement purposes.</p>
<p>For privacy inquiries, please contact <strong>privacy@webchatagent.com</strong>.</p>
<p>We operate in accordance with GDPR.</p>
<h3>🌐 External services</h3>
<p>This plugin connects to the WebChatAgent service (<strong>https://webchatagent.com</strong>) to provide chat functionality.</p>
<p>The service loads an external JavaScript file (<code>https://webchatagent.com/widget/web-chat-agent.js</code>) to render the chat widget on your website. This script is required for the widget to function properly.</p>
<p>When using custom fonts, external resources may be loaded from <strong>Google Fonts</strong> (<code>https://fonts.googleapis.com</code>). This means that data may be shared with Google when a visitor views your website with the chat widget enabled.</p>
<p>The service receives the following data when visitors use the chat:</p>
<ul>
<li>Chat messages and queries submitted through the chat widget  </li>
<li>Basic browser information (user agent, device type)  </li>
<li>Session information for conversation context preservation  </li>
<li>IP addresses, stored in anonymized form for abuse prevention and geographical service customization  </li>
</ul>
<p>Data is only sent when a visitor interacts with the chat widget. No data is collected or transmitted until the visitor actively engages with the chat.</p>
<p>Terms of Service: https://webchatagent.com/terms<br />
Privacy Policy: https://webchatagent.com/privacy-policy</p>


AI Chatbot & Live Chat with ChatGPT Support by WebChatAgent

Add an AI chatbot and live chat to your WordPress site. Answer visitors 24/7, capture leads, book appointments and hand over chats to humans when it m …

Zephyr

<p>IrisAI brings powerful AI chat capabilities to your WordPress site with semantic vector search (RAG) and source citations. Choose between two flexible connection modes and deploy with either a beautiful full-page chat interface or a convenient floating widget.</p>
<p>Watch the full setup & demo video:<br />
<span class="embed-youtube" style="text-align:center; display: block;"><iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/2ycKvTpWgLs?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></span></p>
<h4>Key Features</h4>
<ul>
<li><strong>Dual Interface Options</strong> – Full-page chat with hero section and wave animations, or floating chat widget with customizable positioning</li>
<li><strong>Vector Search (RAG)</strong> – Semantic search of your content using embeddings with automatic source citations</li>
<li><strong>Flexible Connection Modes</strong> – Proxy Mode (IrisAI hosted service) or BYO Mode (bring your own OpenAI API key)</li>
<li><strong>Complete Customization</strong> – Custom system prompts, configurable AI models, adjustable token limits, brand colors</li>
<li><strong>Privacy & Security</strong> – API keys never exposed to frontend, all requests server-side, GDPR compliance features</li>
<li><strong>Features</strong> – Multi-site support, chat history, auto-inject widget, rate limiting protection</li>
</ul>
<h4>Perfect For</h4>
<ul>
<li>Customer support automation</li>
<li>Website FAQs and knowledge base</li>
<li>E-commerce product assistance</li>
<li>Educational content interaction</li>
<li>Documentation search</li>
<li>Internal company wikis</li>
</ul>
<h4>How It Works</h4>
<ol>
<li><strong>Connect</strong> – Choose Proxy or BYO mode and enter credentials</li>
<li><strong>Index</strong> – Select content types and start vector indexing</li>
<li><strong>Deploy</strong> – Add shortcode or enable auto-inject widget</li>
<li><strong>Customize</strong> – Adjust colors, prompts, and behavior to match your brand</li>
</ol>
<h4>Privacy First</h4>
<p>IrisAI respects user privacy and data protection. Keys stored securely in WordPress database, server-side API calls only, optional privacy mode disables query logging, user consent checkbox for AI processing, and GDPR-ready features included.</p>
<h4>Documentation</h4>
<p>Complete setup guide and documentation available in the plugin’s Usage tab. Get step-by-step instructions, troubleshooting tips, and best practices.</p>
<h4>Frontend Dependencies</h4>
<p>This plugin includes the following open-source libraries:</p>
<ul>
<li><strong>sine-waves.min.js</strong> – MIT License – Wave animation effects (https://github.com/isuttell/sine-waves)</li>
<li><strong>three.min.js</strong> – MIT License – 3D graphics library (https://github.com/mrdoob/three.js)</li>
</ul>
<h3>External Services</h3>
<p>This plugin connects to external APIs to provide AI-powered chat responses and semantic (vector-based) search functionality.</p>
<p>The plugin may communicate with the following third-party services, depending on how it is configured by the site administrator.</p>
<h4>IrisAI Proxy Service (api.irisai.cloud)</h4>
<p>When using <strong>Proxy Mode</strong>, this plugin sends requests to the IrisAI proxy service to process AI chat queries and vector search requests.</p>
<p><strong>What the service is used for</strong><br />
• AI chat responses<br />
• Semantic (vector-based) search over your site content<br />
• Usage tracking, rate limiting, and billing management</p>
<p><strong>What data is sent</strong><br />
• User chat messages<br />
• Relevant indexed site content (for vector search)<br />
• Website domain (for license verification)<br />
• API authentication token</p>
<p><strong>When data is sent</strong><br />
• When a user submits a chat query<br />
• When content is indexed for vector search</p>
<p><strong>Service provider</strong><br />
IrisAI<br />
Website: https://irisai.cloud</p>
<p><strong>Terms of Service</strong><br />
https://irisai.cloud/terms</p>
<p><strong>Privacy Policy</strong><br />
https://irisai.cloud/privacy</p>
<h4>OpenAI API (api.openai.com)</h4>
<p>When using <strong>BYO (Bring Your Own API Key) Mode</strong>, or when the IrisAI proxy forwards requests, this plugin communicates directly or indirectly with OpenAI’s API.</p>
<p><strong>What the service is used for</strong><br />
• Generating AI-powered chat responses<br />
• Processing embeddings for semantic search</p>
<p><strong>What data is sent</strong><br />
• User chat messages<br />
• Relevant indexed site content (for vector search)</p>
<p><strong>When data is sent</strong><br />
• When a user submits a chat query<br />
• When content is indexed for semantic search</p>
<p><strong>Service provider</strong><br />
OpenAI, L.L.C.<br />
Website: https://openai.com</p>
<p><strong>Terms of Service</strong><br />
https://openai.com/terms</p>
<p><strong>Privacy Policy</strong><br />
https://openai.com/privacy</p>
<h4>Anthropic Claude API (api.anthropic.com)</h4>
<p>When administrators configure BYO mode with an Anthropic Claude API key, the plugin communicates with Anthropic’s API for chat completions and embeddings (when supported).</p>
<p><strong>What the service is used for</strong><br />
• Generating AI-powered chat responses via Claude<br />
• Processing semantic search/embedding data (where available)</p>
<p><strong>What data is sent</strong><br />
• User chat messages<br />
• Relevant indexed site content (for vector search)</p>
<p><strong>When data is sent</strong><br />
• When a user submits a chat query<br />
• When content is indexed for semantic search</p>
<p><strong>Service provider</strong><br />
Anthropic PBC<br />
Website: https://www.anthropic.com</p>
<p><strong>Terms of Service</strong><br />
https://www.anthropic.com/legal/terms-of-service</p>
<p><strong>Privacy Policy</strong><br />
https://www.anthropic.com/legal/privacy</p>
<h4>Google Gemini API (generativelanguage.googleapis.com)</h4>
<p>When administrators configure BYO mode with a Google Gemini API key (via Google AI Studio / Vertex AI), the plugin calls Google’s Generative Language API for chat completions or embeddings.</p>
<p><strong>What the service is used for</strong><br />
• Generating AI-powered chat responses via Gemini<br />
• Processing embeddings for semantic/Knowledge Index search</p>
<p><strong>What data is sent</strong><br />
• User chat messages<br />
• Relevant indexed site content (for vector search)</p>
<p><strong>When data is sent</strong><br />
• When a user submits a chat query<br />
• When content is indexed for semantic search</p>
<p><strong>Service provider</strong><br />
Google LLC<br />
Website: https://ai.google.dev</p>
<p><strong>Terms of Service</strong><br />
https://ai.google.dev/terms</p>
<p><strong>Privacy Policy</strong><br />
https://policies.google.com/privacy</p>
<h4>3.0.2</h4>
<ul>
<li>Fix: chat-history table now auto-creates after upgrading existing installs, so admin chat logs work without re-activation.</li>
<li>Fix: uninstall routine removes the <code>irisai_chat_history</code> table together with other plugin data.</li>
<li>Tweak: Knowledge Index naming and warnings updated across the UI for a more consistent setup experience.</li>
</ul>
<h4>3.0.0</h4>
<ul>
<li>Added support for additional AI models, including more ChatGPT options and models from Anthropic (Claude) and Google Gemini</li>
<li>PDF indexing support, enabling AI-powered search over uploaded documents</li>
<li>New Knowledge Index tab with an in-dashboard knowledge base view, document stats, and indexing controls</li>
<li>Added chat history storage plus an admin chat-history tab with filters, pagination, and a conversation viewer</li>
<li>Added admin debug mode: logged-in admins can enable a debug panel in the chat widget showing request details, response times, and error info
<ul>
<li>Performance and speed improvements for faster AI responses</li>
</ul>
</li>
</ul>
<h4>2.0.2</h4>
<ul>
<li>Improvement: Improved REST nonce handling to avoid “Security token expired” errors on cached pages.</li>
<li>Improvement: Better compatibility with caching plugins and CDN caching.</li>
</ul>
<h4>2.0.1</h4>
<ul>
<li>Added YouTube demo video to plugin description.</li>
</ul>
<h4>2.0.0</h4>
<ul>
<li>Introduces the new Setup Wizard.</li>
</ul>
<h4>1.0.5</h4>
<ul>
<li>Responsive style fixes</li>
</ul>
<h4>1.0.4</h4>
<ul>
<li>Improved compatibility with block themes by safely replacing the theme hero block with the live chat on the front-end while preserving the editor preview</li>
<li>Simplified chat interface by removing unused empty-state card markup to improve performance and reduce unnecessary HTML output</li>
</ul>
<h4>1.0.0</h4>
<ul>
<li>Initial public release</li>
<li>Full-page chat interface with [irisai_chat] shortcode</li>
<li>Floating widget with [irisai_widget] shortcode</li>
<li>Dual connection modes (Proxy and BYO)</li>
<li>Vector search with RAG capabilities</li>
<li>Source citations and reference links</li>
<li>Customizable wave animations</li>
<li>Brand color customization</li>
<li>Chat history with localStorage</li>
<li>Auto-inject widget option</li>
<li>Privacy mode and GDPR features</li>
<li>Rate limiting protection</li>
<li>Multi-language support</li>
<li>Responsive mobile design</li>
<li>Complete admin documentation</li>
<li>Background indexing system</li>
<li>Cache management</li>
<li>Clean uninstall option</li>
</ul>
<h3>Usage Examples</h3>
<h4>Shortcodes</h4>
<p>Full-Page Chat:</p>
<pre><code>[irisai_chat]
</code></pre>
<p>Creates a beautiful full-page AI chat interface with hero section, animated wave background, large search input, suggestion chips, real-time AI responses, and source citations.</p>
<p>Floating Widget:</p>
<pre><code>[irisai_widget]
[irisai_widget position="bottom-right"]
[irisai_widget position="bottom-left"]
[irisai_widget position="top-right"]
[irisai_widget position="top-left"]
</code></pre>
<p>Creates a floating chat button that opens a popup window with compact chat interface, persistent chat history, and mobile-friendly fullscreen.</p>
<h4>Knowledge Index Setup</h4>
<ol>
<li>Go to Settings > IrisAI > Knowledge Index</li>
<li>Select content types to index (Posts, Pages, Custom Post Types)</li>
<li>Configure chunk size (200-2000 characters, default: 900)</li>
<li>Configure chunk overlap (0-500 characters, default: 150)</li>
<li>Click “Start Indexing” to begin background processing</li>
<li>Enable “Auto Re-index” to automatically update on content changes</li>
</ol>
<h4>System Prompt Customization</h4>
<p>Customize the AI’s behavior with system prompts using available variables:</p>
<ul>
<li><code>{site}</code> – Your website URL</li>
<li><code>{lang}</code> – User language preference</li>
</ul>
<p>Example customizations by business type:</p>
<ul>
<li><strong>E-commerce</strong>: “Always mention our 30-day return policy when asked about returns”</li>
<li><strong>Service Business</strong>: “For pricing questions, invite users to schedule a consultation”</li>
<li><strong>Restaurant</strong>: “For reservations, direct users to call (555) 123-4567”</li>
</ul>
<h4>Best Practices</h4>
<p>For best results:</p>
<ul>
<li>Use full-width page template for [irisai_chat]</li>
<li>Index your most important content first</li>
<li>Add 5-8 relevant prompt suggestions</li>
<li>Keep system prompt clear and concise</li>
<li>Test on mobile devices before launch</li>
<li>Enable privacy mode if handling sensitive data</li>
</ul>
<p>Recommended setup:</p>
<ul>
<li>Use [irisai_chat] on dedicated page: “AI Assistant” or “Ask AI”</li>
<li>Enable auto-inject widget for site-wide access</li>
<li>This gives users both a destination and quick access</li>
</ul>
<p>Token recommendations:</p>
<ul>
<li>800-1000 tokens: Normal chat (balanced responses)</li>
<li>1500-2000 tokens: Developer mode or detailed explanations</li>
<li>3000-6000 tokens: Long-form content or article generation</li>
</ul>
<h4>Troubleshooting</h4>
<p><strong>Chat not working?</strong></p>
<ol>
<li>Verify API credentials in General tab</li>
<li>Check domain is registered in proxy dashboard (Proxy Mode)</li>
<li>Ensure sufficient credits (Proxy Mode)</li>
<li>Confirm content is indexed (Knowledge Index tab)</li>
<li>Check browser console for JavaScript errors</li>
<li>Enable WP_DEBUG in wp-config.php for detailed logs</li>
</ol>
<p><strong>Vector search not finding content?</strong></p>
<ol>
<li>Confirm indexing completed successfully</li>
<li>Check selected content types are correct</li>
<li>Try re-indexing content</li>
<li>Clear Knowledge Index cache (General tab)</li>
<li>Verify chunk size isn’t too large or small</li>
</ol>
<p><strong>Widget not appearing?</strong></p>
<ol>
<li>Check auto-inject is enabled (Widget tab)</li>
<li>Verify no JavaScript conflicts</li>
<li>Clear browser and WordPress cache</li>
<li>Check theme compatibility</li>
<li>Try manual shortcode placement</li>
</ol>
<h3>Privacy Policy</h3>
<p>IrisAI is designed with privacy in mind:</p>
<ul>
<li>API Keys: Stored securely in WordPress database, never exposed to frontend</li>
<li>Chat Queries: Optional logging (disabled in privacy mode)</li>
<li>Chat History: Stored in user’s browser localStorage (client-side only)</li>
<li>Vector Data: Your content chunks stored in WordPress database for search</li>
<li>Usage Stats: Available only in Proxy Mode dashboard (irisai.cloud)</li>
</ul>
<p>What data is sent to third parties:</p>
<ul>
<li>OpenAI: User queries and relevant content chunks (when BYO or Proxy mode is used)</li>
<li>IrisAI Proxy: Only in Proxy Mode – queries, API authentication, usage tracking</li>
<li>No other third parties receive data</li>
</ul>
<p>User rights:</p>
<ul>
<li>Users can clear their chat history via “New Chat” button</li>
<li>Site owners can disable query logging (Privacy Mode)</li>
<li>Complete data removal via clean uninstall option</li>
</ul>
<p>Recommendations:</p>
<p>If you use IrisAI on your site, we recommend adding AI data processing to your privacy policy, implementing user consent (checkbox available in Advanced settings), enabling privacy mode for GDPR compliance if needed, and informing users their questions are processed by AI.</p>
<h3>Uninstall</h3>
<p>When you delete IrisAI via the Plugins screen, you can optionally remove all plugin data including settings, Knowledge Index data, cached search results, and database tables.</p>
<p>To perform clean uninstall:</p>
<ol>
<li>Go to Settings > IrisAI > Advanced tab</li>
<li>Enable “Remove data on uninstall” option</li>
<li>Save changes</li>
<li>Deactivate the plugin</li>
<li>Delete the plugin from Plugins screen</li>
<li>All data will be removed automatically</li>
</ol>
<h3>Credits</h3>
<p>This plugin incorporates the following third-party library:<br />
*Smalot PDF Parser**: Used for parsing and extracting text from PDF files. This library is developed by Smalot and distributed under the MIT License. For more details, visit the <a href="https://github.com/smalot/pdfparser" rel="nofollow ugc">Smalot PDF Parser GitHub repository</a>.</p>
<ul>
<li>sine-waves by Isaac Suttell</li>
<li>three.js by three.js authors</li>
<li>Plugin by IrisAI Team</li>
<li>Website: https://irisai.cloud</li>
</ul>


Iris AI – AI Homepage, Chatbot & Site Assistant

Transform your WordPress site with AI-powered chat. Full-page interface or floating widget. Vector search with citations.

AI Chatbot & Live Chat with ChatGPT Support by WebChatAgent vs Iris AI – AI Homepage, Chatbot & Site Assistant