The button does not show at all
Check these in order on WooCommerce → WhatsApp:
- Show the chat button is ticked.
- The placement you expect is ticked — Under the add-to-cart button or Floating.
- Under Who answers, the person is switched On.
- The number shows "WhatsApp will receive +…" under it. If it says the number cannot be used, no button is shown — by design.
- Full edition: When nobody is on duty is set to Hide the button and it is outside everybody's hours.
If the floating button shows but the product one does not, your theme may not print WooCommerce's woocommerce_after_add_to_cart_button action — some block themes and page builders replace the add-to-cart form. Use the [gatemi_whatsapp] shortcode where you want it instead.
WhatsApp says the number is not on WhatsApp
Type the number with its country code and without the national leading zero: 447700900123, not 07700900123. The screen shows the digits it became — compare them with the number WhatsApp itself shows in Settings → Profile on the phone.
The button says "We are away" during opening hours
Hours are judged on the timezone in Settings → General → Timezone. If that is UTC and your shop is in another zone, set the city there. Also check the right days are ticked.
The message on a category page reads "a question about —"
The default message uses {product} and {product_url}, which are only filled on product pages. Write a message that also reads well elsewhere — for example "Hi, I have a question about {page_url}" — see How it works.
Does it work with page caching?
Yes. The button is the same link for every visitor, so a cached page is correct. The one thing a cache holds is the away line: it was decided when the page was cached, so a page cached at 16:55 may still say "away" (or not) for as long as your cache keeps it. A short cache lifetime keeps it close.
Does it load anything from WhatsApp or Meta?
No. Nothing is loaded on the storefront from any third party. Full edition: the server contacts graph.facebook.com only to send automatic order updates, and only once you have entered an access token; it contacts gatemi.com only for licensing and updates, and only once a licence key is entered.
Can I put the button somewhere else?
Yes — [gatemi_whatsapp] in any post, page or widget. Full edition: [gatemi_whatsapp agent="sarah"] picks a person by their id (shown in the developer reference).
Does it work with the Cart and Checkout blocks and HPOS?
Yes for the chat button, which does not touch the cart or checkout. Both editions declare HPOS and blocks compatibility, and the full edition's WhatsApp order box shows on both order screens. Full edition: the permission box for automatic updates is on both checkouts — above the pay button on the classic checkout, and in the order information step of the Checkout block (through WooCommerce's own additional-checkout-fields API). Either way it starts unticked, and a tick is recorded on the order with the wording and the time. The Send on WhatsApp link works on every order.
Why will automatic updates not send the text I wrote? — Full edition
WhatsApp refuses free-form text from a business that starts a conversation, and a number that keeps trying gets rate-limited. You need a template approved in your WhatsApp Business account; enter its exact name and language. Your template receives {{1}} shop name, {{2}} order number, {{3}} status.
An update was not sent — Full edition
Open the order and read its notes. The plugin writes one for a missing number and for every refusal, in Meta's own words — for example a template name that does not exist in that language. If there is no note, the order's status is not in Statuses worth a message, the customer did not tick the box, or that status was already sent once (listed as "Already sent" in the WhatsApp box).
Moving from the free edition to the full edition
Install and activate the full edition. The free edition stands down on its own and you can deactivate it. Both use gmwa_settings and gmwa_agents, so your number, hours, message and wording are already there.
Going back the other way, the free edition shows the first person and keeps the rest, your corner, colour and WhatsApp Business credentials stored untouched for when you return.
What does uninstalling remove?
- Free edition: deletes
gmwa_settingsandgmwa_agents— but only if the full edition has never been configured on this site (nogmwa_licenseoption). Otherwise it leaves them. - Full edition: deletes
gmwa_settings,gmwa_agents,gmwa_license, the cached update data and its licence-check cron event. - Neither touches an order. The permission a customer gave, the wording they saw and the record of sent updates stay on the order.
