WhatsApp Cloud Messaging

Send Woocommerce WhatsApp order notification: Automatically send WhatsApp notifications for WooCommerce orders using the official WhatsApp Cloud APIs using the official WhatsApp Cloud APIs.You can automate WooCommerce WhatsApp order notifications for various statuses, including pending payment, processing, on hold, completed, canceled, refunded, failed, and draft.

Enable two-way messaging with customers : You can send and receive messages via WhatsApp API, allowing for interactive conversations between businesses and customers from wordpress dashboard.

Quick Reply: WC Messaging Pro introduces a quick reply feature, enabling administrators to promptly respond to customer inquiries.

Custom trigger buttons : custom trigger buttons on the WooCommerce order details page, enabling admins to send custom pre-defined message templates to customers with just a click.

Upload the ‘WC Messaging Pro’ folder to the ‘/wp-content/plugins/’ directory.

Activate the plugin through the ‘Plugins’ menu in WordPress.

Go to the plugin settings page and enter your WhatsApp Business API credentials.

Customize your message templates and order status settings according to your preferences.

Start sending automated order status updates to your customers on WhatsApp!

Detailed Docs: https://sevengits.com/docs/wc-messaging-pro/

• Enable two-way messaging with customers: You can send and receive messages via WhatsApp, allowing for interactive conversations between businesses and customers. Using webhook admin receives messages from customers sent through WhatsApp.
• Custom trigger buttons  –  custom trigger buttons on the WooCommerce order details page, enabling admins to send custom pre-defined message templates to customers with just a click.
• Compatibility with WooCommerce Booking Plugins: WooCommerce WhatsApp plugin seamlessly integrates with WooCommerce booking plugins for a comprehensive booking solution
• Quick Reply: WooCommerce WhatsApp plugin introduces a quick reply feature, enabling administrators to promptly respond to customer inquiries.
• Mark as Read: WooCommerce WhatsApp provides administrators with the capability to mark all messages as read, streamlining message management for enhanced efficiency.
• Internal notes: Introduced a quick note feature, allowing you to add and manage notes during chats for improved context and follow-up.
• Adding New contact: You can now add new WhatsApp contacts directly from the chat screen and start conversations seamlessly.
• Customized Widget Tab: Introducing our new Customized Widget Tab for messaging! This tab comes with some exciting new features:
  • Click to Chat: Simply put, we provide you with a link. You can place this link anywhere you like, and customers can click on it to start chatting with your business directly.
  • WhatsApp QR Code: We offer a QR code that, when scanned, connects customers directly to your business chat on WhatsApp. It’s as easy as scanning and chatting!
  • WhatsApp Chat Icon: Simply enable it, and an icon will appear on your site. When clicked, customers can chat directly with your admin. Customize the label, message, and position to your liking.
  • Shortcode: Use the shortcode [woom-chat-widget] to show the WhatsApp chat icon wherever you want on your site.

NOTE: According to Facebook’s guidelines, customers must initiate conversations on Messenger. Admins have up to 24 hours to respond. After this time, admins cannot initiate new chats, but they can send template messages as required. If the customer starts another chat, admins can reply and begin the conversation.

The first thing we need to do is create an app and generate some tokens in Facebook developer. We need to do this so we can link Orderable and WhatsApp together.

This sounds complicated, but we’ll walk you through every step of the way:

1. First, log in to developers.facebook.com.
2. Then click on the My Apps link in the menu at the top of the screen. Then, click the Create App button on the right-hand side.

3. Click the Others menu on the page that appears and then the Next button

4. Click Business on the page that appears and then the Next button.

5. In the next step, enter your app name and email (these are for admin purposes). Then select Business Account. Next, click the Create App button.

6. Enter your Facebook account password in the confirmation popup.

7. The app will then be created and you’ll be asked to select the products you want to add to the app. Scroll down and click the Set up button under WhatsApp.

8. On the next page, select or create a Meta Bussiness account using the dropdown. Then click Continue. 

9. It will redirect you to the Getting Started page. Now you need to add your phone number to the WhatsApp API. This will be the number from which your store’s messages will be sent.

10. Once clicked, you’ll need to enter the details for your WhatsApp account profile.  

11.Enter your phone number and verify it by entering the verification code received.

NOTE: A Facebook API phone number can only be registered in one service at a time; if your number is registered in the WhatsApp Business Cloud API, it cannot be registered in the WhatsApp app. It is not possible to have the phone number registered in the WhatsApp Business API to use anywhere, and do not use it for anything else. Numbers already in use with the WhatsApp Messenger app or WhatsApp Business app cannot be registered unless they are deleted first.

12. Now the WhatsApp app is all set up, copy the Access Token, Phone Number ID, and Business Account ID. We’ll add these into Orderable in the next few steps.

Go to WC Messaging -> settings -> General

• License key: The license key can be obtained from sevengits website
• WhatsApp Access Token: Access token can be obtained from https://developers.facebook.com/apps/   Temporary token is valid only for 23hrs. So, if you require a permanent token create a system user and generate the token. Learn how to create a permanent token
• WhatsApp Number: The provided number matches the one entered in the facebook developer platform.
• Admin notification numbers: These are admin WhatsApp numbers to send notifications. Separate each mobile number by a comma and add the country code.
• Phone number ID and WhatsApp Business Account ID can be got from facebook Developer Platform.
• save all changes

Go to WC Messaging -> settings -> Templates

1. Enable WooCommerce WhatsApp Order Status Notifications by specifying the necessary details and selecting a template name from the dropdown menu. You can customize the template parameters separately for the header and body. Admin can opt to receive notifications for all orders by checking the ‘Sent to Admin‘ checkbox.

When you add new message templates in the Facebook WhatsApp message template section, they will not appear in the select box until you synchronize using Sync now button.

Preview the final template message in the preview section.

If you’re able to create a custom template, you can define suitable parameters for it. Adding a filter hook allows you to create these parameters dynamically. Here’s a demonstration using a sample filter hook placed in the theme’s functions.php file:  

add_filter('woom_additional_template_params', 'function_name', 10, 2);
function function_name($parameters, $order)
{
    $custom_params = array(
        "param1" => '',
        "param2" => ''
    );
    if ($order !== null) {
        $custom_params = array(
            "param1" => 'value1',
            "param2" => 'value2'
        );
    }
    $parameters = array_merge($parameters, $custom_params);
    return $parameters;
}

          With this filter hook, you can dynamically customize the parameters of your template. After placing the code in your theme’s functions.php file, the created parameters will be accessible in your template. To view details about these parameters by hovering over the question mark near the parameter section(right side), ensure that the parameters are properly defined.

For detailed usage of this custom filter check this blog post: Add custom parameters on WC Messaging template’s                                                

2. If you’re setting up WooCommerce Bookings, be sure to turn on Booking notifications.

3. If want more buttons add them and save all the change

Go to WC Messaging settings -> Receive Message

Provide the App Id and App secret key, To find these,

go to your Facebook App Dashboard.
Navigate to App Settings -> Basic.
Here, you will see both your App ID and App Secret Key.
Copy these values and enter them in the required fields.

webhook end URL and webhook verify key is automatically generated in setting page. Finally, save changes.

Webhook URLs link your website to Facebook, letting data move from Facebook to your site. When we add this webhook, we create a direct connection for quick communication between the two platforms. This helps information flow instantly between Facebook and your site.

Go to the Developer app dashboard, Then select WhatsApp, go to the configuration section, click on the Edit menu, and proceed to input the webhook call back URL and Verify token .Then click the Verify and Save button

App secret key serve as credentials for authentication, acting similarly to a combination of a username and password. The App Secret Key helps validate messages from Facebook to your webhook URL, ensuring secure communication for your chats.

Webhook URLs link your website to Facebook, letting data move from Facebook to your site. When we add this webhook, we create a direct connection for quick communication between the two platforms. This helps information flow instantly between Facebook and your site.

To configure custom widget options like Click to Chat or WhatsApp QR Code, navigate to WC Messaging -> Settings -> Widgets. If you want WhatsApp chat icon then enable the chat icon and adjust its label, message, and position according to your preferences. Once done, use the short code [woom-chat-widget] to display the WhatsApp chat icon anywhere on your site. Don’t forget to save your changes to apply them effectively.

NOTE: To use any chat widget options make sure to provide your WhatsApp number WC Messaging settings page.

You already have a plugin that validates phone numbers, there’s no need to enable custom validation. However, if you start receiving a high volume of invalid phone numbers which lead to non delivery of WhatsApp messages, enabling custom validation will help manage and reduce those spam messages.

With WC Messaging Pro, admins can choose to send WhatsApp notifications to billing numbers, shipping numbers, or both. They also have the option to disable WhatsApp notifications altogether.

Admins can choose between two opt-in methods: ‘Show checkbox for customer consent’ or ‘Send messages without customer consent.

With the first option, a checkbox appears on the checkout page for customers to agree to receive WhatsApp notifications. If they don’t tick the box, notifications won’t be sent.

 With the second option, notifications are sent to customers without their explicit consent.

Admin can customize the WhatsApp opt-in checkbox message according to their preference. They have the freedom to write any message they like.

Disclaimer: All trademarks, logos, and brand names mentioned in this plugin are the property of their respective owners. This plugin is not affiliated with or endorsed by WhatsApp or any of its affiliates.