| 1 |
=== WANotifier for Forms and Actions === |
| 2 |
Contributors: wanotifier |
| 3 |
Donate link: https://wanotifier.com |
| 4 |
Tags: whatsapp, whatsapp notification, whatsapp api, whatsapp chat, whatsapp integration |
| 5 |
Requires at least: 6.8 |
| 6 |
Tested up to: 6.9 |
| 7 |
Stable tag: 3.2.0 |
| 8 |
Requires PHP: 7.4 |
| 9 |
License: GPLv2 or later |
| 10 |
License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 11 |
|
| 12 |
Send WhatsApp notifications from Contact Form 7, Gravity Forms, WPForms, and 6 more form plugins using WhatsApp Business API |
| 13 |
|
| 14 |
== Description == |
| 15 |
**WhatsApp API integration plugin for WordPress** to send WhatsApp notifications for... |
| 16 |
|
| 17 |
* form submission confirmations |
| 18 |
* new post or page published events |
| 19 |
* new user registrations |
| 20 |
* new comments |
| 21 |
* and much more |
| 22 |
|
| 23 |
...using the official [WhatsApp Business API](https://wanotifier.com/whatsapp-business-api/). |
| 24 |
|
| 25 |
Not just that, **add WhatsApp chat button** to your website with integrated [WhatsApp chatbot](https://wanotifier.com/whatsapp-chatbot/) to automatically answer all your user queries instantly! |
| 26 |
|
| 27 |
**NOTE: This plugin requires you to have a [WANotifier](https://wanotifier.com/) account to setup WhatsApp API and do the integration. [Click here](https://app.wanotifier.com/create-account/) to create your FREE account.** |
| 28 |
|
| 29 |
**Looking for WooCommerce integration?** |
| 30 |
|
| 31 |
Install our [WANotifier for WooCommerce](https://wordpress.org/plugins/order-notifications-for-woocommerce/) plugin. |
| 32 |
|
| 33 |
Here's everything that you can do with this plugin... |
| 34 |
|
| 35 |
== Send WhatsApp Notifications from WordPress Plugins == |
| 36 |
|
| 37 |
Send WhatsApp notification for... |
| 38 |
|
| 39 |
* Form submissions in [Contact Form 7](https://wordpress.org/plugins/contact-form-7/). |
| 40 |
* Form submissions in [Gravity Forms](https://www.gravityforms.com/). |
| 41 |
* Form submissions in [WPForms](https://wordpress.org/plugins/wpforms-lite/). |
| 42 |
* Form submissions in [Ninja Forms](https://wordpress.org/plugins/ninja-forms/). |
| 43 |
* Form submissions in [Formidable Forms](https://wordpress.org/plugins/formidable/). |
| 44 |
* Form submissions in [Fluent Forms](https://wordpress.org/plugins/fluentform/). |
| 45 |
* Form submissions in [SureForms](https://wordpress.org/plugins/sureforms/). |
| 46 |
* Form submissions in [Forminator Forms](https://wordpress.org/plugins/forminator/). |
| 47 |
* Form submissions in [WS Form](https://wordpress.org/plugins/ws-form/). |
| 48 |
|
| 49 |
== Send WhatsApp Notifications for WordPress Events == |
| 50 |
|
| 51 |
* Send notification when a **new post or page is published** |
| 52 |
* Send notification when a post of any **custom post type is published** |
| 53 |
* Send notification when a **new comment is added** |
| 54 |
* Send notification when a **new user is registered** |
| 55 |
|
| 56 |
We keep adding more integrations with new plugin updates. If you want integration with your favorite plugins, you can request us [here](https://wanotifier.com/support/) or you can contact your developer to create custom triggers using the filter hooks we provide. |
| 57 |
|
| 58 |
== Add WhatsApp Chat Button with Chatbot Integration == |
| 59 |
|
| 60 |
Add WhatsApp chat button to your website to allow your visitors to directly interact with you. |
| 61 |
|
| 62 |
https://youtu.be/JHbgpnT2eX0 |
| 63 |
|
| 64 |
Boost your engagement with integrating the button with our **WhatsApp chatbot** or other automations to respond to user queries on autopilot 24/7. |
| 65 |
|
| 66 |
👉 [Learn how to create a WhatsApp chatbot](https://wanotifier.com/create-whatsapp-chatbot/) |
| 67 |
|
| 68 |
== About WANotifier == |
| 69 |
|
| 70 |
WANotifier is an all-in-one WhatsApp marketing and automation SaaS tool that let's businesses do end-to-end lifecycle marketing on WhatsApp using the official [WhatsApp Business API](https://developers.facebook.com/docs/whatsapp/cloud-api/overview). |
| 71 |
|
| 72 |
We're one of the leading Meta Tech Partners. Our tool let's businesses: |
| 73 |
|
| 74 |
* Send targeted WhatsApp marketing campaigns to thousands of opted-in contacts on WhatsApp |
| 75 |
* Trigger transactional messages from your website or apps in response to user actions like purchases, form submissions, or callback requests |
| 76 |
* Capture leads from Facebook and Instagram ads and add them to your contact lists (learn more about it here) |
| 77 |
* Set up chatbots and auto replies to manage FAQs, qualify leads, and provide 24/7 customer support |
| 78 |
* Set up drip sequences to onboard new users, nurture leads, and re-engage inactive customers |
| 79 |
* Use WhatsApp Flows to collect user data directly within chat |
| 80 |
* Integrate your CRM, e-commerce platform, and other third-party tools with WhatsApp |
| 81 |
* Track message delivery and open rates, chatbot sessions, Flow responses, and ad-driven conversions |
| 82 |
* Collaborate with your team on chats using a shared team inbox (invite team members, assign chats, and view entire conversation history) |
| 83 |
|
| 84 |
And much more! |
| 85 |
|
| 86 |
**Note: WhatsApp Business API is paid API.** |
| 87 |
|
| 88 |
Meta charges you a small fees per conversation as [shown here](https://developers.facebook.com/docs/whatsapp/pricing/) that you need to settle with them directly on their portal. |
| 89 |
|
| 90 |
If you're looking for a **cost friendly and robust** solution for sending WhatsApp broadcasts or messages, this tool is for you! |
| 91 |
|
| 92 |
**You can learn more about WANotifier using the following links:** |
| 93 |
|
| 94 |
* [Visit website](https://wanotifier.com/) |
| 95 |
* [Pricing](https://wanotifier.com/pricing/) |
| 96 |
* [Create your FREE account](https://app.wanotifier.com/create-account/?utm_campaign=woo-plugin) |
| 97 |
|
| 98 |
**Trademark Notice:** "WANotifier" is a registered trademark of WANotifier Inc. This plugin is developed and maintained by WANotifier Inc. |
| 99 |
|
| 100 |
== Installation == |
| 101 |
|
| 102 |
1. Download the plugin zip, upload it to the `/wp-content/plugins/` directory and unzip. Or install the plugin via 'Plugins' page in your WordPress backend. |
| 103 |
2. Activate the plugin through the 'Plugins' page. |
| 104 |
3. Go to **WANotifier** page from your WordPress admin menu. |
| 105 |
4. Follow the instructions on the screen to connect with WANotifier and complete your setup. |
| 106 |
|
| 107 |
== Frequently Asked Questions == |
| 108 |
|
| 109 |
= Do I need a WANotifier account to use this plugin? = |
| 110 |
|
| 111 |
Yes. This plugin connects your WordPress site to your [WANotifier](https://wanotifier.com/) account, which handles WhatsApp message delivery via the official WhatsApp Business API. You can [create a free account here](https://app.wanotifier.com/create-account/). |
| 112 |
|
| 113 |
= Does this plugin use the official WhatsApp API? = |
| 114 |
|
| 115 |
Yes. All messages are sent through the official WhatsApp Business API via WANotifier. No unofficial methods or browser extensions are used. |
| 116 |
|
| 117 |
= Is WhatsApp API free? = |
| 118 |
|
| 119 |
WhatsApp charges a small per-conversation fee billed directly by Meta. WANotifier does not add any markup on top of WhatsApp's pricing. See [WhatsApp's pricing page](https://developers.facebook.com/docs/whatsapp/pricing/) for details. |
| 120 |
|
| 121 |
= Which form plugins are supported? = |
| 122 |
|
| 123 |
Contact Form 7, Gravity Forms, WPForms, Ninja Forms, Formidable Forms, Fluent Forms, SureForms, Forminator Forms and WS Form. |
| 124 |
|
| 125 |
= What about WooCommerce integration? = |
| 126 |
|
| 127 |
WooCommerce integration has been moved to a standalone plugin: [Order & Abandoned Cart Notifications for WooCommerce](https://wordpress.org/plugins/order-notifications-for-woocommerce/). |
| 128 |
|
| 129 |
== Screenshots == |
| 130 |
|
| 131 |
1. Grid of available integrations whose respective plugins are active |
| 132 |
2. Connect your integration with WANotifier in one click |
| 133 |
3. Configure / disconnect integrations and re-sync triggers |
| 134 |
4. Integration specific configuration page |
| 135 |
5. Configure the WhatsApp Chat Button with live preview |
| 136 |
6. Manage plugin General settings |
| 137 |
7. Activity log to monitor notification delivery |
| 138 |
|
| 139 |
== Changelog == |
| 140 |
= 3.2.0 - 2026-10-05 = |
| 141 |
* new: chat button position settings - choose a screen corner and the distance from the edges, with an optional separate position for mobile phones |
| 142 |
* new: chat button display rules - control where the button appears with display and exclusion rules covering the entire website, all singulars or archives, special pages (front, blog, 404, search, date and author), every post type and taxonomy archive including custom post types, WooCommerce pages, and specific pages, posts, products or terms picked by search |
| 143 |
* new: show or hide the chat button on desktop, tablet and mobile |
| 144 |
* update: chat button preview stays in view while scrolling and can switch between desktop and mobile |
| 145 |
* update: admin form controls, buttons and checkboxes use a consistent height and brand colour; settings screens adapt better to phones |
| 146 |
* fix: WhatsApp number is now required when the chat button is enabled, and is validated in the settings form |
| 147 |
* fix: admin screens recover automatically when the REST security nonce expires, and show a clear message when the login session has ended |
| 148 |
* mod: WooCommerce plugin name updated in the Integrations screen |
| 149 |
|
| 150 |
= 3.1.1 - 2026-09-16 = |
| 151 |
* fix: send the site's own REST API URL when connecting, so sites without pretty permalinks (where the REST API lives under /index.php/wp-json/) can complete setup |
| 152 |
|
| 153 |
= 3.1.0 - 2026-09-03 = |
| 154 |
* update: upgraded bundled Action Scheduler from 3.5.4 to 4.1.0 |
| 155 |
* update: minimum required WordPress version raised to 6.8, as required by Action Scheduler 4.x |
| 156 |
|
| 157 |
= 3.0.4 - 2026-07-21 = |
| 158 |
* update: renamed plugin to "WANotifier for Forms and Actions" |
| 159 |
|
| 160 |
= 3.0.3 - 2026-05-18 = |
| 161 |
* fix: added phonefield support in CF7 recipient fields detection |
| 162 |
* add: "Disable background processing" setting under General to fire triggers in real time instead of queueing them |
| 163 |
|
| 164 |
= 3.0.2 - 2026-03-19 = |
| 165 |
* fix: WS Form integration query now uses single-quoted SQL string to ensure compatibility across all MySQL server configurations |
| 166 |
* fix: exclude submit fields from WS Form merge tags |
| 167 |
|
| 168 |
= 3.0.1 - 2026-03-19 = |
| 169 |
* fix: prevent duplicate trigger actions from being scheduled for the same event |
| 170 |
|
| 171 |
= 3.0.0 - 2026-03-02 = |
| 172 |
* mod: complete UI overhaul with new React-based admin interface |
| 173 |
* mod: migration system to migrate your old triggers to v3 |
| 174 |
* mod: WooCommerce integration moved to standalone plugin (Order & Abandoned Cart Notifications for WooCommerce) |
| 175 |
* add: WordPress triggers config page with custom meta field selection |
| 176 |
* add: WhatsApp Chat Button live preview |
| 177 |
|
| 178 |
= 2.7.13 - 2026-02-06 = |
| 179 |
fix: broken access control vulnerability in AJAX handlers |
| 180 |
|
| 181 |
= 2.7.12 - 2025-11-05 = |
| 182 |
fix: PHP warning for undefined array key in Fluent Forms field processing |
| 183 |
|
| 184 |
= 2.7.11 - 2025-10-09 = |
| 185 |
add: new slug field for post triggers |
| 186 |
|
| 187 |
= 2.7.10 - 2025-07-04 = |
| 188 |
fix: duplicate cart abandonment notifications |
| 189 |
add: added session_key field to cart (new) abandonment trigger |
| 190 |
add: improved API key validation to prevent errors when using invalid keys |
| 191 |
|
| 192 |
= 2.7.9 - 2025-06-30 = |
| 193 |
fix: resolved issue with incorrectly prefixed country codes in WooCommerce |
| 194 |
|
| 195 |
= 2.7.8 - 2025-06-26 = |
| 196 |
fix: 'isHidden' undefined error in Gravity Forms integration |
| 197 |
mod: renamed Click-to-chat feature to WhatsApp Chat buttons |
| 198 |
mod: renamed plugin name |
| 199 |
mod: README.txt file |
| 200 |
|
| 201 |
= 2.7.7 - 2025-06-04 = |
| 202 |
mod: Tested upto version bump and README.txt file update |
| 203 |
mod: minor UI updates |
| 204 |
|
| 205 |
= 2.7.6 - 2025-05-26 = |
| 206 |
add: added order item fields – name, price, total of the first product |
| 207 |
mod: moved Woocommerce settings to Woocommerce tab |
| 208 |
add: meta box on Woocommerce order page to toggle WhatsApp updates opt-in |
| 209 |
|
| 210 |
= 2.7.5 - 2025-04-03 = |
| 211 |
mod: renamed plugin from WANotifier to Notifier to comply with WordPress policies |
| 212 |
|
| 213 |
= 2.7.4 - 2025-03-27 = |
| 214 |
fix: FATAL error when Woocommerce is not installed |
| 215 |
|
| 216 |
= 2.7.3 - 2025-02-12 = |
| 217 |
fix: FATAL error related to WC order meta and checkout and cart related bugs |
| 218 |
|
| 219 |
= 2.7.2 - 2025-02-10 = |
| 220 |
fix: FATAL error related to WC session unset |
| 221 |
|
| 222 |
= 2.7.1 - 2025-02-10 = |
| 223 |
fix: phone number country code issue in abandoned cart trigger |
| 224 |
|
| 225 |
= 2.7.0 - 2025-01-28 = |
| 226 |
add: Inbuilt abandoned cart integration without need of any 3rd party plugin |
| 227 |
fix: Bug caused on activating hidden meta fields setting |
| 228 |
|
| 229 |
= 2.6.3 - 2024-09-30 = |
| 230 |
* add: HPOS compatibility for getting WooCommerce order meta fields |
| 231 |
|
| 232 |
= 2.6.2 - 2024-08-29 = |
| 233 |
* fix: Display name |
| 234 |
|
| 235 |
= 2.6.1 - 2024-07-04 = |
| 236 |
* fix: vulnerability fixes |
| 237 |
* wp supported version bump to v6.6 |
| 238 |
|
| 239 |
= 2.6 - 2024-07-01 = |
| 240 |
* fix: vulnerability fixes |
| 241 |
|
| 242 |
= 2.5.4 - 2024-05-14 = |
| 243 |
* fix: Warning on installing plugin. |
| 244 |
|
| 245 |
= 2.5.3 - 2024-04-08 = |
| 246 |
* fix: Minor warnings. |
| 247 |
|
| 248 |
= 2.5.2 - 2024-04-03 = |
| 249 |
* add: Activity logs for debugging. |
| 250 |
|
| 251 |
= 2.5.1 - 2024-03-08 = |
| 252 |
* add: Option to add opt-in checkbox on WooCommerce checkout page. |
| 253 |
* add: HPOS support for WooCommerce |
| 254 |
|
| 255 |
= 2.5.0 - 2024-01-05 = |
| 256 |
* add: Tools page with option to export WooCommerce customers to CSV to import in WANotifier. |
| 257 |
|
| 258 |
= 2.4.6 - 2023-11-03 = |
| 259 |
* fix: error log warnings |
| 260 |
|
| 261 |
= 2.4.5 - 2023-11-01 = |
| 262 |
* mod: some info text updates |
| 263 |
|
| 264 |
= 2.4.4 - 2023-08-08 = |
| 265 |
* fix: Product list not sending in New Order Trigger |
| 266 |
|
| 267 |
= 2.4.3 - 2023-06-21 = |
| 268 |
* fix: Woocommerce Cart Abandoned Recovery plugin not triggering notifications |
| 269 |
|
| 270 |
= 2.4.2 - 2023-06-13 = |
| 271 |
* add: option to select whether to trigger in real time or asynchonously using Action Scheduler |
| 272 |
* fix: minor bug fixes |
| 273 |
|
| 274 |
= 2.4.1 - 2023-06-01 = |
| 275 |
* fix: Fluent Forms and Ninja Forms triggers getting triggered for all form subsmissions |
| 276 |
|
| 277 |
= 2.4.0 - 2023-05-25 = |
| 278 |
* add: Woocommerce Cart Abandoned Recovery plugin integration |
| 279 |
|
| 280 |
= 2.3.0 - 2023-05-04 = |
| 281 |
* add: default country code for recipient fields. |
| 282 |
* add: option to enable hidden custom meta keys that start with underscore. |
| 283 |
* mod: changed custom meta data fields type so it's available to map in both body and header. |
| 284 |
* fix: country code not getting added to billing and shipping phone numbers for US numbers in WooCommerce. |
| 285 |
* fix: woocommerce custom meta key not saving issue. |
| 286 |
|
| 287 |
= 2.2.4 - 2023-05-03 = |
| 288 |
* fix: Some minor typo fixes |
| 289 |
|
| 290 |
= 2.2.3 - 2023-04-24 = |
| 291 |
* add: WooCommerce order meta and customer user meta data fields and recipient fields |
| 292 |
* add: new data field for Order payment URL |
| 293 |
* add: few style fixes |
| 294 |
|
| 295 |
= 2.2.2 - 2023-04-19 = |
| 296 |
* add: new trigger - new order placed with COD payment method |
| 297 |
* add: added trigger description to the Trigger dropdown |
| 298 |
* add: custom fields support in Recipient Fields (experimental) |
| 299 |
|
| 300 |
= 2.2.1 - 2023-04-17 = |
| 301 |
* add: further speed boost - optimized code for fewer db queries |
| 302 |
|
| 303 |
= 2.2.0 - 2023-04-13 = |
| 304 |
* fix: made triggers more unique with site key |
| 305 |
* add: UI and content updates |
| 306 |
* add: replaced direct firing of actions with action scheduler to drastically improve performance |
| 307 |
* add: custom meta fields for post types |
| 308 |
* mod: changed WooCommerce new order hook from woocommerce_thankyou to woocommerce_new_order |
| 309 |
|
| 310 |
= 2.1.3 - 2023-03-09 = |
| 311 |
* fix: Contact Form 7 error in logs |
| 312 |
|
| 313 |
= 2.1.2 - 2023-02-28 = |
| 314 |
* fix: Contact Form 7 forms not visible |
| 315 |
* fix: tel* fields not showing in Recipient Fields for Contact Form 7 |
| 316 |
|
| 317 |
= 2.1.1 - 2023-02-13 = |
| 318 |
* fix: Order product items field was sending empty data |
| 319 |
|
| 320 |
= 2.1.0 - 2023-02-03 = |
| 321 |
* add: Click to chat feature |
| 322 |
* add: support for custom post types |
| 323 |
* add: product names field for WooCommerce |
| 324 |
|
| 325 |
= 2.0.10 - 2023-01-29 = |
| 326 |
* fix: error on saving triggers |
| 327 |
|
| 328 |
= 2.0.9 - 2023-01-26 = |
| 329 |
* Updated onboarding instructions & added testimonials |
| 330 |
|
| 331 |
= 2.0.8 - 2023-01-25 = |
| 332 |
* Added Fluent Forms integration |
| 333 |
|
| 334 |
= 2.0.7 - 2023-01-18 = |
| 335 |
* Added Formidable Forms integration |
| 336 |
|
| 337 |
= 2.0.6 - 2023-01-13 = |
| 338 |
* Added Ninja Forms integration |
| 339 |
|
| 340 |
= 2.0.5 - 2023-01-12 = |
| 341 |
* Fix: Recipient fields related bug in WPForms integration |
| 342 |
|
| 343 |
= 2.0.4 - 2023-01-11 = |
| 344 |
* Added WPForms integration |
| 345 |
|
| 346 |
= 2.0.3 - 2023-01-06 = |
| 347 |
* Fix: Added missing WordPress fields to Contact Form 7 |
| 348 |
|
| 349 |
= 2.0.2 - 2023-01-04 = |
| 350 |
* Fix: Trigger sync message showing on deletiong of triggers |
| 351 |
* Fix: Few typos |
| 352 |
|
| 353 |
= 2.0.1 - 2022-12-30 = |
| 354 |
* Fix: Woocommerce new order notification not sending |
| 355 |
|
| 356 |
= 2.0.0 - 2022-12-30 = |
| 357 |
* Major upgrade with new way to manage triggers |
| 358 |
* Added ability to use custom Woocommerce order statuses. |
| 359 |
* Send WhatsApp notifications on Gravity Forms form submission. |
| 360 |
* Send WhatsApp notifications on Contact Form 7 form submission. |
| 361 |
|
| 362 |
= 1.0.5 - 2022-12-26 = |
| 363 |
* New: Improved on-boarding and How to? instructions |
| 364 |
|
| 365 |
= 1.0.4 - 2022-11-10 = |
| 366 |
* New: api enpoint upgrade |
| 367 |
|
| 368 |
= 1.0.3 - 2022-11-08 = |
| 369 |
* Fix: checkout not happening error |
| 370 |
|
| 371 |
= 1.0.2 - 2022-10-28 = |
| 372 |
* Fix: firing multiple notifications at the same time |
| 373 |
|
| 374 |
= 1.0.1 - 2022-10-27 = |
| 375 |
* Tested upto WP 6.1 |
| 376 |
|
| 377 |
= 1.0.0 - 2022-10-09 = |
| 378 |
* Converted the plugin to provide integration with WANotifier.com |
| 379 |
|
| 380 |
= 0.1.1 - 2022-08-04 = |
| 381 |
* Fix - Minor bug fixes and code cleanup |
| 382 |
|
| 383 |
= 0.1.0 - 2022-07-30 = |
| 384 |
* Launch of the beta version of the plugin. |
| 385 |
|
