Whatsapp Cloud API

Pre-Requisites

Create Meta Developers account

• While logged into your Facebook account, go to https://developers.facebook.com/async/registration.
• Alternatively, you can go to the https://developers.facebook.com/ and click Get Started.

After completing the verification and accepting terms, you should be able to access facebook developers dashboard: https://developers.facebook.com/apps/?show_reminder=true.

Setting up Whatsapp business account on Meta

Step 1: Create/add your business app on meta developers console

On developer’s console (https://developers.facebook.com/apps ) create an app by clicking on "Create app" button, then select "Other" on the next screen of "What do you want your app to do?"

Select app type - "Business"

Add App name and create app with your personal details

Step 2: Setup Whatsapp Cloud API

Now that your app is created you need to add "Whatsapp" product, scroll down and click "Set up" on Whatsapp. You will be redirected to the WhatsApp get started page, here you can "create a business account" or use an existing one.

Click on "Continue". You'll land on the app dashboard.

Step 3: Send a test message

On the App dashboard, select "API Setup" from the left navigation menu. Here you'll see a temporary access token, Phone number ID and a curl to send the message.

Add your personal phone number in the "to" field to send a test message on your mobile number.

🚧

Test Phone number can't be used in production

The phone_number_id is from a Facebook test phone number which cannot be used in production.

Step 4: Add a valid business phone number

Scroll down to step 5 on the API page. To add your business phone number, Click on "Add phone number" and add your business information to register the number

Add your business phone number. This will be the number from which your business communication will go through. If you are using an existing whatsapp number, refer doc to migrate the business number.

Follow the steps and do not forget to add a payment method to avoid any errors.

Once the phone number is added, copy the Phone number ID and Whatsapp Business Account ID corresponding to this phone number shown in Step 1 of API Setup

Step 5: Generate access token

Because the testing access token only last 24 hours, we need to create a token that can last forever:

1. Create an admin user

• Sign into the Meta Business Suite.
• Locate your business account in the top-left dropdown menu and click its Settings (gear) icon. Click Business settings.
• Select Users -> System users from the left navigation panel

• Add SuprSend user and give it "Employee" access

2. Assigning assets to the new user

1. Select the user and Click on "Assign Assets". Assign Full control to the new user. This will allow us to send messages on the behalf of this user through your whatsapp cloud account.

2. Now, we'll have to assign the system user to our whatsapp account

   To do this from whatsapp settings page go to whatsapp accounts -> select your account. Now on the right panel there will be an option to Assign People, from there assign the System User that we created above to your account. After it's assigned you'll be able to see in People section as shown in the image below.

2. Generate token

Go back to the system users page and select the recently created system user from the list. Then click the Generate new token button. Select your app, token expiry (never), and then on the bottom screen select permissions whatsapp_business_management and whatsapp_business_messaging.

👍

Copy generated token

Click on generate token and copy the token value, please note this value will not be accessible later, so do store it someplace safe.

Step 6: Change App Mode to Live

You have now successfully setup your whatsapp business account. Change the App mode to live to start sending notification to your production users.

Step 7: Get App ID

We will need App ID associated with your whatsapp business account. You can either get it from the developers page as shown in screenshot above, to the left of App Mode.

Alternatively, go to https://developers.facebook.com/apps, here you can see all the apps registered with your meta account. Copy the App ID from the App integrated with SuprSend.

Migrating existing Phone number to Whatsapp Cloud API

If your whatsapp business number is already registered with another BSP and you want to migrate it to whatsapp cloud API, follow this documentation for migration.

Adding Whatsapp cloud configuration on SuprSend App

On the SuprSend dashboard, follow the steps as below:

1. Select Vendors from the left panel
2. Select 'Whatsapp' as the channel from the list
3. Select 'Whatsapp Cloud API' from the list of Vendors. Enter details on vendor settings page

Setting Callback URL for tracking DLR response

One of the platform advantage of using SuprSend as a central communication system is that it shows notification analytics for all channels in your SuprSend account together.

To configure webhook URL, copy the URL from the vendor page and add it on your app dashboard (Whatsapp -> Configuration).

Set verify token as 572bcee9-4558-45ee-bbbb-fac5cb08766d

on webhook fields-> manage button, subscribe to all events mentioned.