Dashboard

!!! [IMPORTANT DISCLAIMER] DO NOT SKIP WITHOUT READING !!!

Please read and accept the following 3 points before you start using this plugin.

1. PHONE NUMBER WILL RESTRICTION

This plugin uses WhatsApp's official Cloud API to send notifications from your WordPress backend. In order to use the API, you need to register your phone number with them to be able to send notifications.

Once the phone number is setup in their app to use with this plugin, you will not be able to use the number on the WhastApp Business mobile app.

If you want to use your phone number that you were earlier using on the WhatsApp phone app, WhatsApp requires you to delete that account from phone (along with it's message history) to be able to use it via the API.

If you're using a different number that's not used in the mobile app or if you're okay to delete the phone app account, you can proceed with using this plugin.

2. ONE-WAY COMMUNICATION ONLY

Note that this plugin currently allows only one-way communication, that is, you can only send notifications on WhatsApp but can not receive / read replies.

If you want to use your phone number for two-way communication with your customers, we suggest using their mobile app. But if you're okay with the one-way communication restriction, you can proceed with using this plugin.

Note that we have plans to introduce full-fledged WhatsApp inbox system with this plugin that'll allow you two-way communication from WordPress dashbaord. But that'll take time to launch so be thoughtful about the phone number that you use with this plugin.

3. METERED BILLING BY WHATSAPP

Notifications you send from the app are metered by WhatsApp. First 1000 messages per month are free to send but you're charged for the messages you send post that. The billing is handled by WhatsApp on their site and not by this plugin.

If you understand and accept these points, click on button below to get started.

Back to Dashboard

Let's Configure The Plugin!

Follow the steps below to configure the plugin to start sending WhatsApp notifications. Estimated time: 8 to 10 minutes.

Step 1: Create Meta account and an app for WhastApp Cloud API
  1. Create a free Meta developer account, if you don't already have one.
  2. Login to the Meta developer portal and click on Create App button to create a new app.
  3. On this page, select the Business option and click on the Next button at the bottom.
  4. On the next Provide basic information page, fill in the details and click on Create App when done.
  5. This will redirect you to app page where you need to Add products to your app. Scroll to the bottom to find "WhatsApp" product and click Set up.
  6. Next, you will see the option to select an existing Business Manager (if you have one) or, if you would like, the onboarding process will create one automatically for you (you can customize your business later, if needed). Make a selection and click Continue.
  7. You will be redirected to the Get Started page.
Step 2: Setup your phone number in WhastApp Cloud API
  1. Scroll down on the Get Started screen and click on Add phone number button.
  2. Fill in your business information and click Next.
  3. On the next screen, you'll be prompted to create a WhatsApp Business profile. Enter the details and click Next.
  4. Next, you'll need to add your phone number. Enter your phone number and select a verification method to verify the number.
  5. Enter the verfication code and click Next.
  6. Once the phone number is added, scroll up on the Get Started page and select your added number from the dropdown under Send and receive messages.
  7. After selecting your phone number the Phone number ID and WhatsApp Business Account ID values will get updated below it. Copy those values and add them on the Settings page.
  8. Do not save the page, just keep it open. We'll add Permanent Access Token in the next step.
Step 3: Configure webhook and permanent token

In this step, we'll setup the Webhook and Permanent Token.

Webhook:
  1. From the Get Started screen's left sidebar, click on Whatsapp > Configuration link.
  2. Click on the Edit button. That'll open a popup.
  3. Enter the following in the Callback URL field: . Note that if you have any kind of firewall set on your website the verification will fail.
  4. In the Verify Token field enter: and click Verify.
  5. Under Webhook fields: click on Manage.
  6. Click on Subscribe button in front of all fields and then click on Done.
Permanent Token:
  1. Click here to open Business Settings for your Business Manager account and select your account.
  2. Under Users in left sidebar, click on System users. Click on Add to add a new user.
  3. Click on I Accept button if you see non-discrimation policy popup.
  4. Enter a name for your System user name (you can keep it admin or system, this will not be shown to your users). Select System user role as Administrator and click on Create system user.
  5. Click on Add Assets button. Under Select asset type click on Apps, select your app from Select assets column and then enable Full control > Manage App. Click on Save Changes.
  6. Now click on Generate Token button. Select your app from the dropdown and click on Generate Token. From the list of permissions under Available Permissions: select whatsapp_business_messaging and whatsapp_business_management and then click on Generate Token.
  7. Copy the Access token. Open this plugin's Settings page, add it in the Permanent Access Token field and save.
Step 4: Validate and complete

After you've completed the steps above and added the WhastApp Phone Number ID, WhastApp Business Account ID and the Permanent Access Token, click on the link below to validate.

Once you click the button below, the plugin will connect to your account via Cloud API to validate the details. Once validated, it'll create draft Message Templates for you to start sending notifications.

Phone Number:
Display Name:
Status:
Qaulity Rating:
'wa_message_template', 'post_status' => 'publish', 'numberposts' => 5, ) ); $message_templates_count = count($message_templates); $contacts = get_posts( array ( 'post_type' => 'wa_contact', 'post_status' => 'publish', 'numberposts' => 5, ) ); $contacts_count = count($contacts); $notifications = get_posts( array ( 'post_type' => 'wa_notification', 'post_status' => 'publish', 'numberposts' => 5, ) ); $notifications_count = count($notifications); ?>

You're all set! Here are the next steps...

STEP 1 - Create your first Message Template.

STEP 2 - Add / import Contacts.

STEP 3 - Create and send your first Notification.

0) : ?>

Message Templates

ID, NOTIFIER_PREFIX . 'status', true); $status_text = ($status) ? '' . esc_html($status) . '' : '-'; echo ''; } ?>
Name Status
' . esc_html($template->post_title) . '' . wp_kses_post($status_text) . '
View All
0) : ?>

Contacts

ID, NOTIFIER_PREFIX . 'first_name', true); $last_name = get_post_meta( $contact->ID, NOTIFIER_PREFIX . 'last_name', true); $wa_number = get_post_meta( $contact->ID, NOTIFIER_PREFIX . 'wa_number', true); echo ''; } ?>
First Name Last Name Number
' . esc_html($first_name) . '' . esc_html($last_name) . '' . esc_html($wa_number) . '
View All
0) : ?>

Notifications

ID, NOTIFIER_PREFIX . 'notification_status', true); $sent = get_post_meta( $notification->ID, NOTIFIER_PREFIX . 'notification_sent_contact_ids', true); $sent_count = ($sent && is_array($sent)) ? count($sent) : '0'; $unsent = get_post_meta( $notification->ID, NOTIFIER_PREFIX . 'notification_unsent_contact_ids', true); $unsent_count = ($unsent && is_array($unsent)) ? count($unsent) : '0'; echo ''; echo ''; echo ''; echo ''; echo ''; } ?>
Name Status Stats
' . esc_html($notification->post_title) . '' . esc_html($status) . 'Sent: ' . esc_html($sent_count) . ' / Failed: ' . esc_html($unsent_count) . '
View All