Create a Facebook app for PureCloud
Before you can configure and test ACD messaging for Facebook Messenger in PureCloud, you must create a Facebook app. You’ll use Facebook’s developer site to create your Facebook app.
Disclaimer: Since Facebook’s developer site is considered a third-party, the configuration information in this article is provided as general instruction and is subject to change by the third-party. Best practice recommends that you review the third-party’s official documentation to confirm that you are following the most recent process.
When you create a Facebook app for testing, only Facebook app administrators and designated testers will be able to use the app to send messages thru your Facebook page and have it route those messages into PureCloud.
In order to use your Facebook app in a live environment, you must have your app approved by Facebook. Once your app is approved, any Facebook user can use Facebook Messenger to send messages to PureCloud.
To set up and obtain proper approval for your Facebook app, you must:
- Have a published Facebook business page. See Facebook’s Getting started with pages.
- Be familiar with the Messenger Platform. See Facebook’s Introduction to the Messenger Platform.
- Have Facebook Login for Apps configured to allow users to log into your app. See Facebook’s Facebook Login for Apps.
If you already have an existing, approved Facebook app, you can use it by configuring your app with specific PureCloud information specified in this article.
If you create a new Facebook app, you must understand that the type of Facebook app that you create uses Facebook Messenger permissions. As such, you must submit your app for review by Facebook. The review process can take a week or more to complete. For more information, see Facebook’s App Review for Facebook page.
To create your Facebook app, follow the instructions on Facebook’s App Development page.
When you configure your app, be sure that is has the following permissions before you submit it for approval. Doing so ensures that your Facebook app functions correctly with PureCloud.
- Pages Messaging permission -required to allow your app to send and receive messages through a Facebook page.
- Manage Pages permission – required to allow your app to retrieve page access tokens for pages and apps.
When you set your app details on the App Dashboard, pay particular attention to the following fields as they must provide information specific to PureCloud.
When filling in the app domains, you must add all the PureCloud domains in which you want to communicate. More specifically, you must add a domain for each region that you want to be able send and receive ACD messages. For example, to communicate in the EU Frankfort and Asia Pacific (Tokyo) regions, you add apps.mypurecloud.de and apps.mypurecloud.jp.
|US East (N. Virginia)||apps.mypurecloud.com|
|US West (Oregon)||apps.usw2.pure.cloud|
|Asia Pacific (Sydney)||apps.mypurecloud.com.au|
|Asia Pacific (Tokyo)||apps.mypurecloud.jp|
While you can select any category you want, Genesys recommends that you select Messaging.
App ID and App Secret
Take note of two pieces of information on the App dashboard – the App ID and App Secret. You need this information when you configure ACD messaging for Facebook Messenger in PureCloud.