=== Free AI Chatbot for WordPress & WooCommerce - Ruma AI ===
Contributors: rumaai
Donate link: https://rumadesk.com/pricing
Tags: ai chatbot, ai agent, live chat, customer service, order tracking
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 3.2.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Free AI chatbot and live chat for WooCommerce. Answers from your own content, tracks orders, finds products, books meetings. No OpenAI key needed.

== Description ==

Ruma AI is a **free AI chatbot for WordPress and WooCommerce** that does more than answer questions. It is an AI agent: it decides which of its 13 tools to use in each conversation, the way a trained support rep would.

Train it on your own pages, PDFs and URLs. It answers from that content using retrieval, so replies come from your business instead of being invented.

**The free plan includes 100 messages a month. No credit card, and no OpenAI API key** - replies are generated for you, so there is no second AI bill to manage.

= What the AI chatbot can do =

* **Answers from your own content** - upload pages, PDFs or URLs and the chatbot replies using your material. A chatbot with your data, not generic answers.
* **WooCommerce product search** - shoppers describe what they want in plain language and the AI product search finds it, with prices and an add-to-cart link.
* **Order tracking chatbot** - customers ask "where is my order". The bot verifies their email with a one-time code first, then reports the status. It can only ever see orders belonging to that verified email.
* **Cancellations and refunds** - optional, off by default, limited to the verified customer's own orders.
* **Coupon suggestions** - surfaces only the discounts you choose to expose.
* **Voice chatbot** - customers speak to the assistant and hear it reply, inside the same chat widget.
* **Lead capture and appointment booking** - collects contact details and books slots on your calendar.
* **Live chat handoff** - passes the conversation to a human when the AI cannot help.
* **Multilingual chatbot** - detects the visitor's language and replies in it, across 50+ languages.
* **Full theming** - colours, position, avatar, welcome message, starter prompts and fonts, all from your WordPress admin.

= Why an AI agent, not just a chatbot =

A scripted chatbot matches keywords to canned replies. This AI agent for WooCommerce reads the conversation, picks a tool, runs it against your live store data, and answers with the real result.

"Do you have this in blue under 2000?" runs a real product search against your catalogue. "Cancel my last order" verifies the customer's email, finds their order, and cancels it. That is the difference between an ecommerce chatbot and an AI agent.

= Free plan =

* 100 AI messages every month, free, forever.
* No credit card required to start.
* No OpenAI or ChatGPT API key to buy or configure.
* Paid plans raise the message allowance and remove the small Ruma AI badge.

= Privacy and performance =

The chat widget is one deferred script plus one stylesheet, loaded after your page renders. **The Inter font ships inside the plugin**, so a visitor's browser makes no request to Google Fonts and no visitor IP is shared with a third party in the default setup.

== External services ==

This plugin connects to Ruma AI, a third-party service, to generate replies. A free Ruma AI account at [rumadesk.com](https://rumadesk.com) is required; the plugin cannot answer questions without one.

**Ruma AI API (rumadesk.com)** - every chat message is sent here to produce a reply.

* Sent when a visitor uses the chat: the message text, a random session id, your site domain and your API key. If the visitor provides an email for an order lookup, that email is sent too.
* Sent when you save settings: your API key and site domain, to validate your plan.
* Sent when WooCommerce integration is enabled and you tick the matching scope: the product, order or coupon data your store returns for that request. You choose which scopes are active; nothing is sent for a scope you leave off.
* Terms: [rumadesk.com/terms](https://rumadesk.com/terms) - Privacy: [rumadesk.com/privacy](https://rumadesk.com/privacy)

**Google Fonts (fonts.googleapis.com)** - only if you pick a font other than the bundled Inter in the widget appearance settings. Leave the default and no request is made.

**DiceBear (api.dicebear.com)** - only if you choose one of the illustrated avatars from the avatar picker. The generated image URL is then loaded by visitors' browsers. Choosing a bundled avatar avoids this entirely. Service terms: [dicebear.com](https://dicebear.com).

== Installation ==

1. Create a free account at [rumadesk.com](https://rumadesk.com) and train your AI under Dashboard, then Training.
2. In WordPress go to **Plugins, Add New, Upload Plugin**, choose the zip and activate.
3. Open the **Ruma AI** menu and paste the API key from Dashboard, WordPress, Connect.
4. Optional: enable WooCommerce and tick the scopes you want (products, orders, coupons), then choose which products the assistant may suggest.

== Frequently Asked Questions ==

= Is this AI chatbot really free? =

Yes. The free plan gives you 100 AI messages a month with no credit card and no time limit. Paid plans raise the allowance and remove the Ruma AI badge.

= Do I need an OpenAI or ChatGPT API key? =

No. Replies are generated by the Ruma AI service using your account's allowance. There is nothing to configure and no separate AI bill.

= Can I train the chatbot on my own website content? =

Yes. Add pages, PDFs or URLs in your Ruma AI dashboard. The chatbot retrieves from that material when answering, so replies stay grounded in your business.

= Does it work with WooCommerce? =

Yes. With WooCommerce active the AI agent gains product search, cart links, order tracking, coupon suggestions and optional cancellations or refunds.

= Can it see my customers' orders? =

Only after the visitor proves the email is theirs with a one-time code, and only orders belonging to that email. The bot cannot browse your order list or read another customer's order.

= Does it work without WooCommerce? =

Yes. On any WordPress site it works as an AI chatbot and live chat for support, lead capture and appointment booking. The store tools appear when WooCommerce is active.

= Will it slow down my site? =

No. The widget is one deferred script and one stylesheet, loaded after your content renders, and the font ships with the plugin so there is no external font request.

= What languages does it support? =

Over 50. It detects the visitor's language automatically and replies in it, including during voice conversations.

== Screenshots ==

1. The AI chatbot answering a product question on a WooCommerce store.
2. Order tracking after the customer verifies their email.
3. Widget appearance settings: theme, colours, position and avatar.
4. WooCommerce scopes and the per-product suggestion controls.
5. The conversations inbox inside WordPress admin.

== Changelog ==

= 3.1.0 =
* Security: capability and nonce checks on every admin action; timing-safe comparison for the CRM secret and order endpoints.
* Privacy: the Inter font now ships with the plugin, so the default setup makes no request to Google Fonts.
* Voice: server-driven barge-in and a better speech threshold.
* All plugin requests now go to rumadesk.com.
* Fix: the 3D avatar gallery failed to load.

= 3.0 =
* Agentic tools, WooCommerce order tracking, voice calling and the conversations inbox.

== Upgrade Notice ==

= 3.1.0 =
Security and privacy release. Admin actions are now permission and nonce checked, and the widget no longer loads Google Fonts by default.
