How to configure WhatsApp Cloud in OneHash Chat?
OneHash Chat supports the official WhatsApp Business API. You can connect the phone number and start managing your WhatsApp customer queries from OneHash Chat. Follow the steps given below to enable your WhatsApp inbox with WhatsApp Cloud API.
First, you need to create your Facebook Developer app, with WhatsApp Product enabled. Go to the WhatsApp Cloud API Guide and navigate to section called Set up Developer Assets and Platform Access and follow the steps.
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. OneHash will require these values for creating the WhatsApp Inbox.
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 as the API key for setting up an inbox in OneHash Chat.
When generating the access token, make sure the whatsapp_business_management, and whatsapp_business_messaging permissions are selected.
Step 1. Create a system user in the System Users tab of Business Manager.
Step 2. 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. Generate the access token and request permissions.
Refer this video for detailed steps.
Finish the following steps to configure Whatsapp Cloud API Channel in OneHash Chat.
Open your OneHash Chat 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
Finish the steps to obtain your WhatsApp Webhook Callback URL
Head back to the WhatsApp section in the 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 OneHash Chat inbox creation and will look like https://chat.onehash.ai/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 following screenshot.
Facebook App allows configuring only a single Webhook endpoint. So create Inboxes in OneHash Chat 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.
Your freshly configured WhatsApp inbox should now appear in your list of inboxes. To see this and to make additional settings in your WhatsApp inbox, go to Settings → Inboxes → click the gear icon on the associated WhatsApp inbox.
All the Additional Settings available are the same as those in Add inbox in OneHash Chat. We recommend going through this link to understand the same.
Prerequisites
1. Configure your Facebook Developer App
First, you need to create your Facebook Developer app, with WhatsApp Product enabled. Go to the WhatsApp Cloud API Guide and navigate to section called Set up Developer Assets and Platform Access and follow the steps.
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. OneHash will require these values for creating the WhatsApp Inbox.
2. Configure a system user for your Facebook Business 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 as the API key for setting up an inbox in OneHash Chat.
When generating the access token, make sure the whatsapp_business_management, and whatsapp_business_messaging permissions are selected.
Step 1. Create a system user in the System Users tab of Business Manager.
Step 2. 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. Generate the access token and request permissions.
Refer this video for detailed steps.
Configuring Whatsapp Inbox in OneHash Chat
Finish the following steps to configure Whatsapp Cloud API Channel in OneHash Chat.
Open your OneHash Chat 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
Finish the steps to obtain your WhatsApp Webhook Callback URL
Enable the webhook
Configure Webhook in Facebook Developer App
Head back to the WhatsApp section in the 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 OneHash Chat inbox creation and will look like https://chat.onehash.ai/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 following 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 OneHash Chat 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.
Additional Inbox settings
Your freshly configured WhatsApp inbox should now appear in your list of inboxes. To see this and to make additional settings in your WhatsApp inbox, go to Settings → Inboxes → click the gear icon on the associated WhatsApp inbox.
All the Additional Settings available are the same as those in Add inbox in OneHash Chat. We recommend going through this link to understand the same.
Supported media types
Updated on: 11/10/2023
Thank you!