WhatsApp Cloud
Neo supports the official WhatsApp Business API. You can connect the phone number and start managing your WhatsApp customer queries from Neo. Follow the steps below to enable your WhatsApp inbox with WhatsApp Cloud API.
Prerequisites
1. Set up your Facebook Developer App
First, you need to create your Facebook Developer app with WhatsApp Product enabled. Go to the WhatsApp Cloud API Guide, navigate to the 'Set up Developer Assets and Platform Access' section, 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 can obtain the Phone Number Id and Whatsapp Bussiness Account ID as shown in the screenshot below. Neo will require these values for creating the WhatsApp Inbox.
2. Set up 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 Neo.
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.
Set up WhatsApp Inbox in Neo
Step 1: Open your Neo dashboard. Go to Settings → Inboxes → Add Inbox.
Step 2: Select the “WhatsApp” icon.
Step 3: Make "WhatsApp Cloud" your API provider of choice. Include the necessary information.
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's access token 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
Complete the steps to obtain your Whatsapp Webhook Callback URL.
Enable the Webhook
Configure the webhook in Facebook Developer App.
Go back to the Facebook Developer App's WhatsApp section. Set the Callback URL in the Configuration subsection.
The value for the URL should be the same URL you obtained at the end of your Neo inbox creation and will look like https://app.neoleads.in/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.
On your Facebook Developer app, you should additionally subscribe to 'message fields' events under 'Webhooks Fields'.
The section should appear as seen in the following screenshot once you have completed all the stages.
FAQ
How to configure multiple numbers under a single Facebook app?
The Facebook App only permits setting up one Webhook endpoint. As a result, build Inboxes in Neo for each number as necessary. Only one of these inboxes' Webhook URL needs to be configured in the Facebook app in order for the other inboxes to function.
Additional Inbox settings
Your list of inboxes should now include your newly configured WhatsApp inbox. 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 your Twitter inbox. We recommend going through this link to understand them.
Supported media types
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
Last updated