WhatsApp Notifications Plugin

The WhatsApp Notifications plugin sends real-time order notifications via WhatsApp to you (the store owner) and optionally to your customers. Get notified instantly when a new order comes in or when an order status changes.

What It Does

• Sends a WhatsApp message to you when a new order is placed
• Sends a WhatsApp message to you when an order status changes
• Optionally sends order status updates to customers via WhatsApp
• Uses fully customizable message templates with order variables
• Works through the official WhatsApp Cloud API (Meta Business platform)

Requirements

Before setting up this plugin, you will need:

• A Meta Business account (business.facebook.com)
• A WhatsApp Business phone number registered with Meta
• A permanent access token with whatsapp_business_messaging permission
• Your Phone Number ID from the WhatsApp API Setup page

WARNING

The WhatsApp Cloud API is a business service from Meta and may have its own costs. Check Meta's WhatsApp pricing for details.

Getting Your API Credentials

Access Token

1. Go to Meta Business Suite
2. Navigate to Business Settings > System Users
3. Create a system user (or use an existing one)
4. Click Generate New Token
5. Select the whatsapp_business_messaging permission
6. Copy the generated token

Phone Number ID

1. In Meta Business Suite, go to WhatsApp > API Setup
2. Your Phone Number ID is displayed on this page (it is a numeric ID, not your actual phone number)

Setting Up the Plugin

1. Go to Admin Panel > Plugins
2. Find WhatsApp Notifications and click Enable
3. Click the Settings button
4. Fill in the required fields (see table below)
5. Click Save

Plugin Settings

Setting	What to Enter
Access Token	Your permanent access token from Meta Business Suite
Phone Number ID	Your WhatsApp Business phone number ID from Meta
Admin WhatsApp Number	Your personal WhatsApp number with country code, no + or spaces (e.g., 919876543210 for India)
Notify on New Order	Toggle on to receive a WhatsApp message when a new order is placed
Notify on Status Change	Toggle on to receive a message when an order status changes
Send Customer Notifications	Toggle on to send order updates to customers via WhatsApp
New Order Message (Admin)	The message template sent to you for new orders
Status Change Message (Admin)	The message template sent to you when order status changes
Status Update Message (Customer)	The message template sent to customers for status updates

Message Templates

Each message template supports variables that are automatically replaced with real order data. You can customize the messages to match your brand's tone.

Available Variables

Variable	What It Shows
{order_number}	The order number (e.g., ORD-00042)
{total}	The order total amount
{currency}	The store currency symbol
{customer_name}	The customer's name
{customer_phone}	The customer's phone number
{items_count}	Number of items in the order
{items_list}	Formatted list of all items with quantities and prices
{old_status}	Previous order status (for status change messages)
{new_status}	New order status (for status change messages)
{tracking_id}	Shipment tracking ID (if available)
{tracking_info}	Full tracking info including tracking URL (if available)

Default New Order Template

New Order #{order_number}

Customer: {customer_name}
Phone: {customer_phone}
Items: {items_count}
Total: {currency}{total}

View order in admin panel.

Default Status Change Template (Admin)

Order #{order_number} Updated

Status: {old_status} -> {new_status}
Customer: {customer_name}
Total: {currency}{total}

Default Customer Status Template

Hi {customer_name}! Your order #{order_number} has been updated.

Status: {new_status}
{tracking_info}

Thank you for shopping with us!

TIP

You can edit these templates to match your brand. Just make sure to keep the variable names (the parts in curly braces) exactly as shown -- they are case-sensitive.

Customer Notifications

To send WhatsApp messages to your customers:

1. Enable the Send Customer Notifications toggle in plugin settings
2. Make sure your customers provide a phone number during checkout

The plugin uses the phone number from the customer's account or their shipping address. If no phone number is available, the customer notification is skipped.

WARNING

Customer notifications require an active 24-hour messaging window or approved message templates in your Meta Business account. Messages sent outside the messaging window may not be delivered.

When Notifications Are Sent

Event	Who Gets Notified
New order is placed	Admin (if "Notify on New Order" is enabled)
Order status changes (e.g., Confirmed, Shipped, Delivered)	Admin (if "Notify on Status Change" is enabled) + Customer (if "Send Customer Notifications" is enabled)