---
updatedAt: 2025-11-13T23:01:10.000Z
agentTools:
  projectIndex: https://docs.botsonic.com/llms.txt
---

# Whatsapp Integration

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

<HTMLBlock>{`
<iframe width="560" height="315" src="https://www.youtube.com/embed/XZe7Dq2sVnw?si=Zojo11cnMnxOrS1d" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
`}</HTMLBlock>

<br />

# 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](https://developers.facebook.com/)

   <br />

   <Image align="center" className="border" border={true} src="https://files.readme.io/ae11c33-image.png" />

<br />

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

   <Image align="center" className="border" border={true} src="https://files.readme.io/4024301-3598945-image.png" />

<br />

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

   <Image align="center" className="border" border={true} src="https://files.readme.io/98f9535-image.png" />

<br />

4. Add the following details:
   * App Name
   * App Contact Email

<Image align="center" className="border" width="94% " border={true} src="https://files.readme.io/9ced9db-image.png" />

<br />

5. Search for \[Whatsapp] then click \[Set up]

   ![](https://files.readme.io/aca9aab-image.png)

<br />

6. 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]

   <br />

   <Image align="center" className="border" border={true} src="https://files.readme.io/1ccb048-image.png" />

<br />

7. 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.**

   <br />

   <Image align="center" className="border" border={true} src="https://files.readme.io/2074460-image.png" />

<br />

<Callout icon="👉" theme="default">
  ### To create a permanent token, click [Configuration] on the left hand side menu under the WhatsApp section then follow the same steps above.

  <Image align="center" className="border" border={true} src="https://files.readme.io/d6911b9-image.png" />
</Callout>

<br />

<br />

# Step 2 - Connect & Install

1. Navigate to your Botsonic Dashboard by clicking on \[Home] from the left hand side menu. Then click and open the Bot you want to connect. *If you haven't created a Bot yet, read this[Quick Start Guide](https://docs.botsonic.com/docs/quick-start).*

   <Image align="center" className="border" border={true} src="https://files.readme.io/34e7b27-Your_Bots.png" />

<br />

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

   <Image align="center" className="border" border={true} src="https://files.readme.io/1b8a673-image.png" />

<br />

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

   ![](https://files.readme.io/945ef85-image.png)

   <br />
4. Go to \[Installed apps], then click \[Setup Now] on the \[Whatsapp] integration box

   * Paste the Whatsapp access token
   * Click SAVE

     <br />

     <Image align="center" className="border" border={true} src="https://files.readme.io/3578886-image.png" />

<br />

<Image align="center" width="70% " src="https://files.readme.io/c1d47c9-image.png" />

<br />

5. 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

     <Image align="center" width="70% " src="https://files.readme.io/5a2f7ca-image.png" />
   * 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]

     <br />

     <Image align="center" className="border" border={true} src="https://files.readme.io/58932c5-image.png" />

     <br />

     <Image align="center" width="80% " src="https://files.readme.io/f50a4b2-image.png" />

     <br />
6. On the \[Configuration] tab

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

   <br />

   ![](https://files.readme.io/c7085ac-image.png)

   <br />

   ![](https://files.readme.io/af066f8-image.png)

<br />

<br />

# 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](https://developers.facebook.com/apps), 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

<Image align="center" className="border" border={true} src="https://files.readme.io/7a98e5a-image.png" />

<br />

<Callout icon="👉" theme="default">
  ### 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].

  <Image align="center" src="https://files.readme.io/027c139-a36bcf9-image.png" />

  <HTMLBlock>{`
  <br>
  `}</HTMLBlock>

  **You should receive a message like this**:

  <Image align="center" width="30% " src="https://files.readme.io/8b382fb-viber_image_2024-04-19_16-55-03-173.jpg" />
</Callout>

<br />

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

   * Go to <https://business.facebook.com/wa/manage>
   * Click the \[settings icon], then select \[Whatsapp Manager]

     <Image align="center" className="border" width="80% " border={true} src="https://files.readme.io/6b21b8d-image.png" />

   <br />

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

     <Image align="center" className="border" border={true} src="https://files.readme.io/3e19b51-image.png" />

     <br />

## Whatsapp Profile

Update your WhatsApp profile. On the Phone numbers page:

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

   <Image align="center" className="border" border={true} src="https://files.readme.io/f3559ff-image.png" />

<br />

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

   <Image align="center" className="border" border={true} src="https://files.readme.io/b466d0b-image.png" />

<br />

<Callout icon="👉" theme="default">
  ### 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.

  <Image align="center" width="50% " src="https://files.readme.io/a15f60f-image.png" />
</Callout>

<br />

<Callout icon="👉" theme="default">
  ### If you want to receive payments, go to the WhatApp Manager the refer to the [Payment configurations] tab on the left hand side menu

  <Image align="center" width="80% " src="https://files.readme.io/acddf69-image.png" />
</Callout>

<br />

## Business Info

On the [Meta for Developers page](https://developers.facebook.com/apps), 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

<Image align="center" className="border" border={true} src="https://files.readme.io/373e8b7-image.png" />

<br />

<Callout icon="👉" theme="default">
  ### To check your business verification status

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

  <Image align="center" width="80% " src="https://files.readme.io/31bfc7e-505ad85-image.png" />

  <HTMLBlock>{`
  <br>
  <br>
  `}</HTMLBlock>

  Click [Business info] from the left hand side menu

  <Image align="center" src="https://files.readme.io/52e1d0f-167f2a0-image.png" />

  <HTMLBlock>{`

  `}</HTMLBlock>
</Callout>

<br />

## Payment Info

On the [Meta for Developers page](https://developers.facebook.com/apps), 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]

<Image align="center" className="border" border={true} src="https://files.readme.io/247f188-image.png" />

<br />

<br />

# 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/>*

<Image align="center" className="border" border={true} src="https://files.readme.io/319937c-image.png" />

<br />

## 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

     <Image align="center" className="border" border={true} src="https://files.readme.io/cd61ccd-image.png" />

     <br />

2. **Select Permissions and Features.**

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

     <Image align="center" className="border" width="40% " border={true} src="https://files.readme.io/30ad1b1-image.png" />

   <br />

   * Click the \[Request Advanced Access] button for **whatsapp\_business\_messaging**

     ![](https://files.readme.io/4945bfb-image.png)

     <br />

3. **Edit, Review, and Submit the Request**

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

     <Image align="center" className="border" border={true} src="https://files.readme.io/2160849-image.png" />

     <br />
   * Read and follow the guidelines provided

     ![](https://files.readme.io/3e4f5b9-image.png)

     <br />

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

<br />

<br />

# 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.

   <Image align="center" className="border" border={true} src="https://files.readme.io/c35db66-image.png" />

<br />

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

   <Image align="center" width="80% " src="https://files.readme.io/6909a56-image.png" />