Getting Started with Gatemi Chat Button

These docs cover both editions:

  • Gatemi Chat Button — the free edition, coming to wordpress.org.
  • Gatemi Chat Button for WooCommerce — the full edition, sold on gatemi.com.

Anything marked Full edition is only in the paid plugin. Everything else is in both.

The plugin puts a "Chat with us" button on your shop. Pressing it opens WhatsApp — the app on a phone, WhatsApp Web on a desktop — with a message already typed, addressed to your number. The button is an ordinary link to https://wa.me/…. Nothing is loaded from WhatsApp, Meta or anybody else, so the button works before any script has run and a page cache can serve it.

Requirements

Free edition Full edition
WordPress 6.4 or later 6.4 or later
PHP 7.4 or later 7.4 or later
WooCommerce 8.0 or later 8.0 or later
JavaScript on the storefront none one small script, only for the agent panel

Both editions declare compatibility with HPOS (custom order tables) and the Cart & Checkout blocks. Without WooCommerce active, either edition does nothing and says so in a line under its own row on the Plugins screen.

You do not need a WhatsApp Business API account for the chat button. You only need one for the full edition's automatic order updates.

Install

Free edition

The free edition is coming to wordpress.org. When it is listed, install it from Plugins → Add New by searching for "Gatemi Chat Button", then activate it.

Full edition

  1. Sign in to your account on gatemi.com and download the plugin zip.
  2. In WordPress, go to Plugins → Add New → Upload Plugin, choose the zip and press Install Now, then Activate.
  3. Go to WooCommerce → WhatsApp, paste your licence key into License & updates and press Activate. The key switches on one-click updates; the plugin works without it.

If the free edition is also active, it stands down on its own — it shows no button and says on the Plugins screen that the full edition is running. You can deactivate it. Your settings are kept, because both editions use the same stored options.

First setup

  1. Go to WooCommerce → WhatsApp.
  2. Under The chat button, leave Show the chat button ticked, and choose where it goes: Under the add-to-cart button on product pages, Floating, in the corner of every page, or both. Both are on by default.
  3. Under Who answers, type a Name (for example "Sarah") and, optionally, a Job (for example "Sales").
  4. Type the WhatsApp number with its country code — for example +44 7700 900123. Spaces, brackets and a leading + or 00 are fine.
  5. Read the line that appears under the number after you save. It says either "WhatsApp will receive +447700900123" or that the number cannot be used. A number that cannot be used gets no button at all.
  6. Tick the days this person answers and set From and To (24-hour HH:MM, default 09:00–17:00). These are your shop's clock, set in Settings → General → Timezone.
  7. Press Save changes.
The WhatsApp settings screen
The settings screen: the button, the person who answers, and the digits their number becomes.

Full edition: under Who answers press Add another to add more people, each with their own number, job, hours and an optional greeting of their own.

Check it works

  1. Open a product page in a private browser window.
  2. Under the add-to-cart button you should see a button reading the name you typed — "Sarah · Sales" in the example above. If no name is set, it reads "Chat with us" (or your own Button wording).
  3. The same button floats in the bottom-right corner of every page.
  4. Press it. WhatsApp should open on your number with the message "Hi, I have a question about product name — product address".
  5. Outside the hours you set, the button carries a line: "We are away right now — send a message and we will reply when we are back."
The button on a product page and floating in the corner
The button under a product’s add-to-cart, and floating in the corner of the page.

If no button appears, see FAQ and troubleshooting.

Next

  • Settings — every setting, its key and its default.
  • How it works — the number rule, working hours, placeholders and the full edition's order updates.
  • Developer reference — filters, options, order meta and CSS classes.
Shopping Cart
Scroll to Top