Introduction
CloudFon CloudCX allows you to respond to messages sent by your customers through integration with the WhatsApp Business account. You must first set up your business assets on the WhatsApp Business Platform before you can configure and start using WhatsApp Cloud API from CloudFonCloudCX.
Note: You must ensure to verify WhatsApp Business Manager account beforehand while creating app on Meta. To learn how to verify your business account, see this articlehttps://www.facebook.com/business/help/2058515294227817?id=180505742745347 .
The setup consists of the following steps:
Create App on Meta for Developers
Associate a Business Manager Account
Generate a Permanent Token
Set Up a Webhook
| Table of Contents | ||
|---|---|---|
|
Step1. Create App on Meta for Developers
To create an app, follow these steps:
Enable two-factor authentication for your accounthttps://developers.facebook.com/docs/development/register .
Go to http://developers.facebook.com/ > Apps > Create App.
...
On the Select an app type page, choose an app type as Business. Your app type determines which products and APIs are available to your app.
Click Next.
...
In the Display Name field, enter the name of your app.
In the App Contact Email field, enter an email address where Meta can send you any important developer notifications.
Select or create a WhatsApp Business Manager account from the drop-down list.
Click Create App.
...
In this step, you associate a Business Manager account with WhatsApp. To associate a Business Manager account with WhatsApp, follow these steps:
On the http://developers.facebook.com/, go to the App Dashboard page and select your app from the drop-down list.
Click Add Products.
Scroll down to find the WhatsApp product and click Set up.
...
11. Locate the Phone number ID for your WhatsApp phone number. Copy and save the Phone number ID and WhatsApp Business Account ID locally, and proceed to Step 3: Generate a Permanent Token.
Step3. Add WhatsApp Payment Method
| Info |
|---|
According to the latest guidelines from Meta, users are now required to input their payment method within the Meta Business Suite. Failure to do so will result in restrictions on the features available for WhatsApp Business. |
| Info |
|---|
Various locations may have different pricing for WhatsApp. For more information, please refer to this link. https://developers.facebook.com/docs/whatsapp/pricing |
...
Step4. Generate a Permanent Token
Note：Before you start this job, please check that you meet the following requirements：
A Meta business account.
A WhatsApp Business Account, associated with your business account.
A business app https://developers.facebook.com/micro_site/url/?click_from_context_menu=true&country=CN&destination=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2Fdevelopment%2Fcreate-an-app%2Fapp-dashboard%2Fapp-types%23business&event_type=click&last_nav_impression_id=078otBijTEfsSRgSC&max_percent_page_viewed=63&max_viewport_height_px=969&max_viewport_width_px=1865&orig_http_referrer=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2Fwhatsapp%2Fbusiness-management-api%2Fget-started&orig_request_uri=https%3A%2F%2Fdevelopers.facebook.com%2Fajax%2Fdocs%2Fnav%2F%3Fpath1%3Dwhatsapp%26path2%3Dbusiness-management-api%26path3%3Dget-started®ion=apac&scrolled=true&session_id=13fnkixsmE135KphE&site=developers , associated with your business account.
Either a System User access token or a User access token.The https://developers.facebook.com/docs/whatsapp/business-management-api/get-started#system-user-access-tokens or a https://developers.facebook.com/docs/whatsapp/business-management-api/get-started#user-access-tokens .
The https://developers.facebook.com/docs/permissions/reference/whatsapp_business_management permission.
If your app needs to access endpoints that target your business account, you will also need the https://developers.facebook.com/docs/permissions/reference/business_management permission.
For more details please refer to this article. https://developers.facebook.com/docs/whatsapp/business-management-api/get-started#1--acquire-an-access-token-using-a-system-user-or-facebook-login
To generate a permanent token, follow these steps:
Go to business.facebook.com and click the hamburger menu > All tools > Business settings.
...
An Access Token(Token) is generated. Copy and save the access token locally and click OK.
...
10. Next, go to CloudFon CloudCX Control Panel: Inbox> Channels> WhatsApp>WhatsAPP WhatsApp>WhatsApp Cloud, and do the following:
Provide the Phone ID, Token and WhatsApp Business Account ID you saved locally in the WhatsApp channel account.
Copy the Webhook URL and Verify token from the CloudFon’s CloudCX’s WhatsApp channel account and proceed to Step 4: Set Up a Webhook.
...
...
Step5. Set Up a Webhook
Webhooks are user-defined HTTP callbacks that are triggered by specific events. You get a notification (HTTP request) sent to a setup URL whenever a trigger event occurs.
To set up your Webhook, follow these steps:
Go to http://developer.facebook.com/ and select the app from the drop-down list you created in Step1: Create App on Meta for Developers.
Navigate to Products > WhatsApp> Configuration.
Click Edit.
On the Edit webhook’s callback URL pop-up, provide the Webhook URL and Verify token you saved locally from the CloudFon CloudCX Control Panel: WhatsApp channel account.
Click Verify and save.
...
Click Manage and subscribe to the Webhook fields. You need to subscribe messages and message_template_status_update
Next, go to the CloudFon CloudCX Control Panel and click Save & Test to test your WhatsApp channel connection with CloudFon CloudCX Inbox.
To learn more on WhatsApp channel configuration on CloudFon CloudCX Control Panel, please contact support@cloudfon.net.
...