About this plugin
Ratmil AI Shop Assistant adds a chat window to your site. ” 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. 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.
com/policies/terms-of-use
com/policies/privacy-policy
Google Gemini API (when selected as provider)
* Sent: the same data as above.
dev/gemini-api/terms
com/privacy
Cloudflare Turnstile (optional; used only when the CAPTCHA is enabled and keys are entered)
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.
com/website-terms/
com/privacypolicy/
WhatsApp (optional; only when you enter a number under Human hand-off)
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.
com/legal/terms-of-service
com/legal/privacy-policy
Please inform your visitors, in your privacy policy, that their chat messages are processed by the selected provider.