Title: OZY AI Agent
Author: Danish Rangaiz
Published: <strong>ayidosun 29, 2026</strong>
Last modified: avuvɔsun 19, 2026

---

Search plugins

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

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

# OZY AI Agent

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

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

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

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

## Description

**OZY AI Agent** (formerly _OZY Chat Assistant_) puts a smart AI agent and chatbot
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.

Drop it anywhere with a drag-and-drop block for Gutenberg, Elementor, Divi, Avada
and WPBakery, keep the floating chat widget in the corner, or do both.

#### Why OZY AI Agent is different

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

 * **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
 * **Model IDs are free text** — when a provider ships a new model, type its ID 
   and use it the same day; no plugin update needed
 * **Free tiers available** — Groq, Gemini, and Mistral all offer free API keys
 * **Drag and drop anywhere** — a native element for Gutenberg, Elementor, Divi,
   Avada (Fusion), WPBakery, and classic widget areas
 * **Everything from the dashboard** — colours, agent identity, placement, limits
   and analytics, no code required

#### Core Features

 * **Multi-provider AI** — OpenAI, Claude, Groq, Gemini and Mistral, each with its
   own editable model ID
 * **Configurable priority** — choose which provider is tried first and in what 
   fallback order
 * **Connection tester** — verify any API key from the dashboard and see the provider’s
   own error message if it fails
 * **Website content reader** — indexes your WordPress pages, posts, products, and
   menus, and lists exactly what was indexed
 * **Business knowledge base** — add custom descriptions, services, FAQs, and policies
 * **Analytics dashboard** — conversation totals, daily and monthly counts, average
   response time, success rate, provider usage and most-asked questions
 * **Rate limiting** — per-visitor requests per minute plus optional daily and monthly
   caps for the whole site
 * **Three placement modes** — inline chat panel, a button that opens the popup,
   or a loader for the floating widget
 * **Page builder elements** — Gutenberg block, Elementor widget, Divi module, Fusion/
   Avada element, WPBakery element, classic sidebar widget
 * **Full colour control** — accent, panel background, text, visitor bubble and 
   launcher colours, plus corner radius and screen offsets, with a live preview
 * **Light and dark base themes**
 * **Agent icon uploader** — pick an image from the media library, or leave it blank
   for the animated OZY orbit icon
 * **Quick questions** — tappable suggestion chips shown before the first message
 * **Streaming responses** — words appear in real time
 * **Voice input** — Groq Whisper transcribes voice messages
 * **Text-to-speech** — the agent reads replies aloud after voice input
 * **Floating launcher + popup modal** — each independently togglable, with an optional
   launcher label
 * **Time-aware greeting** — greets visitors based on their local time
 * **Re-engagement** — prompts idle visitors after 50 seconds
 * **Chat history** — persists the last 30 messages across page loads
 * **Lightweight** — no jQuery dependency on the front end, vanilla JS, minimal 
   CSS

#### Setup in 5 Minutes

 1. Install and activate the plugin
 2. Go to **OZY AI Agent  AI Provider** and add at least one API key (Groq is free 
    and recommended), plus the model ID you want
 3. Describe your business in **AI Agent**
 4. Run the scan in **URL Index**
 5. Pick your colours and placement in **Widget Settings**

#### 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)

#### Placing the agent

Search for **OZY AI Agent** in Gutenberg, Elementor, Divi, Avada/Fusion, WPBakery,
or the Widgets screen. Every element offers the same three modes and renders identical
markup, so the design matches everywhere.

#### Shortcode

    ```
    [oozzy_ai_agent] — inline chat panel
    [oozzy_ai_agent mode="button" label="Chat with us"] — button that opens the popup
    [oozzy_ai_agent mode="loader"] — load the floating widget on this page only
    ```

Attributes: `mode`, `height`, `title`, `label`, `quick` (questions separated by `
|`).

Or enable **Load on every page** in Widget Settings to show the floating launcher
site-wide 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 **OZY AI Agent  AI Provider**. 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.

Full chat history is kept only in the visitor’s own browser via `localStorage` and
is cleared when the visitor clears their browser data. Nothing is sent to the plugin
author or to any OZY server.

**Local analytics** (optional, on by default): the plugin records one row per chat
request in a table in your own WordPress database — timestamp, the provider and 
model that answered, the response time, whether it succeeded, and the visitor’s 
last message truncated to 300 characters. This data never leaves your server, is
capped at the most recent 1,000 rows, can be deleted at any time from **Analytics
Delete all analytics data**, and can be switched off entirely under **URL Index  
Record conversation analytics**. Uninstalling the plugin drops the table.

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

## Screenshots

[⌊Dashboard — setup progress, live conversation stats and a preview of the widget.⌉⌊
Dashboard — setup progress, live conversation stats and a preview of the widget.⌉[

Dashboard — setup progress, live conversation stats and a preview of the widget.

[⌊AI Provider — API keys, editable model IDs, connection testing and fallback order.⌉⌊
AI Provider — API keys, editable model IDs, connection testing and fallback order
.⌉[

AI Provider — API keys, editable model IDs, connection testing and fallback order.

[⌊Widget Settings — colour presets, every colour editable, with a live preview.⌉⌊
Widget Settings — colour presets, every colour editable, with a live preview.⌉[

Widget Settings — colour presets, every colour editable, with a live preview.

[⌊Analytics — daily volume, provider usage, response times and most-asked questions.⌉⌊
Analytics — daily volume, provider usage, response times and most-asked questions
.⌉[

Analytics — daily volume, provider usage, response times and most-asked questions.

## Blocks

This plugin provides 1 block.

 *   OZY AI Agent

## Installation

 1. Upload the `ozy-chat-assistant` folder to `/wp-content/plugins/`
 2. Activate the plugin through **Plugins  Installed Plugins**
 3. Configure at **OZY AI Agent** in the admin sidebar

## FAQ

### The plugin used to be called OZY Chat Assistant — is this the same plugin?

Yes. Version 3.0.0 renamed it to **OZY AI Agent**. The directory URL and folder 
name stay `ozy-chat-assistant` because WordPress.org slugs are permanent, so updates
arrive normally and your settings carry over untouched.

### Which page builders are supported?

Gutenberg, Elementor, Divi, Avada (Fusion Builder), WPBakery, and classic widget
areas each get a native **OZY AI Agent** element. They all render the same markup,
so the design is identical no matter where you drop it. Any other builder can use
the shortcode.

### What is the difference between the inline chat and the popup?

The inline mode embeds a full chat panel directly in the page flow, so visitors 
talk to the agent right there without anything opening over the content. The popup
and floating launcher are separate and keep working as before.

### My provider released a new model. Do I have to wait for a plugin update?

No. Model IDs are plain text fields. Copy the new ID from your provider’s model 
list and paste it in — it works immediately.

### 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 AI Agent” is open source software. The following people have contributed to
this plugin.

Contributors

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

[Translate “OZY AI Agent” 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

#### 3.0.1

 * Fixed: the microphone and send buttons could pick up the active theme’s button
   hover colours (Elementor and similar). Their colours are now painted from the
   plugin’s own variables in every state.

#### 3.0.0

 * Renamed: the plugin is now **OZY AI Agent**. The directory slug, folder name 
   and text domain remain `ozy-chat-assistant`, so this is a normal update and all
   settings are preserved.
 * Added: drag-and-drop elements for Gutenberg, Elementor, Divi, Avada (Fusion Builder),
   WPBakery and classic widget areas — all rendering identical markup.
 * Added: inline chat mode. The agent can now be embedded directly in the page flow
   instead of only opening as a popup; the popup and floating launcher are unchanged
   and still independent.
 * Added: `mode`, `height`, `title`, `label` and `quick` attributes on the `[oozzy_ai_agent]`
   shortcode.
 * Changed: model selection is now a free-text field for every provider instead 
   of a fixed dropdown, so new model releases work without waiting for a plugin 
   update. Keys and model IDs sit together on one screen.
 * Added: multi-screen dashboard — Dashboard, AI Provider, AI Agent, Widget Settings,
   URL Index, Analytics and Help & Setup — with a redesigned interface and a new
   sidebar icon.
 * Added: Analytics screen with total, daily and monthly conversation counts, average
   response time, success rate, per-provider usage, a 14-day chart, most-asked questions
   and recent conversations. All data is stored locally and can be deleted or switched
   off.
 * Added: connection tester for each provider that surfaces the provider’s own error
   message.
 * Added: rate limiting controls — requests per minute per visitor, plus optional
   daily and monthly caps for the whole site.
 * Added: media-library uploader for the agent icon, replacing the URL-only field(
   pasting a URL still works).
 * Added: full colour control — accent, panel background, text, visitor bubble and
   launcher colours, corner radius, screen offsets, light/dark base theme and six
   presets, with a live preview that updates as you edit.
 * Added: URL Index screen listing exactly what was indexed, with per-entry source
   links and character counts.
 * Added: quick-question chips, a custom welcome message, an agent role subtitle,
   an optional launcher label, and a hide-on-mobile option.
 * Added: max reply length and creativity controls.
 * Improved: streaming now reports which provider answered, and failed requests 
   surface the provider’s HTTP error in the log.
 * Improved: the front-end widget markup and stylesheet were rebuilt so the panel,
   popup and inline embed share one design system.
 * Removed: the automatic visibility “repair” routine, which prevented administrators
   from turning every display mode off on purpose.

#### 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 **3.0.1**
 *  Last updated **1 month ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.8 or higher **
 *  Tested up to **7.1.2**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/ozy-chat-assistant/)
 * Tags
 * [AI](https://fon.wordpress.org/plugins/tags/ai/)[AI agent](https://fon.wordpress.org/plugins/tags/ai-agent/)
   [assistant](https://fon.wordpress.org/plugins/tags/assistant/)[chat widget](https://fon.wordpress.org/plugins/tags/chat-widget/)
   [chatbot](https://fon.wordpress.org/plugins/tags/chatbot/)
 *  [Advanced View](https://fon.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

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

## Support

Got something to say? Need help?

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