Ratmil AI Shop Assistant

Ratmil AI Shop Assistant adds a chat window to your site. Visitors can ask things like “Do you have a waterproof blue backpack under $50?” and the bot looks up your posts, pages and WooCommerce products and answers from them.

• Choose OpenAI or Google Gemini, enter your own API key and pick one of the supported models.
• Searches your site content and WooCommerce products (including attributes, prices and stock) through function calling.
• Optional semantic search using embeddings, stored in your own database, so questions match by meaning and across languages.
• Open the chat from anywhere: the floating button, a [ratmil_chat_button] shortcode, any element with the wpbot-open class, or a link to #wpbot-open.
• Optional but recommended CAPTCHA (Cloudflare Turnstile) for anonymous visitors, so scripts cannot use your chat and your API credits.
• Per-IP rate limiting, a daily request cap, opening hours and a logged-in-only mode, customizable bot name, welcome message, instructions, color and position.
• Optional hand-off to a person on WhatsApp: a link in the chat, offered by the assistant when a visitor asks for a person, and shown automatically when the assistant cannot answer (closed, limit reached, AI error).
• Review the questions visitors ask and the answers they get (Ratmil AI Assistant > Conversations), with automatic deletion after a retention period you choose.
• Translation-ready; the default texts follow the site language.

You need your own API key from OpenAI or Google AI Studio. Keys can also be defined in wp-config.php with WPBOT_OPENAI_KEY / WPBOT_GEMINI_KEY.

External services

This plugin sends data to a third-party AI service chosen by the site administrator. Nothing is sent until an API key is configured.

OpenAI (when selected as provider)
* Sent: the visitor’s chat messages, the conversation so far, the results of site searches (titles, excerpts, prices, URLs of your content) and, if semantic search is enabled, the text of your published posts/products to create embeddings.
* Terms: https://openai.com/policies/terms-of-use
* Privacy: https://openai.com/policies/privacy-policy

Google Gemini API (when selected as provider)
* Sent: the same data as above.
* Terms: https://ai.google.dev/gemini-api/terms
* Privacy: https://policies.google.com/privacy

Cloudflare Turnstile (optional; used only when the CAPTCHA is enabled and keys are entered)
* When an anonymous visitor asks their first question, the Turnstile script is loaded from challenges.cloudflare.com and the visitor’s browser exchanges challenge data with Cloudflare. Your server then sends the challenge response, your secret key and the visitor’s IP address to Cloudflare to verify it.
* Terms: https://www.cloudflare.com/website-terms/
* Privacy: https://www.cloudflare.com/privacypolicy/

WhatsApp (optional; only when you enter a number under Human hand-off)
* The chat shows a link to https://wa.me/ with your number and the visitor’s last question pre-filled. Nothing is sent to WhatsApp unless the visitor clicks the link and sends the message there.
* Terms: https://www.whatsapp.com/legal/terms-of-service
* Privacy: https://www.whatsapp.com/legal/privacy-policy

Please inform your visitors, in your privacy policy, that their chat messages are processed by the selected provider.