Prerequisites

Configure your Facebook Developer App

Follow the Set up Developer Assets and Platform Access step in Whatsapp Cloud API Guide to create your Facebook Developer app with Whatsapp Product enabled.

Once you finish this step, you can now configure your required phone numbers in the Whatsapp section of your Facebook developer app. If you complete the steps successfully, you should be able to obtain the Phone Number Id and Whatsapp Bussiness Account ID as shown in the below screenshot. OneChat will require these values for creating the Whatsapp Inbox.

Configure a system user for your Facebook Bussiness Manager

Create a system user in your business manager with access to the Whatsapp App. Generate an access token for the user, which will be required for setting up an inbox in OneChat.

When generating the access token, make sure whatsapp_business_management, and whatsapp_business_messaging permissions are selected.

Step 1 of 3: Create a system user.
Create a system user in the System Users tab of Business Manager.

Step 2 of 3: Add the system user.

Under the WhatsApp Accounts tab, select Add People and select the system user to grant access to the WhatsApp Business account.



Step 3 of 3: Generate the access token and request permissions.

Configuring Whatsapp Inbox in OneChat

Finish the following steps to configure Whatsapp Cloud API Channel in OneChat.

Open your OneChat dashboard. Go to Settings → Inboxes → Add Inbox.



Choose "WhatsApp" amongst the options of channels.



Choose "WhatsApp Cloud" as the API provider. Fill in the appropriate details

Values	Description
Name	Choose a name for your Inbox. Ex: Your Business Name
Phone Number	Fill in the phone number you have configured in Facebook Developer App
Phone Number ID	The phone number ID for the number as obtained in prerequisites
Bussiness Account ID	The Business Account ID for the number as obtained in prerequisites
API Key	The Business Account User API key for the number as obtained in prerequisites
Webhook Verify Token	This token is required while configuring Webhook in Facebook Developer App. Fill in a secure alphanumeric string that you wish

Finish the steps to obtain your Whatsapp Webhook Callback URL

Final Steps

Configure Webhook in Facebook Developer App

Head back to the Whatsapp section in Facebook Developer App. Navigate to the Configuration subsection and set up the Callback URL

The value for the url should be the same URL you obtained at the end of your OneChat inbox creation and will look like https://app.onechat.is/webhooks/whatsapp/+{phone_number}.
The value for the verify token should be the same value you configured for the Webhook Verify Token during inbox creation

You should also subscribe to message fields events under Webhooks Fields on your Facebook Developer app. Once you finish all the steps, the section should look like the below screenshot.

FAQ

How to configure multiple numbers under a single Facebook app?

Facebook App allows configuring only a single Webhook endpoint. So create Inboxes in OneChat for all the numbers as required. You will need to configure the Webhook url provided for only one of these inboxes in the Facebook app for all the other inboxes to work.

Updated on: 21/03/2023