Is this article helpful?

We love to hear from you!

Table of Contents

WhatsApp Business API ( BSP)

Wai Ting Yong Updated by Wai Ting Yong

To connect WhatsApp Business API, a Facebook account and Meta Business Manager are required.
WhatsApp logo is now a verified WhatsApp Business Solution Provider (BSP). WhatsApp BSP ( WA BSP) allows you to integrate WhatsApp directly via You’ll no longer need a Facebook Developer Account to set up WhatsApp Cloud API.

Some of the things that you can achieve with WA BSP include:

  • Get the WhatsApp quality rating and verified status for your business number
  • Sync and submit WhatsApp message templates
  • Sync and update your WhatsApp Business Profile
  • Automate processes with’s Workflows automation
  • Integrate Dialogflow to automate conversations
This channel has a limited 24-hour messaging window due to WhatsApp regulations. Learn more about WhatsApp's business policy here.

Connecting WhatsApp Business API

To chat with your customers over WhatsApp Business API, connect a WhatsApp Business Profile and Meta Business Account.

You're required to have an access to Meta Business Manager and a viable Phone Number for WhatsApp. You can create a Meta Business Account or connect to an existing one during the sign up process.

Step 1: Navigate to Channel Settings

From Settings module, navigate to the menu item, Channels.

Step 2: Add Channel

Click Add Channel and choose WhatsApp Business API. Click Next and the Connecting WhatsApp Business API dialog should open up.

Connect your Channel dialog

Step 3: Connect with Facebook

Click the Connect With Facebook button.

Connecting WhatsApp Business API

Step 4: Sign in with a Facebook Account

Sign in using the Facebook account with admin access to the Meta Business Account.

Step 5: Select the WhatsApp Number

In the dropdown list, select the WABA name with the WhatsApp number you would like to connect.

Step 6: Complete the setup at

Click Done to complete the setup.

Once you've completed the setup, any messages sent to your WhatsApp number will now be received in your Workspace.
To scale your business-initiated conversations or request to become and Official Business Account (OBA), you can complete the Business Verification here.

Channel Configuration

WhatsApp Business API channel can be configured with a unique channel name.

Step 1: Navigate to Channel Settings

From Settings module, navigate to the menu item, Channels.

Step 2: Locate the WhatsApp Business API channel

Once you've located the WhatsApp Business API channel, click Configure.

Configure channel

Step 3: Make the necessary configuration

You can configure the following:

  • Channel Name - Name used internally to identify the account.

Step 4: Update the configuration

Click Done to update the channel configuration.

Metadata Received by Channel

Different channels provide different sets of Contact’s metadata to platform. Here's the list of Contact's data you'll be able to obtain from this channel:

  • Phone number
  • Phone number ID
  • Profile name
  • Whatsapp ID

Managing WhatsApp Business API Profile

If there is a need to make a change or check your WhatsApp Business API Profile, it can be done on the platform.

Step 1: Navigate to Channel Settings

From Settings module, navigate to the menu item, Channels.

Step 2: Locate the WhatsApp Business API channel

Once you've located the WhatsApp Business API channel, click Profile.


Step 3: Sync Profile

If the profile hasn't been synced, click Sync Profile to obtain the latest WhatsApp Business Profile information from WhatsApp.

Step 4: Make necessary changes

You may edit the information as needed.



Profile Photo

Image shown as the profile picture of the WhatsApp Business Account.

An image size of 640x640 is recommended.


Address of the business. Maximum of 256 characters.


Description of the business. Maximum of 512 characters.


Email address (in valid email format) to contact the business. Maximum of 128 characters.


Industry of the business. Must be one of these accepted values:

  • Automotive
  • Beauty, Spa and Salon
  • Clothing and Apparel
  • Education
  • Entertainment
  • Event Planning and Service
  • Finance and Banking
  • Food and Grocery
  • Public Service
  • Hotel and Lodging
  • Medical and Health
  • Non-profit
  • Professional Services
  • Shopping and Retail
  • Travel and Transportation
  • Restaurant
  • Other

The business vertical cannot be set back to an empty value after it is created.


URLs (including http:// or https://) associated with the business (e.g., website, Facebook Page, Instagram). Maximum of 2 websites with a maximum of 256 characters each.

Step 5: Save changes

Review the information and click Save when it's ready.

Managing WhatsApp Message Templates

Before sending a message template to a Contact on the platform, ensure you've done the following:
- Submitted the message template for approval
- Added the approved message template to the Workspace by syncing the message template

Submitting Message Templates

Step 1: Navigate to Channel Settings

From Settings module, navigate to the menu item, Channels.

Step 2: Locate the WhatsApp Business API channel

Once you’ve located the WhatsApp Business API channel, click Templates.

Step 3: Submit Template

Click Submit Template to submit a message template for approval.

Submit template

Step 4: Fill in the required information

Fill in the information needed to create a template.



Template Name

The name can only contain lowercase alphanumeric characters and underscores ( _ )


The category to which the message template belongs.


The language that the template is written in.

Step 5: Start creating the message

Create the message by filling in the necessary components, then review the message in the preview section.

Building Block



The Body contains the most important text of your template. Only text is supported.

You may use markdown to format the content of this block.


The Header is optional and serves as the title or header of your template. It supports the following:

  • Text
  • Image
  • Video
  • Document

* platform accepts uploads up to 20MB in size.


The Footer is optional and only supports text. It can be used to provide supplementary information in your message template.


The Button is optional and adds interactivity to your templates. There are two types available:

  • Call To Action Button
    • Used to send your client to a Website or call a Phone Number
    • Maximum one URL and Phone Number per template
    • URL can have a parameter for personalization
  • Quick Reply Button
    • Used to get quick answers from your client
    • Maximum 3 Quick Reply Buttons per template
    • Each Quick Reply button cannot have more than 20 characters

Step 6: Provide sample value

This is only applicable if you have included any parameters in your message template content.

Providing sample values to the parameter in the message template will assist the WhatsApp reviewer to understand the message you are trying to send to your Contacts.
Use Dynamic Variables to fill in the message template parameter.

Important Link

Syncing Message Templates

Step 1: Navigate to Channel Settings

From Settings module, navigate to the menu item, Channels.

Step 2: Locate the WhatsApp Business API channel

Once you've located the WhatsApp Business API channel, click Templates.

Step 3: Sync Templates

Click Sync Templates to begin the syncing process.

Sync Templates

Step 4: Syncing Completed

When the synchronization has been completed, the message templates will be listed with their corresponding statuses and the last synced date time will be updated. The rejection reason will be displayed below the rejected message template.

The following table lists the possible statuses for the message templates:




The message template is submitted and pending approval.


The message template is approved and can be sent to Contacts.


The message template is rejected and cannot be used.

Use the search and filter at the top right corner of the listing to easily find your templates!

FAQ and Troubleshooting

Unable to Receive Read Receipts

When the user connected to WhatsApp Business API changes their Facebook password, the permissions will be outdated and need to be refreshed.

Step 1: To refresh permissions, navigate to Settings module > Channels > locate WhatsApp Business API Messenger channel > click Troubleshoot.


Step 2: Click Refresh Permission to refresh WhatsApp permissions.

Step 3: Send a test message to the WhatsApp phone number and check if you're able to receive the read receipts.

What are the requirements for phone number to be used to sign up for WhatsApp Business API?

  • The phone number used for WhatsApp Business API can’t be used in the WhatsApp personal or business app. You'll have to delete the account on WhatsApp personal or business app before you can use the number to sign up for WhatsApp Business API.
  • You can still use the phone number for other purposes, such as calling and receiving SMS after registering it on the WhatsApp Business Platform.

Is Business Verification needed to start using WhatsApp Business API?

It isn’t mandatory to complete Facebook Business Verification to start sending messages on WhatsApp. Without Business Verification, your business will still be able to:

  • Respond to unlimited user-initiated conversations.
  • Send business-initiated conversations (message templates) to 250 unique customers in a rolling 24-hour period.

Businesses can initiate Business Verification only when they're ready to scale business-initiated conversations or want to become an Official Business Account.

Can I view my conversation insights for my WhatsApp Business Account?

Yes, you can monitor your messaging and spending analytics in real-time for your WhatsApp Business Account in the Insights tab of your Meta WhatsApp Manager. Read more here.

What are WhatsApp messaging limits?

Messaging limits determine the maximum number of business-initiated conversations each phone number can send in a rolling 24-hour period. These limits do not apply to user-initiated conversations. A business-initiated conversation starts when the first message is delivered to a customer and ends 24 hours later. Read more here.

What is WhatsApp Business API pricing?

WhatsApp Business Platform conversations fall into two categories that are priced differently:

  • User-initiated: A conversation that initiates in response to a user message. Whenever a business replies to a user within the 24-hour customer service window, that message will be associated with a user-initiated conversation. Businesses can send free-form messages within this 24-hour customer service window.
  • Business-initiated: A conversation that initiates from a business sending a user a message outside the 24-hour customer service window. Messages that initiate a business-initiated conversation will require a message template.

All conversations are measured in fixed 24-hour sessions. A conversation starts when the first business message in a conversation is delivered, either initiated by the business or in reply to a user message. Businesses and users can exchange any number of messages, including template messages, within a 24-hour conversation session without incurring additional charges. Each 24-hour conversation session results in a single charge.

Charges for conversations are based on the user’s country code. A user here is defined as the customer that your business is communicating with. Rates for business-initiated and user-initiated conversations vary by country or region. Read more here.

Why do I see duplicate Contacts from the same WhatsApp channel?

WhatsApp passes the Contact’s phone number in a format that is different from the E.164 format that uses. This difference causes Contacts from certain countries to be duplicated. Should this occur, do reach out to us here.

Feeling stuck? Do not fear.

Help is here!

Turn-off WhatsApp Number Two-Step Verification

WhatsApp Cloud API

Can't find what you're looking for?

Talk to an expert here!

Contact Us
Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)