Ninhle AI Sales Assistant – AI Chatbot for WooCommerce

By Ninh Le

0+ active installationsVersion 2.7.0

Free AI chatbot for WooCommerce: answers from your catalog, adds to cart in chat and tracks orders. Use your own OpenAI, Claude or Gemini key.

Description

Ninhle AI Sales Assistant is a free AI chatbot and shopping assistant for WooCommerce. It answers shoppers from your real catalog, recommends products as cards with an Add to cart button, shows shipping and the order total before checkout, tracks orders, and passes the chat to a person when needed. It runs on your own OpenAI, Anthropic (Claude) or Google (Gemini) API key, or on the AI connection built into WordPress 7.0 and later, so there is no per-conversation fee from us and no middleman server.

Shoppers ask the same things all day: Is it in stock? How much is shipping? Where is my order? The assistant answers from live lookups in your store, and says so when it does not know.

Quick facts

  • Made for: WooCommerce stores that sell through chat (conversational commerce), small teams without full-time support staff, and stores with shoppers in several languages.
  • Price: free, with no message cap or time limit from us. Optional Starter and Pro plans add features.
  • AI providers: OpenAI, Anthropic Claude or Google Gemini with your own API key, or the provider connected in WordPress 7.0+ (Settings > Connectors). Local-only mode needs no key.
  • AI cost: billed by your provider at its own rates. The AI Value & Performance tab shows what your store spent.
  • Languages: a multilingual chatbot that replies in the shopper’s language, detected without an AI call: English, Vietnamese, Thai, Indonesian, Malay, Chinese, Japanese, Korean, Arabic, Russian, Ukrainian, Spanish, Portuguese, French and German.
  • Your data: conversations, contacts and leads stay in your WordPress database.
  • Works with: WordPress 6.3+, PHP 8.1+, WooCommerce with HPOS and the Cart and Checkout blocks. The chat and lead capture also work without WooCommerce.

Get started in three steps

  1. Connect an AI provider. Paste your API key from OpenAI, Anthropic or Google, or choose the WordPress AI connection. You pay the provider directly. Or start in local-only mode with no key.
  2. Sync your catalog. One click, or wp ninhle-ai-sales-assistant sync-products, and the assistant knows your products, prices and stock.
  3. Go live. The chat appears on your store with your name, logo, colour and suggested questions.

Answers from your store, not guesses

  • Product facts come from your WooCommerce store: prices, stock, product details, store policies and your own pages.
  • The AI can only propose products from your catalog, and products you hide from the catalog are never shown.
  • Product cards read the current price and stock from WooCommerce when the reply is shown.
  • When a search finds nothing, the assistant suggests the nearest categories and asks one question instead of guessing.

What shoppers can do in the chat

AI product recommendations. The assistant recommends products that match the question, as cards with photo, current price, stock and rating.

Add to cart without leaving the chat. WooCommerce updates the cart in the shopper’s own browser, so your prices, stock rules and discounts apply. Products with options link to the product page; the Starter plan adds options, quantities and allowed discount codes on the card.

See shipping and the total before checkout. WooCommerce calculates the shipping options for the shopper’s address, tax and total, and the chat lists your payment methods. Payment happens on your checkout page through your gateway; the chat never takes card details.

Track an order. “Where is my order?” gets an order card with the status, items, total and tracking number, and the delivery status when your shipping plugin reports it. Guests must prove they own the order first.

Reach a person. “Talk to a person” is always visible. Complaints, explicit requests and questions your store data cannot answer go to your team’s Inbox in WP Admin.

What you see as the store owner

Sales Insights: why shoppers don’t buy. The questions the assistant could not answer, grouped and ranked; type your answer there and the assistant uses it from the next reply. It also shows what shoppers searched for but could not find, and which products they wanted while out of stock. Contact details are hidden. In the Starter plan, an AI labels each night why chats did not lead to an order (price, shipping, size, stock and more), with quotes and an optional weekly email.

AI Value & Performance. What the AI cost, how many orders followed a chat and how conversations ended, each with its sample size, from the day you install.

Also in the free version:

  • Order status for the order’s owner, digital downloads, store policies and site content.
  • Sales playbook and rules: persona, qualifying questions, objection handling, closing and keyword rules.
  • Lead capture in the chat, stored in your database and exportable to CSV.
  • Human handoff and Inbox: a clear status for visitors, take over and hand back, an optional webhook.
  • Voice input (optional, off by default).
  • Personal-data export and erasure, and translation-ready.

Match your store’s brand

Set the assistant’s name, logo, colour and font (the default system font, or Inter, Roboto, Open Sans, Montserrat or Poppins), the tagline under the chat and the suggested questions, and check them in the live preview. Shoppers see your brand, with no “Powered by” link.

Add WhatsApp, Messenger, Zalo, Telegram and hotline buttons to the chat, so shoppers can also reach you where they prefer. A notice tells visitors the chat may be assisted by AI; it is on by default and you can write your own text. You can hide the chat on the checkout page.

Ready for AI agents (MCP)

On WordPress 6.9 and later, turn on “AI agents” in Settings to register read-only abilities with the WordPress Abilities API: product search, product details and store policies. The MCP Adapter plugin can offer them to MCP clients. Only published, visible products and your store policies are shared, never orders, carts or customer data. Off by default, limited to 60 requests per hour per IP address.

Compared with a hosted ecommerce chatbot

  • No per-conversation fee from us. You pay your AI provider directly, and answers your store data can give need no AI call.
  • No middleman server. Every provider call is made from your server, and conversations stay in your database.
  • Built on WooCommerce. The cart, shipping and totals are calculated by WooCommerce, and orders and tracking are read from your store.

Optional paid plans

Ninhle AI Sales Assistant is free to install and use. Optional paid plans add extra code to the plugin; nothing in the free version is locked or time-limited.

Starter — cash-on-delivery and bank-transfer orders in the chat; “payment received” messages, with payment checks for your team when a shopper says they paid; VietQR for Vietnamese dong; orders your team creates in the Inbox with a payment link; shipment updates in the chat (off by default); options, quantities and allowed discount codes on product cards; nightly AI labels of why shoppers did not buy, with a weekly email summary; a customer card in the Inbox; product variations with per-variation add-to-cart links; Telegram notifications for new leads and handoffs; a sales dashboard; cached answers for repeated questions; the revenue of orders that followed a chat, per currency, on the AI Value & Performance tab; and signed webhooks with automatic retries (Standard Webhooks) for n8n, Make, Zapier and CRMs.

Pro — everything in Starter, plus coupon validation, automatic failover to a second AI provider, daily and monthly AI budget caps, rule-based lead scoring with advanced analytics, price-output verification, payment method order by country or customer group in the chat, and sales abilities for your own AI agent (conversations, leads, orders after chats, checkout links and draft replies that your team reviews in the Inbox).

AI usage is never included: OpenAI, Anthropic and Google bill you directly for your own API key, on every plan including Free. Plans and prices: https://ninhle.com/en/woocommerce-ai-sales-assistant/

External services

The plugin connects to the services below. Except for the AI provider you configure, each one is used only when you turn the related setting on.

AI provider (the one you configure) — receives the visitor’s chat messages, recent conversation history, your sales playbook and business information, and product data from your own store, each time a visitor sends a message. Nothing is sent in local-only mode. If you choose “WordPress AI connection” (WordPress 7.0+), the same data goes through WordPress to the provider you connected in Settings > Connectors, under that provider’s terms.

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

Sales Insights AI labeling (Starter plan only, optional, off by default) — the free version contains no code for this. If you turn it on, once a night the text of finished chats that did not lead to an order is sent to your AI provider, with email addresses and phone numbers replaced by placeholders, so the AI can label why the shopper did not buy. A monthly spending limit you set stops the job.

Link reading (optional, off by default) — when you enable “Let the bot read links customers send”, a URL a visitor pastes into the chat is sent to r.jina.ai to fetch its text (https://jina.ai/legal/). YouTube links are read from youtube.com instead, to get the video title and public transcript (https://policies.google.com/privacy, https://www.youtube.com/t/terms). Leave this off if visitors might paste private links.

Google Fonts (optional) — only if you pick a Google font for the widget in the settings. Visitors’ browsers then load that font from fonts.googleapis.com (https://policies.google.com/privacy). The default font loads nothing from Google.

Voice input (optional, off by default) — only if you turn on “Let visitors speak their message”. The microphone button uses the speech recognition built into the visitor’s own browser (Web Speech API). Depending on the browser, the audio may be sent to the browser maker’s speech recognition service, for example Google for Chrome (https://policies.google.com/privacy), Apple for Safari (https://www.apple.com/legal/privacy/) or Microsoft for Edge (https://privacy.microsoft.com/privacystatement). The plugin never receives, records or stores audio; it only receives the text the visitor chooses to send.

Handoff webhook (optional) — only if you enter a webhook URL. On a handoff the plugin sends the conversation ID, contact ID and handoff level to that URL, which you control.

Telegram (paid plans only, optional) — the free version contains no Telegram code. In the Starter and Pro plans, if you enter a Telegram bot token and chat ID, new leads (name, email, phone) and handoff requests (priority, issue, summary, conversation number) are sent to api.telegram.org (https://telegram.org/privacy, https://telegram.org/tos).

Automation webhooks (Starter and Pro plans, optional) — the free version contains no code for this. If you enter a webhook URL, the events you choose are posted to that URL, which you control, signed with your secret: leads and handoffs, and, if you turn them on, cart, checkout and order events. Order events cover orders placed after a chat and include the buyer’s name, email and phone number, the items and the total.

Freemius (licensing, upgrades and affiliate program) — the plugin bundles the Freemius SDK. Nothing is sent to Freemius from your storefront. The plugin contacts Freemius only when an administrator does one of the following:

  • Opts in to usage data: the WordPress user’s name and email, site URL and title, WordPress, PHP and plugin versions, site language, and whether the plugin is active or uninstalled. The list of plugins and themes is sent only if that permission is left on.
  • Opens the Upgrade (pricing) page, starts a trial, buys a plan or activates a license. With an active license, the paid version then checks Freemius for updates and license status.
  • Opens the Affiliation page in the plugin menu: the affiliate program terms are loaded from Freemius.
  • Submits the affiliate application form: the name, email, PayPal email, website domains and promotion details entered in the form are sent to Freemius. If the site is not connected to Freemius yet, it is connected with the email entered, with usage tracking off.
  • Clicks “Contact Us”: the Freemius contact form opens in a new browser tab.

Freemius terms: https://freemius.com/terms/ — privacy policy: https://freemius.com/privacy/ — affiliate program terms: https://freemius.com/plugin/39395/ninhle-ai-sales-assistant/legal/affiliate-program/

Security

API keys are stored server-side and never sent to the browser; the settings screen shows only a masked value. Every provider call is made from your server through the WordPress REST API.

Database queries use $wpdb->prepare(). Every REST route declares a real permission_callback, and the endpoints the AI uses as tools are internal-only: they cannot be reached from outside the site. Visitor sessions use hashed tokens and chat messages are rate limited per session. When a background AI reply is started through a loopback request, that request is signed and expires after 60 seconds.

The plugin server never changes a shopper’s cart: “Add to cart” in the chat calls the WooCommerce Store API from the shopper’s own browser. Chat messages are rendered as DOM elements rather than injected HTML, and only http and https links are made clickable, so content returned by the AI cannot inject markup.

Please report security issues privately to the author rather than in a public forum.

Privacy

Conversations, contacts and leads are stored in your own WordPress database, and no data is sent anywhere except the services listed under External services. The plugin registers with Tools > Export Personal Data and Tools > Erase Personal Data, adds a suggested paragraph to Settings > Privacy, and purges message attachments on a retention schedule you choose.

What else the plugin stores about shoppers, and what the chat keeps in the visitor’s browser, is listed in the FAQ. All of it is included in the personal-data export and removed by the eraser.

Orders placed in the chat (Starter) are normal WooCommerce orders; the plugin also records consent to the notice under the phone field as a fingerprint of the text shown. Shipment updates (Starter, off by default) go only to the chat of that order and, if enabled, by email to shoppers who agreed, with a stop link. AI agents use their own WordPress user and application password.

Installation

  1. Install from Plugins > Add New Plugin (search for “Ninhle AI Sales Assistant”), or upload the plugin ZIP, then activate.
  2. Go to Ninhle AI Sales > Settings and enter an API key for your chosen AI provider, choose the WordPress AI connection (WordPress 7.0+), or choose local-only mode.
  3. Fill in the Business information and review the Sales playbook.
  4. Click “Sync products now” (or run wp ninhle-ai-sales-assistant sync-products) so the assistant knows your catalog.
  5. Open your store and ask the chat a product question to check the answers.

FAQ

What is Ninhle AI Sales Assistant?

A free WordPress plugin that adds an AI chatbot and shopping assistant to a WooCommerce store. It answers product, shipping and order questions from your own store data, shows products as cards with an Add to cart button, tracks orders and hands the chat to your team when needed. It uses your own OpenAI, Anthropic Claude or Google Gemini API key, or the AI connection built into WordPress 7.0 and later.

Is this a free AI chatbot for WooCommerce?

Yes. The free version is complete and has no time limit or message cap from us. You pay only your AI provider for your own API key, or use local-only mode with no key at all.

Is this a ChatGPT plugin for WooCommerce?

It works with OpenAI, the company behind ChatGPT, through the OpenAI API with your own API key. It can also use Anthropic Claude or Google Gemini instead. The plugin is not made by or affiliated with OpenAI, Anthropic or Google.

Which AI models does the chatbot work with?

Anthropic Claude, OpenAI and Google Gemini, with your own API key for each. On WordPress 7.0 and later you can also use the AI provider connected in Settings > Connectors. You choose the provider and can switch at any time.

Does my ChatGPT Plus, Claude Pro or Gemini subscription work?

No. Those app subscriptions are separate from API access. You need an API key from the provider’s developer platform (OpenAI Platform, Anthropic Console or Google AI Studio), billed by that provider for what you use. Local-only mode needs no key.

Can I try it without an API key?

Yes. Local-only mode answers greetings, store policies, cart and order questions from your store data without calling any AI provider. Add a key later when you want full conversations.

How much does an AI chatbot for WooCommerce cost to run?

It depends on the provider and model you choose, and you pay the provider directly. In our test of 60 conversations on a real store with version 2.6.0, GPT-4o mini cost about US$0.0009 per conversation and Gemini 3.8 Flash about US$0.015. The AI Value & Performance tab shows what your own store actually spent.

Can this WooCommerce chatbot add products to the cart?

Yes. Product answers show cards with an Add to cart button, and the cart is updated by WooCommerce in the shopper’s browser, so your prices, stock and cart rules apply. In the free version, products with options link to the product page; the Starter plan lets shoppers choose options and quantities on the card. Nothing is added until the shopper taps the button.

Does the shopping assistant recommend products?

Yes. It searches your synced WooCommerce catalog, recommends products that match what the shopper asked for and shows them as cards. It only recommends products that exist in your store.

Will it invent prices or stock?

No. Product facts come from lookups against your store, and product cards read the current price and stock from WooCommerce when the reply is shown. If the catalog has not been synced, the bot is told to say so and offer a handoff instead of guessing.

Can customers track their orders in the chat?

Yes. The assistant shows an order card with the status, items and tracking number. Logged-in customers can ask for their recent orders. Guests give the order number together with the email address or phone number used for the order; without that proof the assistant reveals nothing. In the Starter plan you can also tell shoppers in the chat when their order ships, is delivered or has a delivery problem.

Which shipment tracking plugins does it read?

WooCommerce Shipment Tracking, Advanced Shipment Tracking with TrackShip, AfterShip, ParcelPanel, Trakoo and YITH Order Tracking, or an order field you choose. The Track link and the delivery status come from your shipping plugin when it reports them.

Can shoppers pay in the chat?

Card and wallet payments always happen on your store’s checkout page, through your WooCommerce payment plugin (Stripe, PayPal or any gateway); the chat never takes card details. The order summary shows the total with shipping before the shopper goes there. In the Starter plan, shoppers can place cash-on-delivery and bank-transfer orders without leaving the chat, Vietnamese stores can show VietQR codes, and your team can create an order in the Inbox and send a payment link.

Which languages does it reply in?

English, Vietnamese, Thai, Indonesian, Malay, Chinese, Japanese, Korean, Arabic, Russian, Ukrainian, Spanish, Portuguese, French and German. The language of each message is detected without an AI call, and the reply keeps product names, prices and order numbers exactly as in your store. This is on by default for new installs; sites upgraded from an earlier version keep replying in the store’s language until you change “Reply language” in Settings.

Can a real person take over the chat?

Yes. “Talk to a person” is always visible to shoppers, and the assistant hands off complaints, explicit requests and questions your store data cannot answer. Your team replies from the Inbox in WP Admin, can take over and hand back, and the shopper sees new replies on the chat button. An optional webhook can alert your own tools.

What does Sales Insights show?

The questions shoppers asked that the assistant could not answer, grouped and ranked, what they searched for but could not find, and which products they wanted while out of stock. You can add an answer from the same screen. The Starter plan adds the reasons chats did not lead to an order and a weekly email summary.

What counts as an “AI-assisted order”?

An order placed within your attribution window (24 hours, 72 hours or 7 days) after the customer received an answer with products from your store, or clicked a product or cart link in the chat, or added a product to the cart from the chat. Each order is counted once. Cancelled, failed and fully refunded orders are left out, and partial refunds are deducted. AI-assisted does not mean the AI was the only reason for the order.

To make the link, the conversation number is saved in the visitor’s WooCommerce shopping session when the assistant shows products or the visitor clicks a product or cart link in the chat.

Can I make the chat widget match my theme?

Yes. Set the assistant’s name, logo, colour, font, tagline and suggested questions, and check them in the live preview before you save. The default system font loads nothing from Google; Inter, Roboto, Open Sans, Montserrat and Poppins are loaded from Google Fonts. The chat shows your brand, with no “Powered by” link.

Can shoppers contact us on WhatsApp, Zalo or Messenger?

Yes. Enter your WhatsApp number, Messenger link, Zalo link, Telegram username or link, or hotline in Settings, and each one appears as a button in the chat. These buttons open your own accounts; the assistant does not answer on those apps.

Does it tell visitors they are talking to an AI?

Yes. A short notice in the chat says it may be assisted by AI and asks visitors not to share sensitive information such as passwords or card details. It is on by default, and you can replace the text with your own.

Will it slow down my store?

The chat button is small. The chat window, product cards, cart view and voice input load only when they are needed, and AI replies run in the background after a message is sent. While the chat is minimized after a recent conversation, it checks for new replies every 25 seconds, only while the browser tab is visible. Nothing is loaded from third-party servers unless you pick a Google font.

Does it support HPOS and the Cart and Checkout blocks?

Yes. It works with WooCommerce High-Performance Order Storage (HPOS) and with the Cart and Checkout blocks.

Does it work without WooCommerce?

The chat and lead capture work on any WordPress site. Product search, product cards, catalog grounding and order lookup require WooCommerce.

Can AI agents read my product catalog (MCP)?

Yes, if you allow it. On WordPress 6.9 and later, turn on “AI agents” in Settings: the plugin registers read-only abilities for product search, product details and store policies. With the MCP Adapter plugin, MCP clients can use them. Orders, carts and customer data are never shared.

Is my store data sent to you?

No. Conversations, contacts and leads stay in your own WordPress database. Messages go only to the AI provider you configure, and the other services listed under External services are used only when you turn them on.

What does the plugin store about shoppers?

In your WordPress database: conversations, contacts and leads; the link between a conversation and an order that followed it; the visitor’s answer to “Did this answer your question?”; unanswered questions, with email addresses and phone numbers hidden; the language of each conversation; and the account or order number when a logged-in customer chats or a customer proves they own an order. In the Starter plan, also the reason a chat did not lead to an order, with a short quote. All of this is included in the personal-data export and removed by the eraser.

In the visitor’s browser (localStorage), the chat keeps its session token and, for the new-replies badge, the conversation number, the last message seen and when it was seen. No message text is stored there.

What do the Starter and Pro plans add?

Starter adds orders in the chat (cash on delivery, bank transfer, VietQR), shipment updates, options and quantities on product cards, the reasons shoppers did not buy, Telegram alerts and signed webhooks. Pro adds coupon validation, failover to a second AI provider, AI budget caps, lead scoring and sales abilities for your own AI agent. The full lists are in the Description; plans and prices are at https://ninhle.com/en/woocommerce-ai-sales-assistant/

Is there an affiliate program for agencies?

Yes. Agencies and freelancers who build WooCommerce stores can earn a commission on the paid plans they refer. Apply from the Affiliation page in the plugin menu; the commission and terms are at https://freemius.com/plugin/39395/ninhle-ai-sales-assistant/legal/affiliate-program/

Is anything in the free version locked?

No. Paid plans add separate code; the free version contains no locked or trial-limited features.

Where is the source code of the JavaScript files?

The files in assets/dist are built with Vite from the human-readable source shipped in the plugin under src/JS (admin screens and chat widget). To rebuild them, run npm ci and then npm run build in the plugin folder; the build configuration is in vite.config.ts and package.json.

Screenshots

Changelog

2.7.0

  • Added: order summary in the chat: items, shipping options for the shopper’s address, tax, total and the store’s payment methods, calculated by WooCommerce in the shopper’s browser. Checkout opens the store’s checkout page; nothing is ordered from the card.
  • Added: checkout links: “Get a payment link” opens the same items on another device, and the assistant can offer a “Checkout with these items” button. Orders placed from a link still count as orders that followed a chat.
  • Added: tracking numbers and delivery status from AfterShip, ParcelPanel, Trakoo and YITH Order Tracking, and the delivery status from TrackShip, on order cards.
  • Added (Starter): cash-on-delivery and bank-transfer orders placed in the chat with the store’s own address fields, a consent notice under the phone field and payment instructions. Stores with checkout fields the chat cannot show keep using the checkout page.
  • Added (Starter): “payment received” in the chat when an order is paid. A shopper saying they paid, or sending a screenshot, never confirms a payment: it opens a payment check for your team in the Inbox.
  • Added (Starter): VietQR codes for bank-transfer orders in Vietnamese dong, made on your site.
  • Added (Starter): create an order for a shopper in the Inbox, with WooCommerce shipping and totals, and send a payment card or a checkout link.
  • Added (Starter, off by default): shipped, delivered and delivery-problem updates in the chat and optionally by email, once per update, only for orders placed after a chat.
  • Added (Starter): webhooks with Standard Webhooks signatures, automatic retries and a delivery log, now in Starter instead of Pro; new cart, checkout, order and shipment events you can turn on.
  • Added (Pro): sales abilities for your own AI agent (WordPress 6.9+ and the MCP Adapter), with draft replies your team reviews in the Inbox. Sending directly to shoppers is off by default.
  • Added (Pro): two roles for your agent’s WordPress user, “Ninhle AI agent (read only)” and “Ninhle AI agent”, so its Application password reaches only the abilities you allow. A wrong key gets 401, a call without permission 403. Each call is logged with the key name and result, never the key.
  • Added (Pro): payment method order by country or customer group for shoppers coming from the chat.
  • Added (Starter): the order form keeps a consent record for each purpose (processing the order, order updates by email) with the conversation and the exact text shown. The email updates question is optional, never pre-ticked, and shown only when shipment emails are on.
  • Added: a notice in the AI settings about what the AI provider receives.
  • Changed: new default notice under the chat about AI assistance and sensitive information. A notice text you changed is kept.
  • Fixed: the City field of the shipping calculator was never shown, and stores’ calculator filters were ignored.
  • Fixed: the conversation.started webhook event was listed but never sent.
  • Fixed: the default text under the chat (“AI sales assistant, available 24/7”) was not translated.
  • Fixed: a product card marker the AI wrote without product numbers could appear as text in the reply.
  • Fixed: opening your own payment link on the device that already had those items in the cart doubled the quantities.
  • Fixed: orders paid with gateways that create the order early, such as PayPal Payments, were not counted as orders that followed a chat, so no “payment received” message was sent.

2.6.0

  • Added: add to cart in the chat. Product answers show cards with photo, current price, stock and rating, read from WooCommerce when the reply is shown. Simple products have an Add to cart button that uses the WooCommerce Store API in the shopper’s browser; the plugin server never changes the cart. A cart view in the chat shows the items, subtotal and Checkout.
  • Added: order tracking cards in the chat, with status, date, items, total and tracking number with a Track link (WooCommerce Shipment Tracking, Advanced Shipment Tracking or an order field you choose in Settings). Logged-in customers can ask for their recent orders without giving an email address.
  • Added: Sales Insights tab: questions the assistant could not answer, grouped and ranked, with “Add answer” to teach the assistant; searches with no matching product; products wanted while out of stock. Email addresses and phone numbers are hidden.
  • Added: replies in the shopper’s language (15 languages detected without an AI call). New installs reply in the customer’s language; upgraded sites keep the store’s language until you change “Reply language” in Settings.
  • Added (Starter): choose options and quantities on product cards, remove items and apply discount codes you allow; the assistant can prepare the card with the shopper’s choice.
  • Added (Starter): nightly AI labels of why chats did not lead to an order, with quotes, a monthly spending limit and an optional weekly email summary.
  • Added (Starter): a customer card in the Inbox for logged-in customers and customers who proved an order: order count, total spent, last order and recent products. Shown only to users who can view WooCommerce orders.
  • Added: a badge on the chat button when a reply arrives while the chat is minimized.
  • Added: “WordPress AI connection” as an AI provider on WordPress 7.0 and later (Settings > Connectors).
  • Added: optional read-only abilities for AI agents (WordPress Abilities API, WordPress 6.9+): product search, product details and store policies. Off by default.
  • Added: after a week of use, once the assistant has answered at least 10 conversations or helped with an order, administrators are asked on the plugin screens whether they would leave a review on WordPress.org, with “Maybe later” and “Don’t ask again”. At most three times, never within a day of an AI error, and it can be turned off with a filter.
  • Changed: AI replies now run in the background after a message is sent, instead of inside the visitor’s next request. At most 2 replies run at the same time by default. The chat checks for replies often right after a message and less often while idle.
  • Changed: product search also finds products when the shopper’s words are in a different order or include extra words.
  • Changed: the plugin is now named “Ninhle AI Sales Assistant – AI Chatbot for WooCommerce”.
  • Fixed: products hidden from the catalog could still be recommended.
  • Fixed: a product on sale for 0 was quoted at its regular price, and a sale scheduled for later was quoted before it started.
  • Fixed: questions that mention payment (for example “Do you have a plugin for QR payments?”) were answered with the checkout link.
  • Fixed: logged-in customers were treated as guests in the chat, so their account could not be used to look up their orders.
  • Fixed: with Google Gemini, a saved model that Google no longer offers to new API keys made every reply fail. The plugin now falls back to the current Gemini Flash model and logs a reminder to update the setting.
  • Fixed: Gemini could return an empty reply when its thinking used up the answer length.
  • Fixed: with LiteSpeed Cache, the cart shown in the chat could be served from the page cache and look empty or out of date.
  • Fixed: when the AI provider was slow, the visitor could be told the assistant was still looking and then get no answer.

2.5.0

  • Added: optional voice input, off by default (“Let visitors speak their message” in Settings). Visitors tap the microphone and the browser turns their speech into text in the message box; they check it and send it themselves. The plugin never receives or stores audio. Shown only on HTTPS pages in browsers with speech recognition (not Firefox). Clear messages if the microphone is blocked, missing or not understood; typing always works.
  • Fixed: assistant replies no longer show raw formatting characters such as ** or -. Bold text, lists, tables, links and product images now display properly in the chat.
  • Fixed: product images could show as broken when the original file had been deleted from the server. The plugin now uses a resized copy that still exists, hides any image that cannot load, and loads same-site images over https on https pages.
  • Fixed: clicks on site-relative links in the chat are now counted for AI-assisted orders.
  • Changed: the chat window loads only when a visitor is about to open it, so pages load less JavaScript up front.
  • Changed: the Inbox shows readable statuses and senders, and the Rules Engine describes each rule in plain words instead of JSON.

2.4.1

  • Added: an Affiliation page in the plugin menu, for administrators, to apply for the Ninhle AI affiliate program: 30% commission on new sales and renewals, with a 45-day cookie. The program terms are loaded from Freemius when you open the page.
  • Added: an “Earn 30% commission” link on the Settings page, shown only to administrators. The automatic affiliate notice of the Freemius SDK is turned off.
  • Changed: the External services section of this readme lists every case in which the plugin contacts Freemius.

2.4.0

  • Added: AI Value & Performance tab – AI cost recorded per request with the provider’s usage and a dated price table, AI-assisted orders, and conversation outcomes (confirmed resolved, probably resolved, handed off, unresolved or unknown) with sample sizes. Figures start on the day you upgrade; older data is not backfilled.
  • Added: “Talk to a person” button in the chat widget. It hands the conversation to your team without calling the AI, and pressing it again does not create a second handoff.
  • Added: the widget shows a real status (AI assistant, waiting for a team member, a team member is helping you) and a short progress line while the assistant looks up products or orders.
  • Added: a “Did this answer your question?” prompt inside the chat, at most once per conversation, which visitors can skip.
  • Added: a line telling visitors they are chatting with an AI assistant, on by default and editable.
  • Added: WhatsApp and Telegram links next to Messenger, Zalo and phone; an option to hide the chat on the checkout page.
  • Changed: redesigned chat widget – simpler header, secondary actions in a “…” menu, no borders, text colour chosen for contrast on your brand colour, full screen on phones, keyboard support (Escape closes and returns focus).
  • Changed: on cart and checkout pages the chat button moves out of the way of the place-order button on phones.
  • Changed: revenue of AI-assisted orders is now part of the Starter plan.
  • Changed: the settings screen shows the model each provider actually uses and an estimated cost per conversation, and warns when a saved model has been retired.
  • Changed: Gemini replies count the model’s thinking tokens in the recorded cost, as Google bills them.
  • Changed: browser pop-ups (alert and confirm) in the admin screens and the widget are replaced by in-page messages.
  • Removed: Thinking mode and the prompt generator (“create prompt”) in the chat widget. Their settings are kept but no longer used.
  • Fixed: the assistant’s internal reasoning could appear in replies, the inbox and data exports; it is now removed before anything is saved, and older messages are cleaned when they are read.
  • Fixed: handoffs were counted only while a conversation was waiting for staff, so taking over or handing back made them disappear from the statistics.
  • Fixed: automation rules created in the Rules screen never ran.
  • Fixed: OpenAI errors (wrong or expired key, used-up quota, server errors) were treated as an empty answer, so the backup provider was never tried and nothing was logged. They are now reported as errors and the next provider in the chain answers.
  • Fixed: when the AI provider returned an empty answer, the visitor received no reply at all; they now get a short message asking them to rephrase.
  • Fixed: when every AI provider failed, the reply said the visitor had been passed to a colleague without doing so; it now says the assistant is briefly unavailable and points to “Talk to a person”.
  • Fixed: migration steps from earlier versions could not be recorded because their names were too long.
  • Fixed: the sample business details added at install (opening hours, cash on delivery, delivery times, 7-day returns) were given to shoppers as if they were the store’s own terms, even after the field was cleared. New installs start with this field empty, unchanged sample text is no longer used, and Settings asks you to enter your real details. Until then the assistant offers to check with your team instead of stating terms.
  • Fixed: “Restore default playbook” also replaced your business information with the sample text.
  • Fixed: product search results given to the assistant now state your store currency, so it no longer guesses one (for example “$” in a VND store), and product summaries use your currency format instead of always “đ”.
  • Fixed: products with variations (size, colour) had no price in the assistant’s product list, so it could not quote a price and price searches skipped them. The assistant now sees the price range and quotes a “from” price unless it has checked the chosen option.
  • Fixed: with “Delete data on uninstall” turned on, two plugin options were left in the database.
  • Fixed: on sites with WooCommerce, scheduling the plugin’s background tasks could log a “translation loading triggered too early” notice.

2.3.0

  • Added: WordPress personal-data export and erasure cover every table the plugin creates.
  • Added: declared compatibility with WooCommerce HPOS and the Cart/Checkout blocks.
  • Changed: the chat widget is one continuous white card (header, messages and composer) and fits narrow phone screens.
  • Changed: the widget uses the system font by default and loads Google Fonts only if you pick a Google font in the settings.
  • Changed: a chat session is created only when a visitor opens the chat, not on every page view. Returning visitors are no longer rate-limited, so visitors on shared mobile or office networks keep the chat button.
  • Fixed: on phones, the chat button could sit off-screen when the theme has content wider than the screen (for example a news ticker).
  • Fixed: automation rules could not be saved because the rules table was missing two columns; existing sites are repaired automatically.
  • Fixed: deleting an automation rule reported an error even though the rule was deleted.
  • Changed: the plugin is now named Ninhle AI Sales Assistant for WooCommerce.
  • Fixed: inline scripts attached to the admin and widget bundles were dropped when the bundles were loaded as ES modules.
  • Changed: Telegram notifications, product variations, coupon validation, provider failover, budget caps and the sales dashboard now ship only in the paid plans, as separate code.
  • Changed: translations come from translate.wordpress.org; the plugin no longer bundles its own translation files.
  • Fixed: handoff replies are now translatable instead of always Vietnamese.
  • Fixed: on/off settings saved as “on” were read back as “off”, so link reading, the prompt creator and the adaptive playbook never ran when enabled.
  • Fixed: the assistant could stop replying after looking up products or other tools.
  • Fixed: the assistant now reads PDF files customers attach, and reliably looks at attached images when using OpenAI.
  • Fixed: when link reading is on, files a customer uploads are no longer sent to the link-reading service.
  • Fixed: AI cost was recorded as zero when no model was chosen in the settings; the default model is now used for cost estimates.
  • Fixed: Gemini failed when the model field was left empty.
  • Fixed: attached files were never removed from conversations that were not closed, and deleting or clearing a conversation left its files on the server. Files sent in the chat are now deleted after the retention period, and immediately when their conversation is deleted or cleared.
  • Fixed: file uploads no longer require the PHP fileinfo extension.
  • Security: attachment paths are validated before files are read for the AI provider.
  • Changed: if processing a message fails unexpectedly, the visitor gets an apology instead of no reply.
  • Added: customers can paste an image (for example a screenshot) straight into the chat box.
  • Fixed: suggested follow-up questions sometimes appeared as raw “[SUGGESTIONS]” text instead of buttons.
  • Fixed: the response cache no longer stores answers that contain prices or stock status.
  • Security: YouTube caption downloads only go to youtube.com over HTTPS.
  • Changed: the free version no longer shows settings for features that exist only in the paid plans.
  • Fixed: the leads CSV export downloaded as escaped text instead of a spreadsheet; it now opens correctly in Excel, including accented names.
  • Changed: licensing and upgrade notices appear only on the plugin’s own admin pages.
  • Fixed: when coupon checking is not available, the assistant no longer tells customers a code is invalid; it asks them to enter it at checkout.
  • Security: chat responses are never stored by page caches (for example LiteSpeed Cache or a host CDN). A cached response could be served without a valid chat session, and visitors could miss the assistant’s reply.
  • Fixed: with Google Gemini or Anthropic Claude, product and order lookups could fail and the internal lookup command could appear in the chat.
  • Fixed: the default Gemini and Claude models had been retired by Google and Anthropic. The plugin now defaults to current models and ignores retired model names saved by earlier versions.
  • Changed: the default chat widget name is “Shop Assistant”; set your own name in the settings.
  • Added: the assistant knows the current date and time in your store’s timezone (Settings > General), so it can tell customers the date and take it into account for opening hours, delivery times and promotion end dates.

2.2.0

  • Added: three-tier licensing – Free, Starter and Pro – with Pro inheriting all Starter features.
  • Added: premium code moved to a separate directory so the Free build genuinely excludes it rather than hiding it.
  • Added: safe fallbacks so the Free build runs with no paid code present at all.
  • Changed: minimum WordPress raised to 6.3.

2.1.0

  • Changed: the admin interface is now English throughout; Vietnamese ships as a translation.
  • Changed: default widget tagline and policy fallbacks are English and brand-neutral.
  • Fixed: the Rules screen was calling REST helpers that did not exist, so every action on that tab failed.

2.0.0

  • Added: Freemius SDK for optional paid plans, supporting annual subscriptions and lifetime licenses.