ZenQori Assistant – AI Chatbot for WooCommerce, OpenAI & Claude

By ZenQori

0+ active installationsVersion 3.18.0

AI chatbot for WooCommerce and blogs: answers from your own products, articles and pages with OpenAI GPT or Claude. Runs inside WordPress.

Description

ZenQori Assistant adds a chat widget that answers visitors’ questions strictly from your own content: WooCommerce products (including variations and reviews), pages, posts and your own Q&A entries. Everything runs inside WordPress – no external automation server and no separate account except your own AI provider key (OpenAI, and optionally Anthropic for Claude).

Two site types in one plugin: an online shop (WooCommerce) or a blog / website / knowledge base. Automatic mode picks the shop type when WooCommerce is active.

Features:

  • Chat widget with streaming answers, quick-question buttons, custom title, welcome message, colour, position and icon.
  • Built-in RAG pipeline: conversation memory, query rewriting and intent detection, exact SKU lookup, similarity threshold, LLM reranking, product comparison and recommendation handling.
  • The knowledge base lives in your WordPress database – nothing else to set up.
  • Automatic indexing of WooCommerce products, variations, reviews, pages, posts and custom Q&A entries (add your own answers, for example your terms and conditions, as “Knowledge base” entries). Instant background updates, an hourly reconciliation, a full re-index from the admin or WP-CLI (wp zqpro reindex).
  • Blog mode: articles are split at headings, answers point to the right articles, and article cards (title, excerpt, thumbnail) are shown under answers. Unpublished and password-protected posts are never used.
  • Contact with a person on WhatsApp: set your working hours (days, periods, days off) and the chat offers a WhatsApp button while somebody is available; the AI answers the rest of the time. The visitor continues in his own WhatsApp – nothing is sent by the plugin.
  • Product cards (WooCommerce): photo, price, rating and a link under answers that recommend products – in a horizontal, swipeable gallery or a list.
  • Lead capture: a contact form in the chat (name, e-mail or phone, message) stored in your WordPress database, optionally e-mailed to you and/or sent to a webhook (n8n, Make, Zapier or your own endpoint).
  • Order status (WooCommerce): customers check an order in the chat with the order number and e-mail. The AI never sees order data.
  • Basic analytics: conversations, messages, conversations per day and the most frequent questions.
  • Abuse and cost protection: per-visitor limit, per-IP safety net, daily message cap, daily AI token budget, message length limit.
  • Choose OpenAI GPT or Anthropic Claude to write the answers. Search embeddings always use OpenAI.
  • The OpenAI key can live in wp-config.php (ZQPRO_OPENAI_KEY), the Anthropic key in ZQPRO_ANTHROPIC_KEY.

ZenQori Assistant Pro

Pro adds other AI providers (Gemini, Mistral, DeepSeek, Groq, OpenRouter, Ollama), the Pinecone vector index, knowledge from PDF/DOCX/TXT files, “Add to cart” buttons in the product cards (WooCommerce), answer ratings, full analytics (unanswered questions, most used sources), multilingual (Polylang, WPML) and noindex support. Voice conversation with natural OpenAI voices (female or male, with a choice of tone and a daily voice limit), and more. Your settings and data carry over when you switch editions.

Requirements

  • An OpenAI API key (search embeddings are always created with OpenAI; answers too unless you choose Claude).
  • Optional: an Anthropic API key, if you want Claude to write the answers.
  • PHP 7.4 or newer. WooCommerce is optional.

External services

This plugin sends data to third-party services:

  • OpenAI (https://openai.com) – the visitor’s message, recent conversation turns and relevant excerpts of your knowledge base are sent to generate answers; your product, page and post text is sent to create embeddings. Privacy policy: https://openai.com/policies/privacy-policy/ Terms: https://openai.com/policies/terms-of-use/
  • Freemius (https://freemius.com) – licensing and update service. Nothing is sent until you opt in on the activation screen; if you do, your site address, WordPress, PHP and plugin versions and your admin e-mail and name are sent so the plugin can be updated and supported. You can skip the opt-in and the plugin works the same. Privacy policy: https://freemius.com/privacy/ Terms: https://freemius.com/terms/
  • Anthropic (https://www.anthropic.com) – only if you choose Claude in the settings: the visitor’s message, recent conversation turns and relevant excerpts of your knowledge base are sent to api.anthropic.com to generate answers. Embeddings stay with OpenAI. Privacy policy: https://www.anthropic.com/legal/privacy Terms: https://www.anthropic.com/legal/consumer-terms
  • Your lead webhook – only if you enable lead capture and enter a webhook URL: the details a visitor typed into the contact form (name, e-mail, phone, message, page address and the last chat messages) are sent to that URL, which you choose. Nothing is sent anywhere else.
  • Optional address change – by default every request goes to https://api.openai.com/v1. A developer can point it elsewhere (for example to a proxy) with the zqpro_openai_base_url filter; the data listed above is then sent to that address instead, chosen by the site owner. The Pro edition, which is a separate package, can also connect to other AI providers and Pinecone; the connection code for those services is not part of this Free plugin, which never contacts them.

Conversations are stored in your WordPress database for the retention period set in the plugin settings (default 30 days). A random session identifier is stored in the visitor’s browser local storage.

ZenQori does not receive any chat messages or store content. The site owner is responsible for informing visitors (privacy policy) and for choosing a lawful basis.

This plugin is an independent integration and is not affiliated with OpenAI.

Bundled libraries

  • Freemius SDK (https://github.com/Freemius/wordpress-sdk), GPLv3, in vendor/freemius/ – licensing and updates.

Installation

  1. Upload the plugin folder to /wp-content/plugins/ or install the ZIP via Plugins > Add New > Upload.
  2. Activate “ZenQori Assistant”.
  3. Open ZenQori Assistant > Settings, enter your OpenAI key (and the Anthropic key if you use Claude) and save.
  4. Open ZenQori Assistant > Indexing and run “Start full re-index” (or wp zqpro reindex).
  5. Back on Settings enable the chatbot.

Changelog

3.18.0

  • Added: lead collection in the free edition – a short contact form in the chat (name, e-mail, message), a Leads list in the admin and optional e-mail / webhook notification.
  • Added: “Talk to a person” block with a WhatsApp link that pre-fills the visitor’s last question and page; shown by your opening hours, as a text button or an icon only.
  • Added: product cards under answers in the free edition (picture, price, “View product”); card layout (carousel or list) and when to show them are configurable. The “Add to cart” button stays a Pro feature.
  • Added: voice conversation choice screen and microphone input where the browser supports speech recognition (not shown in Firefox).
  • Improved: several variations of one product become a single card; “show more” follow-ups and typos no longer lose the topic; questions about buying or ordering a product are no longer treated as order status questions.
  • Improved: the conversation id is kept only for the current browser session; invalid JSON from a provider gives a clear error; AI requests have an overall time budget instead of unbounded retries.
  • Improved: links to your own site open in the same tab and the chat keeps the conversation and scrolls to the latest message; outdated pictures in answers no longer show as broken images.
  • Fixed: activation error caused by a moved class file; settings that did not stay saved; the indexing status after “delete all indexed content”.

3.17.0

  • Added: Anthropic Claude as an answer provider in the free edition (answers, query rewriting, reranking). Choose it in Settings and enter your Anthropic key. Embeddings still use OpenAI.
  • Changed: plugin name is now ZenQori Assistant – AI Chatbot for WooCommerce, OpenAI & Claude.
  • Changed: the Pro edition list now names the other providers (Gemini, Mistral, DeepSeek, Groq, OpenRouter, Ollama).

3.16.4

  • Added: 30-day free trial of the Pro edition (no payment method required), offered from the Upgrade page.
  • Changed: Pro is a one-time purchase with lifetime updates.

3.16.3

  • Fixed: the chat input row could be cut off at the bottom of the widget on themes that restyle textareas and buttons globally.

3.16.2

  • Changed: plugin name no longer contains the word “Free”.
  • Fixed: admin styles are loaded with wp_enqueue_style instead of inline style tags; launcher icon markup is sanitised with wp_kses; the extra attributes of settings fields are escaped.
  • Changed: the readme documents every external service, including the optional address filter.

3.16.1

  • Changed: no language files are bundled any more; translations are delivered by translate.wordpress.org. The interface is fully translatable (text domain zenqori-assistant).

3.15.3

  • Added (Pro package): the Pro features need a valid licence. Without one the plugin works like the free edition and keeps your Pro settings; they come back as soon as a licence is activated. An expired licence keeps the features working (only updates and support stop).

3.15.2

  • Changed: the Pro package header name is “ZenQori Assistant – AI Chatbot for Support & Sales” and Freemius adds the “(Pro)” suffix (no double “Pro” in the plugin list).

3.15.1

  • Changed: data cleanup on uninstall now runs through the Freemius after_uninstall hook (no uninstall.php file). Same data is removed as before.

3.15.0

  • Added: Freemius licensing and updates (Pro: licence activation and automatic updates for one year; Free: optional opt-in and upgrade page). The plugin works the same without opt-in.
  • Changed: Pro features keep working after the licence expires; only updates and support stop.

3.14.3

  • Fixed: Plugin Check warnings about WooCommerce core hook names in the add-to-cart quantity code (Pro).

3.14.2

  • Fixed: Plugin Check warning about load_plugin_textdomain() in the WordPress.org (Free) package – WordPress loads translations itself there.

3.14.1

  • Changed: final product names – “ZenQori Assistant – AI Chatbot for Support and Sales” and “ZenQori Assistant Pro – AI Chatbot for Support & Sales”; folder/slug zenqori-assistant. Settings and data are unchanged.

3.14.0

  • Changed: editions are now called Free and Pro (previously PRO and PRO Plus). Settings and data are unchanged.
  • Fixed: readable (unminified) widget stylesheet, translators comment.

3.13.5

  • Reply language: a Polish question is always answered in Polish, even when it contains English product names or codes.

3.13.4

  • Settings: the test button is now simply “Test connections” with a note that it only checks saved settings.

3.13.3

  • Settings: numeric fields (limits, budgets) are plain text boxes you can type into; no more tiny spinner boxes.

3.13.2

  • Settings: tick “Remove the saved key” next to an API key to delete it (e.g. after switching provider).

3.13.1

  • Connection test explains provider problems in plain language (model not available, key rejected, no credit, rate limit) as a warning instead of a raw error.
  • Google Gemini preset: fast model is now gemini-3.5-flash-lite (2.5 lite is closed to new accounts).

3.13.0

  • When the assistant cannot answer (provider error, exhausted quota or budget, network), the chat now shows a short apology and the contact form instead of a dead-end error (only when lead collection is on; works without any API key).

3.12.3

  • Product cards: sale products show only the current price (no hidden “original price was” text).
  • The chat shows the server’s message when the message limit is reached instead of a generic error.
  • Numbered lists keep their numbers; availability words are translated into the customer’s language; the question language is detected from the current question only; generic “what do you recommend” stays generic.

3.12.2

  • The assistant now always replies in the language of the customer’s question (the question language is detected and stated explicitly to the model), even when the product data is in another language.

3.12.1

  • Product cards with “Add to cart” now appear only when the customer wants to buy (setting: Show cards – only when buying / always).
  • Fixed the chat window being cut off at the bottom (input hidden) when the Contact / Order status toolbar is shown.

3.12.0

  • Contact us / Order status buttons now sit in their own toolbar row under the header.
  • The conversation is kept when the visitor moves to another page (per browser tab).
  • Products on backorder are indexed and shown as “on backorder”, not as in stock. Re-index products after updating.
  • Better answers to generic requests such as “recommend a product”; the assistant no longer mentions its “knowledge base”.
  • Added Polish (pl_PL) translation of the chat interface.

3.11.1

  • Fixed: opening one form in the chat closes the other one.

3.11.0

  • Renamed to “ZenQori AI Chatbot PRO” (the extended edition is “PRO Plus”).

3.10.0

  • First release (shares its code base and settings with the PRO Plus edition).