WooCommerce Plugin

Overview

Sends a WhatsApp message to the customer when a WooCommerce order becomes processing and again when it is completed, and records an order note for each send. Fully configurable message text.

Requirements

• WordPress 5.0+ with WooCommerce 5.0+
• PHP 7.2+
• An API key and active plan

Download

Get it from Client area → Downloads → WooCommerce Plugin.

Upload / install

Two ways:

1. Admin upload: zip the bookbey-whatsapp folder, then in WordPress go to Plugins → Add New → Upload Plugin, choose the zip, Install Now.
2. FTP: upload the bookbey-whatsapp folder to wp-content/plugins/.

Activation

Go to Plugins in WordPress and click Activate under “BOOKBEY WhatsApp for WooCommerce”. If WooCommerce isn't active you'll see a notice — activate WooCommerce first.

Configuration

Go to WooCommerce → Settings → BOOKBEY WhatsApp and set:

• Enable — turn notifications on
• API key and API base URL (https://bookbey.com/public/api)
• Default country code — e.g. 91; added to local numbers that have none
• On processing / On completed — toggle each, and edit the message text

Message placeholders

Use these in your messages: {name} (customer), {order} (order number), {total} (order total), {site} (store name).

Phone number format

Phone numbers are digits only, in international format without a leading + or spaces — country code followed by the number, e.g. 9198XXXXXXXX for India. Modules that take orders will prefix a configurable default country code to any local number that is missing one.

How it works

On the woocommerce_order_status_processing and woocommerce_order_status_completed hooks the plugin normalises the billing phone, fills your template and calls the API, then adds a note to the order recording success or the error code.

Error handling

Errors are returned as JSON with ok:false, a machine-readable error code and a human message. The HTTP status reflects the error class.

Troubleshooting

• No message sent: confirm “Enable” is on, the order actually reached processing/completed, and the billing phone is present.
• Wrong country / number: set the correct default country code; ensure customers enter numbers you can normalise.
• Order note shows an error code: match it to the table above (usually invalid_api_key or quota_exceeded).
• Settings tab missing: WooCommerce must be active; the tab lives under WooCommerce → Settings.

FAQ

HPOS compatible? It uses order objects via wc_get_order. Can I message on other statuses? The two order hooks are covered; open a ticket if you need more. Does it store keys safely? Keys live in WooCommerce settings; restrict admin access.