Global AI

<p><strong>Global AI Chat puts a helpful AI assistant on your website that talks to your visitors 24/7.</strong> It welcomes people, answers their questions in plain language, points them to the right page, and quietly turns those conversations into leads — so you capture interest even while you sleep.</p>
<p>It runs on OpenAI’s models using <em>your own</em> OpenAI key, so you stay in control and OpenAI bills you directly for what you use. No middle-man, no monthly plugin fee.</p>
<p><strong>Everything here is free and fully functional</strong> — no trials, no locked buttons, no time limits, no “upgrade to continue”.</p>
<h4>Why you’ll like it</h4>
<ul>
<li><strong>Up and running in minutes</strong> — paste your OpenAI key, pick a personality (Support, Sales/SDR or FAQ), and you’re live.</li>
<li><strong>Looks like part of your brand</strong> — customise colours, icon, position and the welcome message.</li>
<li><strong>Turns chats into leads</strong> — the assistant naturally collects name, email, phone, company and any custom field you want, and saves them for you.</li>
<li><strong>Works everywhere you build</strong> — a floating widget, the <code>[growthai_chat]</code> shortcode, plus blocks for Gutenberg, Elementor, Divi, Beaver Builder and WPBakery.</li>
<li><strong>Speaks your visitor’s language</strong> — automatically replies in the visitor’s browser language.</li>
<li><strong>Knows your content</strong> — upload documents so the assistant answers from your own material, not guesses.</li>
<li><strong>Privacy-friendly</strong> — optional cookie-consent banner and a one-click “delete all my data on uninstall” switch. Your conversations stay in your own database.</li>
</ul>
<h4>Go further with Global AI Chat Pro</h4>
<p>When you’re ready to scale, the optional <strong>Global AI Chat Pro</strong> add-on builds right on top of this free plugin. It’s a separate download — learn more at https://globalai.software/plugin-global-ai-chat. Install it and everything you already set up keeps working; remove it and the free plugin carries on exactly as before. Nothing to migrate, nothing to lose.</p>
<p>Pro unlocks the features businesses ask for most:</p>
<ul>
<li><strong>Live human takeover</strong> — jump into any conversation from the <strong>iOS & Android app</strong> and reply as a real person, with push notifications the moment a visitor needs you.</li>
<li><strong>One app for all your sites</strong> — the mobile app manages <strong>multiple WordPress sites from a single login</strong>, so agencies and multi-brand teams handle every conversation in one place.</li>
<li><strong>Voice calls</strong> — let a visitor start a <strong>voice call</strong> with your team straight from the chat, answered live in the app.</li>
<li><strong>Unlimited agents</strong> — run separate assistants for sales, support, FAQ and more, each with its own prompt, look and knowledge.</li>
<li><strong>No OpenAI key needed</strong> — switch to managed AI billed by simple token packs, with access to top models — perfect if you’d rather not manage an OpenAI account.</li>
<li><strong>Auto-sync your whole site</strong> — pages, posts and WooCommerce products are indexed automatically so the assistant always answers with up-to-date info.</li>
<li><strong>AI Prompt Generator</strong> — a guided wizard writes a high-quality agent prompt for you in a couple of minutes.</li>
<li><strong>Booking built in</strong> — connect Google Calendar and let the assistant schedule meetings.</li>
<li><strong>Send leads anywhere</strong> — outbound webhooks push every captured lead to your CRM or automation tool.</li>
<li><strong>Never miss a lead</strong> — instant email + mobile push the moment someone becomes a lead.</li>
<li><strong>White-label</strong> — remove the “Powered by” badge and make the widget fully your own.</li>
<li><strong>One-click auto-updates</strong> and <strong>conversation analytics</strong>.</li>
</ul>
<p>See the screenshots below for a look at both the free widget and the Pro features.</p>
<h3>External services</h3>
<p>This plugin relies on <strong>one</strong> third-party service: the OpenAI API. No other external endpoint is contacted by the free plugin.</p>
<h4>OpenAI API (required)</h4>
<ul>
<li><strong>What it is:</strong> OpenAI provides the language model that generates chat replies and, when you upload knowledge-base documents, runs the file search against them.</li>
<li><strong>What is sent:</strong> Every chat message the visitor submits, plus the system prompt your agent is configured with, is sent to <code>https://api.openai.com/v1/responses</code> using your own API key. When you upload training documents, the file bytes are sent to <code>https://api.openai.com/v1/files</code> and registered with <code>https://api.openai.com/v1/vector_stores</code> so the agent can search them.</li>
<li><strong>When:</strong> On every user message (chat completion) and only when an admin manually uploads/deletes a knowledge-base document (vector store).</li>
<li><strong>Terms of service:</strong> https://openai.com/policies/terms-of-use</li>
<li><strong>Privacy policy:</strong> https://openai.com/policies/privacy-policy</li>
</ul>
<h4>Not contacted by this free plugin</h4>
<p>The companion Pro addon (separate download, not on wp.org) introduces additional endpoints under <code>https://saas.globalai.software/</code> for license verification, managed token billing, mobile-app push notifications, plugin auto-updates, Google Calendar OAuth, outbound webhooks, page/post auto-sync, and the AI prompt generator. None of those endpoints are reached from this free plugin’s code — they are documented here only so admins know what changes if they later install the Pro addon.</p>
<h3>Security</h3>
<h4>Visitor session token (`session_id`)</h4>
<p>Every chat conversation is bound to a <code>session_id</code> token generated <strong>client-side, in the visitor’s browser</strong>, using <code>window.crypto.getRandomValues</code> (a 128-bit cryptographically random value rendered as 32 hex characters with the prefix <code>gai_</code>). The token is stored in <code>localStorage</code> after the visitor accepts the cookie consent banner; without consent, an in-memory ephemeral token is used and discarded when the tab closes.</p>
<p>The <code>session_id</code> is the access key for the chat REST endpoints (<code>/wp-json/growthai/v1/chat</code>, <code>/wp-json/growthai/v1/live-chat/poll</code>). These endpoints are intentionally public (<code>permission_callback => __return_true</code>) so that anonymous site visitors can chat without needing a WordPress account — knowing the token is what authorises the request, the same security model used by mainstream chat / support widgets (Crisp, Tawk, Intercom).</p>
<p>Implications:</p>
<ul>
<li>The token is <strong>not</strong> derived from the IP, User-Agent, cookies the server sets, or any sequential / predictable scheme. A third party cannot guess another visitor’s token.</li>
<li>The plugin never logs full <code>session_id</code> values in plaintext outside the database row that owns the conversation.</li>
<li>If the visitor clears their browser storage, the next page load gets a fresh token and a fresh conversation.</li>
<li>Old browsers without the Web Crypto API fall back to <code>Math.random()</code> — a worse entropy source. We surface this in the JS for transparency; if your audience relies on legacy browsers, factor that into your threat model.</li>
</ul>


Global AI Chat

Add a friendly AI chat assistant to WordPress. It greets visitors, answers questions and captures leads — free, using your own OpenAI key.

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.4</h4>
<ul>
<li>Added the shared model-call layer used by Theme Kit features in both Proxy and BYO modes.</li>
<li>Added configurable task prompts for summaries, reading paths, author voice, contact polishing, service briefs, and team voice.</li>
<li>Added REST endpoints for post summaries, semantic search, curated reading paths, and author voice.</li>
<li>Added editor-only tools for article outlines, rephrasing, attachment alt text, SEO metadata, and schema suggestions.</li>
<li>Added Iris block-theme endpoints for helpful feedback, saved chats, smart subscribe, quizzes, fact checks, comparisons, translation, explanations, related posts, personalized picks, and smart 404 suggestions.</li>
<li>Added database setup for saved chats, helpful feedback, and smart-subscribe leads.</li>
<li>Preserved the stable 3.0.3 settings experience without adding experimental admin tabs or changing the existing chat workflow.</li>
</ul>
<h4>3.0.3</h4>
<p>*Companion support for the upcoming Iris Theme Kit — auto-detects the theme and exposes shared hooks so the full-page chat and floating widget integrate cleanly with its Elementor widgets and hero blocks.</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.

Global AI Chat vs Iris AI – AI Homepage, Chatbot & Site Assistant