Sangoma CX Technical Note - WhatsApp Support
Setup your WhatsApp channel with WhatsApp Cloud API
Sangoma CX supports the official WhatsApp Business API. You can connect the phone number and start managing your WhatsApp customer queries from the Sangoma CX Agent Panel. Follow the steps below to enable your WhatsApp inbox with WhatsApp Cloud API.
Prerequisites
Sangoma CX Tier
This feature is part of the omnichannel capabilities only available in the Sangoma CX Premium Tier. You can review the tier enabled in your tenant by clicking the name associated with the logged user in the upper right corner on the Sangoma CX portal.
If you want to upgrade your current tier to enable this capability, please get in contact with your Sangoma Partner or a Sangoma Sales Representative.
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 follow the instructructions including Step 3.
Once you finish this step, you have at least a phone number in the “WhatsApp'' section of your Facebook developer app. If you completed the steps successfully, you should be able to obtain the “Phone Number ID” and “Whatsapp Business Account ID” as shown in the below screenshot. Sangoma CX will require these values for creating the WhatsApp Inbox.
Please note the phone numbers provided by Facebook at this time are for testing purposes only. To add a real business number you will need to follow the instructions in step 5 in the WhatsApp Cloud API Guide
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 Sangoma CX.
When generating the access token, make sure the “whatsapp_business_management”, and “whatsapp_business_messaging permissions” are selected.
Create a system user in the System Users tab of Business Manager.
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.
Generate the access token and request permissions.
Refer to this video for detailed steps.
Setup WhatsApp Inbox in Sangoma CX
Login in the Sangoma CX portal with a user that has privileges to create inboxes and click in the menu: Contact Center > Management > Digital Channels > Inboxes. The following screen will be displayed.
Click the “CREATE INBOX” button and select WhatsApp
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 |
Business Account ID | The Business Account ID for the number as obtained in prerequisites |
API Key | The Business Account User's access token for the number as obtained in prerequisites |
This information is available in the WhatsApp > API Setup Screen App you previously created in https://developers.facebook.com/apps/.
Click on the “CREATE” button. A window will pop-up providing the following information: “Webhook Verify Token” and “Whatsapp Webhook Callback URL”. Copy this information before closing this window. This information is required by Facebook Developer App to make this integration work.
The WhatsApp Inbox won't be ready until configuring the “Webhook Verify Token” and “Whatsapp Webhook Callback URL” in Facebook Developer App is completed. Please review the section “Enable the webhook” that details how to configure the settings.
Enable the webhook
To configure the webhook in Facebook Developer App follow these steps
Head back to the “WhatsApp” section in the Facebook Developer App. Navigate to the “Configuration” subsection and click “Edit” button set up the “Callback URL” and “Verify Token”
Paste the Callback URL and Verified token provided by Sangoma CX when creating the WhatsApp Inbox and click the “Verify and save” button.
The application must subscribe to message fields events under Webhooks Fields on your Facebook Developer App. To configure the setting, click the “Manage” button.
Scroll down and enable the subscribe checkbox for “Messages” and click the “Done” button.
Once you finish all the steps, the configuration screen should look like the following.
Additional Inbox settings
Your freshly configured WhatsApp inbox should now appear in your list of inboxes. The Inbox Contact Information column will display the WhatsApp Phone number.
The following changes can be done when editing this inbox:
Under the General tab:
Name: Inbox name
Greeting Message: First message provided to the customer when initiating a conversation with this inbox.
Under Agents tab:
Provides the ability to assign and unassign agents to the inbox. Alternatively Agents can be assigned or unassigned to queues and inboxes through the Agent editing screens.
Please note, editing the Inbox won’t allow changing the WhatsApp integration settings. If these need to change you will need to create a new WhatsApp inbox.
Supported media types
Supported extensions | End User | Agent Panel |
Audio |
|
|
audio/aac | Supported | Supported |
audio/mp4 | Supported | Supported |
audio/mpeg | Supported | Supported |
audio/amr | Supported | Supported |
audio/ogg | Supported | Supported |
Document |
|
|
text/plain | Supported | Supported |
application/pdf | Supported | Supported |
application/vnd.ms-powerpoint | Supported | Supported |
application/msword | Supported | Supported |
application/vnd.ms-excel | Supported | Supported |
application/vnd.openxmlformats-officedocument.wordprocessingml.document | Supported | Supported |
application/vnd.openxmlformats-officedocument.presentationml.presentation | Supported | Supported |
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet | Supported | Supported |
Image |
|
|
image/jpeg | Supported | Supported |
image/png | Supported | Supported |
Video |
|
|
video/mp4 | Supported | Supported |
video/3gp | Supported | Not Supported |
Sticker |
|
|
image/webp | Supported | Not supported |
FAQ
Validating Whatsapp API Key
Sangoma CX internally validates a WhatsApp key with the following GET API call:
|
To test the key, make the above API call and check for any errors.