Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

Cloudfon connector hub 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.

Table of Contents

...

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.

...

Get your Facebook App ID and App Secret

Please reference How to initialize Facebook APP to get the App ID and App Secret

Configure Facebook application integration

Log in to the system administrator portal, click "Advance"> "Connector Hub Setting"> "Facebook" to enter the Facebook settings page.

...

Fill in the App ID and App Secret of your Facebook application into Client-id and Client-Secret, then click save. After that, the system will prompt you that Save successfully.

The following are tips for successful integration:

...

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. Select the option “Other”.

...

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

...

  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.

...

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.

...

Configure Facebook Login

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

...

  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.

...

Configure the Facebook App

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

...

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

...

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

...

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

...

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

...

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

...

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

...

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

...

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

...

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”.

...

  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

...

  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.

...

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.

...

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.

...

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