Close mobile menu
HomeProgrammable SMSProgrammable VoiceText To SpeechVerifyConversationsBetaNumbersBetaLookupMMSHLRReportingBetaBalanceContactsGroups

Getting Started with WhatsApp

In this WhatsApp Business Solution Quickstart, we'll explain the step-by-step onboarding process for the WhatsApp Business solution API.

Step 1: Submit an Early Access Request

Submit a request on the MessageBird WhatsApp Business solution webpage.

MessageBird will evaluate your application, and if you qualify for early access, we will reach out accordingly.

Step 2: Set up a Facebook Business Manager Account

Next, MessageBird needs your Facebook Business ID for your WhatsApp account.

If you don’t have a FaceBook Business ID, you need to first set up a Facebook Manager Account by logging in or signing up on

Step 3: Share your Business Manager Account ID with MessageBird

Now, your Facebook Business ID is required to connect your business account with the WhatsApp Product.

The MessageBird Customer Support team will coordinate these steps with you.

After that, you'll receive a notification in your Facebook Business account where you can accept access to the MessageBird WhatsApp platform.

Step 4: Choose a number for WhatsApp

Next, MessageBird needs to connect the phone number which you'll be using for WhatsApp.

This number will be the customer-facing number to which customers can send inbound messages and from where you can send outbound messages to customers.

This phone number can be a Virtual Mobile Number (VMN) which we can provide (check available destinations or you have the option to use one of your current numbers; this can either be mobile or a landline. Don't hesitate to contact us if you have any doubts regarding VMNs.

Notification icon

When you use your own number, it should be a clean number, that is, a number which has not been associated with WhatsApp before. For more info, please read this Help Center article.

Step 5: Verify your number with WhatsApp

Once you have selected the number(s) you would like to use, the next step is to verify the number(s) with WhatsApp. MessageBird will add a business name to the number(s) which will be the name displayed in WhatsApp. MessageBird will do the number verification. To do so, please provide us with the number and the associated business name when requested.

Step 6: Number verified

Once your number is verified, we will send your Number VNAME certificate. You'll need this when connecting your account to the MessageBird Dashboard.

Step 7: Registering a Message Template

To start communicating with your customers, you first need a pre-approved message.

This Message Template needs to be approved by WhatsApp.

Please send MessageBird the Message Template you would like to register. We will submit these for review by WhatsApp.

Once your Message Template has been approved it can not be edited anymore; yet, you can submit new HSM’s for approval at any time.

Step 8: Connect WhatsApp to your MessageBird account

Now it’s time to connect your number with your MessageBird account.

In the MessageBird Dashboard, you'll have been granted access to the Channels directory where you will now have the option to 'Add Channel' and select 'WhatsApp'.

Please complete the following three steps:

  1. Add your Business Name: This is the same name provided during your number registration.
  2. Add your Business Number
  3. Paste or upload your VNAME certificate associated with this number.
  4. Click 'Install Now'.

Step 9: Install your WhatsApp channel

MessageBird will now install the channel.

You'll be forwarded to your channel's overview and will see that your channel is currently 'pending'.

This stage can take up to 10 minutes.

Please refresh the page to see if the channel has been installed.

Notification icon

If the status 'Pending' is displayed for longer than 30 minutes please contact MessageBird Support.

Step 10: Activate your WhatsApp channel

When you refresh the page, and your channel has been installed get the option to 'Activate Channel'. MessageBird will now need to verify the number on our side; if you are using a MessageBird VMN, please open a new window to view your incoming verification token, this code will be sent to the MessageBird Dashboard under your ‘Received messages’.

Step 11: WhatsApp has now been installed 🎉

Once the number has been verified, you are all set to start using our WhatsApp Business. Connect your CRM with our Programmable Conversations API to get the full use of our options!

Next steps

You may now want to check out these resources:


We’re always happy to help with code or other questions you might have! Check out our API Reference, Developer tutorials or contact support.

Cookie Settings