The chat button does not appear
It appears only when Answer customers is on and an API key is set. The top of WooCommerce → AI Support says why the assistant is not live. With Floating button off, the panel appears only where you put [gatemi_ai_support]. Only one panel is printed per page.
"Chat is not available right now"
The assistant was switched off, or the key was removed, after the page was loaded. Check the settings screen.
Every answer is "I don't know"
The index is probably empty. Press Rebuild the index now and check the passage count. Make sure Index products is on and Also index names your post types (page for delivery and returns pages). Add answers that are not on any page to Anything else it should know.
Will it make things up about my products?
It is built not to: it answers from your index, prices and stock are rendered by WooCommerce, and it is told to say it does not know rather than guess. No language model can be guaranteed never to err, so read a few conversations on the Conversations tab after launch — the ones marked unhelpful first.
The price it quotes is wrong
Prices are read live with WooCommerce's own formatting, so a wrong price means WooCommerce shows that price — check the product, any sale schedule and any pricing plugin. The assistant is told never to add prices up or convert currencies; the checkout shows totals.
How much does it cost?
It depends on your model and how much customers chat. The plugin shows an estimated cost per conversation and per day, from the token counts OpenAI reports; your OpenAI invoice is the authority. Stop spending after (default 5.00 per day) and Model calls per day (default 500) cap a day.
Can it look up a customer's order?
Free edition: no. It says it cannot see orders and offers a ticket. Full edition: yes, with verification — see How it works.
Does it work with page caching?
Yes. The widget carries no nonce; it asks for a session when it opens. The REST routes under /wp-json/gatemi-ai/v1/ must not be cached — most cache plugins never cache REST responses.
Customers behind a CDN all hit the rate limit
Limits are per visitor address, taken from REMOTE_ADDR. Behind a proxy or CDN, every visitor can look like the CDN. Use the gmai_client_ip filter to return the real client address from your CDN's header.
The ticket email did not arrive
Tickets are sent with wp_mail() to Send tickets to (or the site admin email). Check your mail log or SMTP plugin. The ticket is saved under WooCommerce → Support tickets either way.
A customer refreshed the page — is their chat lost?
No. The session lives in the browser tab, and the panel fetches the earlier messages back. Closing the tab ends it.
Does the browser talk to OpenAI?
No. The widget talks only to your site's REST route; your server calls OpenAI with your key, which never reaches the browser.
Does it work with HPOS and the Checkout block?
The assistant does not touch the cart or checkout. Full edition: order lookups go through WooCommerce's order API, so HPOS and legacy storage both work.
I am moving from the free edition to the full edition
Install and activate the full edition. Both use the same option, tables, ticket post type, meta keys, reference format and REST namespace, so settings, the index, every conversation and every ticket carry over. The free edition stands down while the full one is active.
What happens when I uninstall?
By default, nothing is deleted: tickets are open promises to customers. With Delete everything at uninstall ticked, deleting the plugin removes every ticket and its replies, the four tables, the settings and index options, its transients and its cron events.
The free edition never deletes anything once the full edition has been licensed on the site, whatever the box says.
Which external services does it use?
OpenAI (api.openai.com), from your server, only once a key is set and the assistant is switched on. Full edition: gatemi.com for licence checks and updates once a licence key is entered, and ipinfo.io only if you switch on Record visitor IP address and location.
