WordPress integration

Business Messaging for WbizTool is the official WordPress plugin. It sends WhatsApp messages from your connected number when something happens on your site: a WooCommerce order changes, a WP Amelia booking is rescheduled or cancelled, or a Contact Form 7 form is submitted.

Before you start#

• A Wbiztool account with a connected WhatsApp number on WhatsApp settings.
• Your Client ID and API key from Settings → API keys.
• The WhatsApp Client ID of the number to send from, shown on WhatsApp settings.

Install the plugin#

1. Install from WordPress

   In your WordPress admin, go to Plugins → Add New, search for Business Messaging for WbizTool, click Install Now and then Activate. You can also download it from the WordPress plugin directory and upload the zip under Plugins → Add New → Upload Plugin. If the upload fails (for example because of a file size limit), unzip it and copy the business-messaging-for-wbiztool folder into /wp-content/plugins/ over FTP, then activate it under Plugins.

2. Open the plugin settings

   A new WbizTool menu appears in the admin sidebar with four pages: Settings, Templates, Test Messages and Logs.

Set up the plugin#

1. Enter your API credentials

   On WbizTool → Settings, under API Configuration, fill in Client ID, API Key and WhatsApp Client ID, then click Test Connection.

   With correct credentials, Test Connection queues a real test message to the placeholder number 10000000000, so it appears in your Wbiztool message history. It can't be delivered and shows as failed there; you can ignore it. If you see Unable to connect to WbizTool API. Please check your internet connection., your Client ID, API key or WhatsApp Client ID is most likely wrong, or your plan has no messages left. It rarely means a problem with your internet connection.

2. Set the general options

   Under General Settings:

   • Default Country Code: used when a WooCommerce order's billing country can't be matched to a calling code. The default is 1, so change it to your main country, for example 91.
   • Test Mode: when on, messages are written to the log but not sent.
   • Admin Notifications: this checkbox has no visible effect in version 1.0.3, because the settings page has no field for the admin phone number it uses. For admin alerts on form submissions, use the Contact Form 7 settings below.

3. Turn on integrations and events

   Under Integration Settings, enable each plugin you use and tick the events that should send a message. An integration only shows its options when that plugin is active on your site. Click Save Settings.

4. Edit the message templates

   On WbizTool → Templates, pick the WooCommerce, Amelia or Contact Form 7 tab, choose an event, and edit its text. The page lists the variables you can use and shows a live preview. Reset restores the default text.

5. Send a test

   On WbizTool → Test Messages, send a message to your own number to confirm everything works, then check WbizTool → Logs.

WooCommerce#

Messages go to the order's billing phone. The country code comes from the billing country; if that country isn't recognised, the Default Country Code is used.

Template variables:

Example template:

Hi {customer_first_name},

Thank you for your order #{order_number}.
Total: {order_total}

Track your order: {order_url}

{store_name}

WP Amelia#

Messages go to the customer phone on the booking. The settings page lists six events:

• Booking Added (Frontend bookings)
• Booking Rescheduled
• Booking Cancelled
• Appointment Added (Backend)
• Event Booking Saved
• Event Booking Updated

Variables available in Amelia templates:

Contact Form 7#

When a form is submitted, the plugin can message you (the admin), the person who filled in the form, or both.

The plugin finds the name, email, phone and message in your form by field name. Use common names such as your-name, your-email, your-phone (or phone, mobile, whatsapp), your-subject and your-message. The customer auto-reply only goes out when a phone field is found. Ask for the number with its country code: the plugin recognises only some country codes and uses the Default Country Code otherwise.

Template variables:

Every form field is also available by its own name, with hyphens replaced by underscores. For example, a field named your-city is {your_city}.

Example admin notification:

New enquiry from {contact_name} ({contact_phone}) on {form_title}:
{message}

Line breaks in the visitor's message are removed, so {message} arrives as one line.

Logs#

WbizTool → Logs lists the messages the plugin tried to send, with the date, event type, integration, phone, message and status. Use it to check whether an event fired and whether the message was sent. It doesn't show why a message failed.

Troubleshooting#

To see PHP errors from the plugin, turn on WordPress debug logging in wp-config.php. Errors are written to wp-content/debug.log. Turn it off again when you're done.

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);