Title: OZY Chat Assistant
Author: idanishrangaiz
Published: <strong>June 29, 2026</strong>
Last modified: June 29, 2026

---

Search plugins

![](https://ps.w.org/ozy-chat-assistant/assets/banner-772x250.png?rev=3590650)

![](https://ps.w.org/ozy-chat-assistant/assets/icon-256x256.png?rev=3590650)

# OZY Chat Assistant

 By [idanishrangaiz](https://profiles.wordpress.org/idanishrangaiz/)

[Download](https://downloads.wordpress.org/plugin/ozy-chat-assistant.2.0.8.zip)

 * [Details](https://mfe.wordpress.org/plugins/ozy-chat-assistant/#description)
 * [Reviews](https://mfe.wordpress.org/plugins/ozy-chat-assistant/#reviews)
 *  [Installation](https://mfe.wordpress.org/plugins/ozy-chat-assistant/#installation)
 * [Development](https://mfe.wordpress.org/plugins/ozy-chat-assistant/#developers)

 [Support](https://wordpress.org/support/plugin/ozy-chat-assistant/)

## Description

**OZY Chat Assistant** puts a smart AI assistant on your WordPress site. It automatically
reads your pages, posts, products, and menus — then behaves as the dedicated AI 
agent for your business. Visitors get accurate, context-aware answers about your
services without you lifting a finger.

#### Why OZY Chat Assistant is different

Most AI chat plugins require expensive SaaS subscriptions or are locked to one AI
provider. OZY Chat Assistant:

 * **Learns your website automatically** — scans your WordPress content and uses
   it to answer visitor questions accurately
 * **Supports 5 AI providers** — OpenAI, Claude, Groq, Gemini, Mistral — with configurable
   priority and automatic fallback
 * **Free tiers available** — Groq, Gemini, and Mistral all offer free API keys
 * **Fully configurable dashboard** — no code required, everything done from Settings
 * **Dual widget modes** — floating button (side panel) + popup modal, each independently
   togglable

#### Core Features

 * **Multi-provider AI** — OpenAI (GPT-4o), Claude (Haiku/Sonnet), Groq (Llama 3.3
   70B), Gemini 2.0 Flash, Mistral Small
 * **Configurable priority** — choose which provider is tried first and in what 
   fallback order
 * **Website content reader** — automatically reads your WordPress pages, posts,
   products, and menus
 * **Business knowledge base** — add custom descriptions, services, FAQs, and policies
 * **Streaming responses** — tokens appear in real time (like ChatGPT)
 * **Voice input** — Groq Whisper STT transcribes voice messages
 * **Text-to-speech** — AI reads responses aloud after voice input
 * **Floating button + panel** — fixed corner chat button with slide-up panel
 * **Popup modal** — centered overlay on first visit (independently togglable)
 * **Shortcode** — `[oozzy_ai_agent]` to embed on specific pages
 * **IP/timezone-aware greeting** — greets visitors based on their local time
 * **Re-engagement** — prompts idle visitors after 50 seconds
 * **Chat history** — persists last 30 messages across page loads
 * **Lightweight** — no jQuery dependency, vanilla JS, minimal CSS

#### Setup in 5 Minutes

 1. Install and activate the plugin
 2. Go to **Settings  OZY Chat Assistant**
 3. Add at least one API key in the **AI Providers** tab (Groq is free and recommended)
 4. Describe your business in the **My Business** tab and click “Scan My Website”
 5. Add contact details in the **Agent** tab
 6. Adjust appearance in the **Appearance** tab

#### Free API Keys

 * **Groq** — https://console.groq.com (free, fast, recommended)
 * **Gemini** — https://aistudio.google.com (free tier)
 * **Mistral** — https://console.mistral.ai (free tier)
 * **OpenAI** — https://platform.openai.com/api-keys (paid)
 * **Claude** — https://console.anthropic.com (paid)

#### Shortcode

    ```
    [oozzy_ai_agent]
    ```

Add to any page or post. Or enable “Load Site-Wide” in Appearance to load on every
page without a shortcode.

### External Services

This plugin connects to third-party AI services to generate chat responses. The 
plugin only contacts a provider if you have entered an API key for that provider
in **Settings  OZY Chat Assistant  AI Providers**. No data is sent to any provider
whose key is empty.

**What is sent**: the visitor’s chat message text, the prior conversation (up to
the last 20 messages from the same browser session), and a system prompt containing
your configured business info and a snapshot of public WordPress content (page/post
titles and excerpts) you have configured the plugin to read.

**When is it sent**: every time a visitor submits a message in the chat widget on
your site.

**Providers used** (only the ones with configured API keys are called):

 * **Groq** — https://groq.com/ — terms: https://groq.com/terms-of-use/ — privacy:
   https://groq.com/privacy-policy/
 * **Google Gemini** — https://ai.google.dev/ — terms: https://ai.google.dev/gemini-
   api/terms — privacy: https://policies.google.com/privacy
 * **Mistral AI** — https://mistral.ai/ — terms: https://legal.mistral.ai/terms —
   privacy: https://legal.mistral.ai/terms/privacy-policy
 * **OpenAI** — https://openai.com/ — terms: https://openai.com/policies/terms-of-
   use/ — privacy: https://openai.com/policies/privacy-policy/
 * **Anthropic (Claude)** — https://www.anthropic.com/ — terms: https://www.anthropic.
   com/legal/consumer-terms — privacy: https://www.anthropic.com/legal/privacy

**Voice transcription** (only if the visitor uses the microphone button and a Groq
API key is configured): the audio recording is sent directly to the Groq Whisper
API endpoint (https://api.groq.com/openai/v1/audio/transcriptions) over an HTTP 
request. The audio is not stored on your WordPress server.

The plugin does not store visitor messages on your WordPress server. Chat history
is kept only in the visitor’s own browser via `localStorage` and is cleared when
the visitor clears their browser data.

**Site owners are responsible** for disclosing this third-party data processing 
to their visitors in their site’s privacy policy.

## Screenshots

[⌊Admin dashboard — AI Providers tab with API key configuration and provider priority.⌉⌊
Admin dashboard — AI Providers tab with API key configuration and provider priority
.⌉[

Admin dashboard — AI Providers tab with API key configuration and provider priority.

[⌊Admin dashboard — Appearance tab showing widget mode toggles and color picker.⌉⌊
Admin dashboard — Appearance tab showing widget mode toggles and color picker.⌉[

Admin dashboard — Appearance tab showing widget mode toggles and color picker.

[⌊Floating chat button and slide-up panel on a live website.⌉⌊Floating chat button
and slide-up panel on a live website.⌉[

Floating chat button and slide-up panel on a live website.

[⌊Popup modal widget shown on first page visit.⌉⌊Popup modal widget shown on first
page visit.⌉[

Popup modal widget shown on first page visit.

## Installation

 1. Upload the `ozy-chat-assistant` folder to `/wp-content/plugins/`
 2. Activate the plugin through **Plugins  Installed Plugins**
 3. Configure at **Settings  OZY Chat Assistant**

## FAQ

### Do I need all five API keys?

No. You only need one working API key. The agent tries them in your configured priority
order and falls back automatically if one fails. Groq is the recommended starting
point — it’s free and fast.

### Will it conflict with my theme or other plugins?

The widget uses fixed positioning and scoped CSS custom properties. It does not 
inject styles into the page flow. Conflicts are very rare.

### Can I use it on a client’s website?

Yes. Each installation is independent. Configure the business info, agent name, 
and contact details for each site separately.

### Does streaming work on shared hosting?

Streaming requires `ob_flush()` / `flush()` support. This works on most hosts. If
streaming fails, the widget automatically falls back to non-streaming mode.

### How does the website reader work?

The plugin reads your WordPress pages, posts, WooCommerce products, custom post 
types, and navigation menus using built-in WordPress functions — no external HTTP
requests. The content is cached (default: 6 hours) and injected into the AI’s system
prompt.

### Who built this plugin?

Built and maintained by idanishrangaiz. See the plugin author link in your WordPress
plugins page for support and contact details.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“OZY Chat Assistant” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ idanishrangaiz ](https://profiles.wordpress.org/idanishrangaiz/)

[Translate “OZY Chat Assistant” into your language.](https://translate.wordpress.org/projects/wp-plugins/ozy-chat-assistant)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/ozy-chat-assistant/),
check out the [SVN repository](https://plugins.svn.wordpress.org/ozy-chat-assistant/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/ozy-chat-assistant/)
by [RSS](https://plugins.trac.wordpress.org/log/ozy-chat-assistant/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 2.0.8

 * Fixed: the “Powered by OZY” credit no longer appears on the front-end chat widget
   by default. As required by the WordPress.org plugin guidelines, attribution on
   user-facing interfaces is now strictly opt-in.
 * Added: a “Show ‘Powered by OZY’ Credit” toggle (off by default) in the Appearance
   tab. Site administrators must intentionally enable it for the credit to display.

#### 2.0.7

 * Changed: renamed the plugin to “OZY Chat Assistant” with the slug `ozy-chat-assistant`;
   the text domain now matches the slug.
 * Changed: replaced all short `ozy`/`OZY_` code prefixes with the unique `oozzy`/`
   OOZZY_` prefix on functions, classes, options, transients, nonces, AJAX actions,
   and the shortcode (now `[oozzy_ai_agent]`).
 * Changed: all upstream AI and voice requests now use the WordPress HTTP API (`
   wp_remote_post()`) exclusively; removed all direct cURL calls.
 * Changed: voice transcription now uploads audio via a multipart HTTP request instead
   of writing a temporary file to disk.
 * Removed: `load_plugin_textdomain()` call — WordPress.org loads translations automatically
   since WP 4.6.
 * Fixed: corrected the Mistral terms/privacy URLs to the working Legal Center links.

#### 2.0.5

 * Fixed: replaced direct `<style>` tag output with `wp_add_inline_style()` for 
   the accent color CSS variables, as required by WordPress.org guidelines.
 * Fixed: updated Contributors field to correct WordPress.org username `idanishrangaiz`.
 * Fixed: updated broken Mistral terms/privacy URLs in readme.txt.

#### 2.0.4

 * Fixed: replaced heredoc (<<<EOT) string syntax in the system-prompt builder with
   standard string concatenation, to satisfy the WordPress.org Plugin Check (PluginCheck.
   CodeAnalysis.Heredoc.NotAllowed).
 * Fixed: bumped “Tested up to” header to 7.0 to match the current WordPress release(“
   Armstrong”).
 * Fixed: added the missing `languages/` directory (with a `ozy-chat-assistant.pot`
   translation template) so the `Domain Path: /languages` header in the plugin file
   now resolves to an existing folder.

#### 2.0.3

 * Removed: developer-promotion text that was injected into the AI system prompt.
   The AI no longer mentions the plugin author to your visitors.
 * Removed: “Allow External Suggestions” setting (no longer needed). Setting default
   changed to off for any existing installs.
 * Changed: chat widget footer simplified to “Powered by OZY” (brand only, no link,
   no full plugin name).
 * Removed: developer bio and “Contact” CTA button from the admin Guide tab. Author
   info is available via the plugin page on WordPress.org instead.
 * Removed: unused `standalone/` folder (Vercel/Node.js demo code unrelated to the
   WordPress plugin).
 * Improved: added an “External Services” section to readme that fully discloses
   every third-party endpoint contacted and exactly what data is transmitted.
 * Improved: added an inline reviewer-facing comment in `class-ozy-api.php` explaining
   why cURL is used in the SSE streaming path (WP HTTP API does not support response
   streaming).
 * Improved: reduced readme tags to 5 (WP.org limit) and bumped “Tested up to” to
   6.8.

#### 2.0.2

 * Fixed: popup modal background appeared transparent on some themes — CSS variables
   now resolve correctly for the modal.
 * Fixed: voice (mic) button no longer shows an oversized dark hover background;
   hover now only changes the icon color.
 * Improved: chat input field is taller and wider with better padding for easier
   typing on both desktop and mobile.
 * Improved: voice mic button is more compact (28px), giving the text input more
   room.
 * Improved: input row uses center alignment and tighter spacing for a more polished
   look.
 * Fixed: admin settings tab links now point to the correct top-level admin URL (
   admin.php instead of options-general.php).
 * Fixed: resolved leftover merge artifacts in CSS that were breaking widget styling
   in certain browsers.

#### 2.0.1

 * Fixed: saving settings on one tab (e.g. AI Providers) no longer resets toggles
   from other tabs (floating enable, popup enable, site-wide, auto-open).
 * Added: auto-repair that restores visibility settings if all three are found to
   be off simultaneously.
 * Improved: nonce verification now uses check_ajax_referer() for AJAX handlers.
 * Improved: basic per-IP rate limiting (30 req/min for chat, 10 req/min for voice).
 * Improved: MIME type validation and audio size check for voice transcription.
 * Improved: removed all error-suppressor (@) operators; output buffering checked
   before flushing.
 * Improved: user message bubble now renders in solid black bold text for better
   readability.
 * Security: escHtml() now escapes double and single quotes to prevent attribute
   injection.

#### 2.0.0

 * Added OpenAI (GPT-4o Mini, GPT-4o, GPT-3.5 Turbo) support
 * Added Claude (Haiku, Sonnet, Opus) support
 * Added configurable provider priority order
 * Added automatic website content reader (pages, posts, products, menus)
 * Redesigned dashboard with aesthetic card-based UI
 * Added dual widget modes: floating button and popup modal, each independently 
   togglable
 * Added business knowledge base field
 * Added external suggestions toggle
 * Added agent icon URL field
 * Removed contact form auto-fill (now pure AI conversation agent)
 * Streaming support for all providers
 * Improved system prompt with site context injection
 * Updated to GPL-2.0-or-later license

#### 1.0.0

 * Initial release

## Meta

 *  Version **2.0.8**
 *  Last updated **20 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.8 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/ozy-chat-assistant/)
 * Tags
 * [AI](https://mfe.wordpress.org/plugins/tags/ai/)[assistant](https://mfe.wordpress.org/plugins/tags/assistant/)
   [chat widget](https://mfe.wordpress.org/plugins/tags/chat-widget/)[chatbot](https://mfe.wordpress.org/plugins/tags/chatbot/)
   [openai](https://mfe.wordpress.org/plugins/tags/openai/)
 *  [Advanced View](https://mfe.wordpress.org/plugins/ozy-chat-assistant/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/ozy-chat-assistant/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/ozy-chat-assistant/reviews/)

## Contributors

 *   [ idanishrangaiz ](https://profiles.wordpress.org/idanishrangaiz/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/ozy-chat-assistant/)