Whatsapp Integration

This integration allows your Bot to respond and answer queries sent through the Whatsapp app.

Step 1- Create an App and Generate a Token from the Meta for Business Suite

  1. Visit https://developers.facebook.com/apps

    • Click the [Create App] button
    • NOTE: You need to register yourself as a Meta Developer, if you haven't done this yet, read this step by step guide to Register as a Meta Developer

  1. What do you want your app to do? Select [Other], then click [Next]

  1. Select an app type. Select [Business], then click [Next]

  1. Add the following details:
    • App Name
    • App Contact Email

  1. Search for [Whatsapp] then click [Set up]

  1. Select your Meta Business Account.

    • Click the [Quickstart] tab under the Whatsapp section on the left hand side menu
    • Then select a Meta Business Account, then click [Continue]

  1. Copy the Temporary Access Token

    • Click the [API Setup] tab under the Whatsapp section on the left hand side menu
    • Copy the API access token (you will need it on the next steps). This token is specific to connected phone number.
    • NOTE: Save the token somewhere where you can copy it, if it gets lost, you'll need to create a new one.


To create a permanent token, click [Configuration] on the left hand side menu under the WhatsApp section then follow the same steps above.

Step 2 - Connect & Install

  1. Go to your "Your Bots" Page and click on a bot. If you haven't created a Bot yet, read this Quick Start Guide.

  1. Click [Integrations] from the left hand side menu, then click [Apps]

  1. Look for the [Whatsapp] integration. Click [Connect], then click [Install]

  2. Go to [Installed apps], then click [Setup Now] on the [Whatsapp] integration box

    • Paste the Whatsapp access token

    • Click SAVE

  1. Copy the URL and Token (from Botsonic) and paste it into the Whatsapp settings page in your Meta Suite account

    • Copy the URL and Token from your Botsonic account

    • Go to the Whatsapp settings in your Meta Suite account

      • Click [Configuration] from the left hand side menu
      • Click [Edit] on the Webhook section
      • Paste the Botsonic URL into the [Callback URL] field
      • Paste the Botsonic Token into the [Verify Token] field
      • Click [Verify and Save]

  2. On the [Configuration] tab

    • Click [Manage] from the Webhook section
    • Check the [Messages] box
    • Click [Done]

Step 3 - Go through the set up checklist

Go through the following and make sure it's been setup correctly

Phone Number

  1. On the Meta for Developers page, make sure you have 1 production number and 1 test number. To set this up:
    • Click [Configuration] from the left hand side menu under the Whatsapp section
    • Click [Manage phone numbers] on the Phone number section


To send a test message, click [API Setup] under the Whatsapp section. Select a "from" test number and a "to" number, then click [Send message].

You should receive a message like this:

  1. Confirm that the phone you've added has a "connected" status

    • Select [Phone numbers] from the left hand side menu. Your phone number you've added should be listed with a "Connected" status

Whatsapp Profile

Update your WhatsApp profile. On the Phone numbers page:

  1. Click the [settings icon] of the phone number you've added

  1. Then select [Profile] from the left hand side menu


Official business account is not mandatory, but if you want to get searched on Whatsapp, you'll have to submit a request to verify your business.


If you want to receive payments, go to the WhatApp Manager the refer to the [Payment configurations] tab on the left hand side menu

Business Info

On the Meta for Developers page, make sure your business information has been verified, to do this:

  • Click [Basic] under the App settings on the left hand side menu
  • Proceed with the Business verification process
  • Then continue with the Access verification process


To check your business verification status

Go to https://business.facebook.com/settings/info, click the [settings icon] then select [Business Settings]

Click [Business info] from the left hand side menu

Payment Info

On the Meta for Developers page, make sure your payment information has been added, to set this up:

  • Click [API Setup] under the WhatsApp settings on the left hand side menu
  • Click [Add payment method]

Step 4 - Submit Whatsapp App for Review

  1. Go to your Whatsapp settings page > App Review > Requests
  2. Click [Request Permissions or Features]
  3. Select and submit request/s for advanced access for required features. For more information, read this guide https://developers.facebook.com/docs/whatsapp/embedded-signup/app-review/

Guidelines for Submitting the App for Review

  1. Update the App's Basic Settings. Click [Basic] from the [App settings] section on the left hand side menu and update the following:

    • App Icon - upload an icon for your app

    • Privacy Policy URL - create and paste the URL of your privacy policy page

    • Category - select "Messenger bots for business

  2. Select Permissions and Features.

    • Click [Permissions and Features] from the [App Review] section.

    • Click the [Request Advanced Access] button for whatsapp_business_messaging

  3. Edit, Review, and Submit the Request

    • Click [Requests] from the [App Review] section, then click the [Edit] button in the [Current Requests] section

    • Read and follow the guidelines provided

  4. Click [Submit for Review] NOTE: You can only proceed to test the integration once the review has been approved.

Step 5 - Test the integration

NOTE: Make sure the Bot is trained with an uploaded file or FAQ that answers the question/message that you're posting

  1. Change the app mode to Live. Toggle switch can be found on the top bar ofyour Whatsapp settings page.

  1. Engage with the Bot by sending a Whatsapp message to the test or production phone number.