OZY AI Agent puts a real AI agent on your WordPress site — not just a chatbot. A chatbot answers from text; an agent uses tools to fetch live data from your site and perform actions for the visitor. Every action that changes something (cart, coupon, order, enquiry) only happens after the visitor taps Confirm — the model can never act on its own.

It adapts to your site automatically:

Online stores (WooCommerce) — a shop assistant that searches your catalogue with real prices and stock, compares products, says which colours and sizes are in stock, explains shipping, adds items to the cart, applies coupons, sends shoppers to checkout (or, opt-in, takes the whole order inside the chat), and tracks orders after verifying the customer.
Service businesses — explains your services from your own pages, answers FAQs, and turns interest into an enquiry emailed to you or a booked call.
Blogs and information sites — finds the right page or article and summarises what your site says.

It only helps with your website. Requests for unrelated work — writing code, homework, essays, general knowledge — are politely declined and steered back to your business.

Agent tools

search_site, read_page — search and read your public pages and posts
handoff — WhatsApp, email and booking buttons with a conversation summary
send_enquiry (Confirm) — emails the visitor’s enquiry to you
report_gap — logs questions your site could not answer to the Content Gaps screen
WooCommerce: search_products, get_product, compare_products, list_attribute_values, get_shipping_info, get_cart, add_to_cart (Confirm), update_cart_item (Confirm), apply_coupon (Confirm), checkout, track_order

Products appear as cards with image, price, stock and a link. Suggested replies appear as tappable chips.

Built for trust

Confirm-before-act — state-changing tools return a Confirm button instead of running.
Cart and checkout run through WooCommerce’s own Store API in the visitor’s browser, so your stock, coupon, shipping, tax and payment rules always apply. The plugin never writes carts or orders itself.
Price guard — if a reply mentions a price no tool returned, the agent must rewrite it; if it still does, that sentence is removed.
Order tracking is verified — order number plus billing email or phone; five failed tries per hour lock the visitor out; addresses and payment details are never shown.
Honest — if asked, the agent says it is an AI assistant for your business.
Page-cache safe — no nonce is printed into your HTML; the widget fetches a fresh session when it opens.

Everything else

Five AI providers with fallback order and free-text model IDs: OpenAI, Claude, Groq, Gemini, Mistral (Groq, Gemini and Mistral have free tiers)
Exact provider errors for the admin (on the dashboard and plugin screens) while visitors see a friendly message
Floating launcher, popup and inline chat; Gutenberg, Elementor, Divi, Avada and WPBakery elements; [oozzy_ai_agent] and [ozy_agent_ask] shortcodes
“Ask AI about this product” button on WooCommerce product pages (optional)
Replies in the visitor’s language, including Urdu, Roman Urdu, Hindi and Arabic; RTL aware
Voice input (Groq Whisper) and spoken replies
Analytics: conversations, replies using live data, add-to-carts and orders via chat, handoffs, unanswered questions, tokens per provider
Optional Google Analytics / Tag Manager events: oozzy_open, oozzy_message, view_item, add_to_cart, begin_checkout, purchase, oozzy_handoff
HPOS and Cart/Checkout blocks compatible
Streaming replies — text appears as it is written, and visitors see what the agent is doing (“Searching products…”, “Checking delivery options…”)
WordPress 7 AI connectors — if a connector is set up under Settings Connectors, the agent uses it first and your own keys become the fallback
Optional conversation storage with a retention period, full transcripts in Analytics, and WordPress personal-data export and erase

Setup in 5 minutes

Install and activate — the Setup Wizard opens
Pick your site type (store, service business or blog); the agent gets matching defaults
Add a line about your business and contact details
Paste one API key (Groq is free) — the wizard scans your site and tests the connection

Everything can be changed later under AI Provider, AI Agent and Tools & Store.

Developers

add_action( 'oozzy_register_tools', function () {
    OOZZY_Tools::register( [
        'name'        => 'calculate_fabric',
        'description' => 'Metres of fabric needed for a garment.',
        'parameters'  => [ 'type' => 'object', 'properties' => [ 'height_cm' => [ 'type' => 'integer' ] ], 'required' => [ 'height_cm' ] ],
        'callback'    => function ( $args, $ctx ) { return [ 'metres' => 4.5 ]; },
        'confirm'     => false,
    ] );
} );

Filters: oozzy_tools, oozzy_system_prompt, oozzy_messages, oozzy_tool_result, oozzy_response, oozzy_client_ip, oozzy_product_fields, oozzy_product_card, oozzy_product_search_handler, oozzy_order_lookup_allowed, oozzy_find_order, oozzy_order_view, oozzy_phone_normalize, oozzy_inchat_gateways, oozzy_currency_markers, oozzy_page_content, oozzy_context_chars, oozzy_time_budget, oozzy_front_config.

Actions: oozzy_register_tools, oozzy_tool_called, oozzy_action_confirmed, oozzy_conversation_ended, oozzy_gap_logged, oozzy_lead_captured, oozzy_handoff.

JavaScript: window.OzyAgent.open( { prompt, context: { productId } } ), OzyAgent.send( text ), OzyAgent.close(). Window events: oozzy:open, oozzy:message, oozzy:card_click, oozzy:action_confirmed, oozzy:handoff.

API keys can be set in wp-config.php instead of the database: OOZZY_GROQ_KEY, OOZZY_GEMINI_KEY, OOZZY_MISTRAL_KEY, OOZZY_OPENAI_KEY, OOZZY_CLAUDE_KEY.

POST /wp-json/oozzy/v1/chat with `"stream": true` answers as `text/event-stream`: `status` events while tools run, `delta` text as the model writes, `reset` when a fallback provider takes over, then one `done` event carrying the full response.

Tests: composer install, bin/install-wp-tests.sh <db> <user> <pass>, then vendor/bin/phpunit.

If OZY Smart Search is active, product search uses its ozy_smart_search_query() engine automatically.

Shortcodes

[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
[ozy_agent_ask product="current" label="Ask AI about this product"] — opens the chat about a product

External Services

This plugin connects to third-party AI services to generate replies. It only contacts a provider you have entered an API key for in OZY AI Agent AI Provider (or in wp-config.php). No data is sent to any provider whose key is empty.

What is sent: the visitor’s messages and the prior conversation (up to the last 20 messages), the page the visitor is on, a system prompt with your business information and a snapshot of your public content, the list of available tools, and the results of tools the agent ran during that reply (for example product names, prices and stock, your shipping zones, or — only after the customer verified the order — the status and items of their order). The visitor’s cart summary is included on WooCommerce sites so the agent can answer cart questions. Billing addresses and payment details are never sent.

When is it sent: every time a visitor sends a message in the chat.

Providers (only those with 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/commercial-terms — privacy: https://www.anthropic.com/legal/privacy

WordPress AI connectors (WordPress 7.0+): if Use WordPress AI connectors first is on and a connector under Settings Connectors has credentials, the same data is sent through WordPress’s built-in AI Client to the provider of that connector, under that provider’s terms.

Voice transcription (only when the visitor uses the microphone and a Groq key is configured): the recording is sent to the Groq Whisper API (https://api.groq.com/openai/v1/audio/transcriptions). It is not stored on your server.

WooCommerce Store API: cart, coupon and in-chat checkout actions call your own site’s WooCommerce Store API (/wp-json/wc/store/v1/) from the visitor’s browser after they tap Confirm. This stays on your site; no third party is involved beyond the payment method your store already uses.

Google Analytics / Tag Manager: if Send events to Google Analytics / Tag Manager is on and your site already loads dataLayer or gtag, chat events are passed to them. The plugin does not load any tracking script itself.

Chat history is kept in the visitor’s browser (localStorage). Nothing is sent to the plugin author.

Conversation storage (optional, off by default): when turned on under Tools & Store, each conversation’s messages are saved in your own database, linked to the logged-in user or to the email a visitor gives in an enquiry, and deleted automatically after the retention period (30 days by default). They are included in Tools Export Personal Data and Erase Personal Data, and suggested privacy-policy text is added to Settings Privacy.

Local analytics (optional, on by default): one row per reply in your own database — time, provider and model, response time, success, the visitor’s last message (300 characters), tools used, token counts and a random conversation ID — plus events such as unanswered questions, add-to-carts and handoffs. Capped at the latest 1,000 replies, deletable from Analytics, can be switched off under URL Index, and dropped on uninstall.

Site owners are responsible for disclosing this processing in their privacy policy.