Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/ashawkat/whatsapp-order-alerts/archive/refs/heads/main.zipWC requires at least: 7.0 WC tested up to: 10.8 License: GPLv3 or later License URI: https://www.gnu.org/licenses/gpl-3.0.html
Notify store admins and customers on WhatsApp when an order is placed or its status changes.
Description
WhatsApp Order Alerts sends WhatsApp messages through the official WhatsApp Cloud API whenever a store order is created or moves to a new status.
Admins can be notified immediately when a customer places an order. Both admins and customers can be notified when an order is processing, completed, cancelled, or moved to a custom status such as Shipped.
This plugin requires WooCommerce to be installed and active.
Key Features
- Admin WhatsApp alert on new orders
- Admin and customer alerts on order status changes
- Works with core statuses and custom statuses (including Shipped)
- Official WhatsApp Cloud API integration
- Session text messages or Meta-approved templates
- Customizable message bodies with order placeholders
- Default country code for local phone numbers
- Asynchronous sending via Action Scheduler so checkout stays fast
- Test message tool and a recent-send log
- Compatible with WooCommerce HPOS (High-Performance Order Storage)
How it works
- Connect your Meta WhatsApp Cloud API phone number ID and access token
- Enter the admin WhatsApp number(s) that should receive alerts
- Choose which events notify the admin and which notify the customer
- Customize the message text, or map approved templates for production use
Customer messages are sent to the billing phone number on the order.
Installation
Install via WordPress Dashboard
- Navigate to Plugins → Add New → Upload Plugin
- Upload the plugin ZIP
- Click Install Now, then Activate
- Go to WooCommerce → WhatsApp Alerts
- Add your Cloud API credentials and admin phone numbers
Install via FTP
- Unzip the package
- Upload the
whatsapp-order-alertsfolder into/wp-content/plugins/ - Activate the plugin from the Plugins menu
- Open WooCommerce → WhatsApp Alerts to configure it
Frequently Asked Questions
Does this plugin work without WooCommerce?
No. WooCommerce must be installed and active.
Do I need Meta-approved templates?
For first contact with a customer, yes. WhatsApp only allows free-form (session) text inside a 24-hour customer-care window. Use Approved template mode for reliable customer notifications.
Will custom statuses like Shipped appear?
Yes. Any status registered with WooCommerce is listed in the notification checkboxes.
Is it compatible with High-Performance Order Storage (HPOS)?
Yes. The plugin declares compatibility with custom order tables.
Where does the customer phone number come from?
The billing phone on the order. Set a default country code if checkout phones are stored without one.
Changelog
1.0.1
- Tests now send the approved order template instead of hello_world / session text on live numbers
- Fixed template sending on PHP 8
- Default template language and variable order match English (US) Utility templates
1.0.0
- Initial release
- New-order WhatsApp alerts for admins (optional for customers)
- Status-change alerts for admins and customers
- WhatsApp Cloud API text and template sending
- Test message tool and send log
- HPOS compatibility declaration
Upgrade Notice
1.0.1
Use Approved template mode with order_placed / order_status_update so live messages actually arrive.
1.0.0
Initial release.