Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

CloudCX Connector Hub provides integration with Facebook via the API for Facebook. The configuration is done server-side, in an easy and straightforward way. Let's follow the instructions step by step to complete the integration with Facebook.

Create A Facebook App

To integrate with Facebook, you have to create a Facebook app in the developer portal. You can find more details about creating Facebook apps here.

Prerequisites

  1. A valid Facebook Account.

  2. A valid Facebook Developer Account.

  3. A verified Facebook Business Account.

  4. A valid Facebook Page.

Register A Facebook App

  1. Go to Facebook developer portal and click on the “Create App” button

1-20240822-031539.PNG

  1. Select the option “Other”.

2-20240822-031721.PNG

  1. For the app type, choose “Business”.

3-20240822-031808.PNG

  1. Enter basic details like the app name and email, and select the verified Facebook Business Account.

Note: When creating the APP, it must be placed under the verified Facebook Business Account, otherwise the APP cannot be submitted.

4-20240822-032048.PNG

Once you register your Facebook App, you will have to obtain the App ID and App Secret. These values will be available in the app settings and will be required while setting up in the Connector Hub.

5-20240822-042353.PNG

Configure Facebook Login

  1. Add the Facebook Login for Business product via the Facebook app dashboard.

6-20240822-042510.PNG

  1. Enable Client OAuth login, Web OAuth login, and add the Authorized Redirect URL https://your_cx_domain/api/v1.0/facebook/integration/callback to the Valid OAuth Redirect URIs.

7-20240822-062800.PNG

Configure the Facebook App

  1. In the App settings > Basic, add your CloudCX installation domain as your app domain.

8-20240822-042856.PNG

  1. In the products section in your app settings page, Add “Messenger”

9-20240822-061631.PNG

  1. Go to the Messenger API Settings and connect Facebook pages to generate access tokens.

10-20240822-063347.png

  1. After connecting the pages, click on “Generate” to generate access tokens.

11-20240822-071556.png

  1. Click on “Copy” to copy access token, this value will be required while setting up in the Configure webhooks.

12-20240822-073031.PNG

  1. Go to the Configure webhooks and click on “Configure”, paste the access token to the Verify Token.

13-20240822-074044.PNG

  1. Add the Webhook URL https://your_cx_domain/fb/webhook as the Callback URL.

14-20240822-074348.PNG

  1. After configuring webhooks, Click on Add subscriptions from the page to add Webhook Subscriptions.

15-20240822-075044.PNG

  1. Subscribe to all the fields and save the subscription.

16-20240822-075228.PNG

Submit the Facebook App into production

Before you can start using your Facebook app in production, you will have to get it verified by Facebook. Refer to the docs on getting your app verified.

  1. Go to App settings > Basic, complete the App’s details like the ”Contact email, Privacy Policy URL, Terms of Service URL, App Icon and Category”.

18-20240822-081935.PNG

  1. Go to App Review > Permissions and Features, apply for advanced access to the required permissions mentioned below for your Facebook app

pages_messaging

Business Asset User Profile Access

pages_manage_metadata

public_profile

business_management

pages_show_list

19-20240822-091147.PNG

  1. Go to App Review > Requests, add the verification details and description for each permission, upload screencast for each permission. After completing all requests, click on “Submit for Review” to apply for advanced access.

20-20240822-094603.PNG

Note:

  • Each permission is required to submit a recorded video about how the permission is used in CloudCX system.

  • After Facebook has approved it, it will have a green label of "advanced access";

  • Permissions are more likely to be denied by Facebook, please keep in real-time communication with theircustomer service;

  • Permission repeatedly denied to apply frequently, your account will be considered unstable account and will be banned by Facebook.

  1. After obtaining advanced access and switching the App Mode to Live, the configuration on Facebook is finished.

21-20240822-095141.PNG

Configure Facebook Integration in CloudCX

Log in to your system administrator portal https://your_cx_domain:9006, go to Advance > Connector Hub Setting > Facebook to configure.

  • Paste the App ID & App secret to Client-id & Client-Secret, the App ID & App secret obtain from Facebook App Settings here.

  • Copy the Authorized Redirect URL and paste to Facebook Login for Business here.

  • Copy the Webhook URL and paste to Facebook Messenger API Settings here.

31-0-20240826-041848.png

That's all the Facebook integration, now, you can connect your Facebook pages to the Inbox > Channels > Facebook in your tenant here!

  • No labels