This section details how to install and manage your own Meta Apps for Deskpro On-Premise.

Meta App Dashboard

Prerequisites

Before setting up your Meta App you will need the following:

• A Facebook Account

• Access to the Meta Developer Dashboard

• Administrator Access to the Meta App that you are going to use in Deskpro

You can find further information on how to register as a Facebook Developer here.

Create a Meta App in Facebook

In order to integrate your App successfully with Deskpro, you will be required to create a Business type App. When prompted to specify your App’s use case, please select ‘Other’.

Further information on how to create an App can be found here.

You can see all your available Apps from the Dashboard.

Adding your new Meta App to Deskpro

App Details

Before adding your new Meta App to Deskpro, you will need to access your App settings in the Facebook App Dashboard and confirm some settings.

1. Access your Facebook App Dashboard here and select your App by clicking on the icon or the name of your App from the apps available.

2. Access your App’s advanced settings from the left hand side menu as seen in the screenshot below:

1. Scroll down to the Security section, and set the option 'Require app secret' ON.

1. Access your App’s Basic settings from the left hand side menu as seen in the screenshot below:

1. Copy your App ID and App Secret. To show the App Secret, you will need to click on the ‘Show’ button, and you may need to re-enter your Facebook password. Please keep these details safe as you will be using them in the next steps to setup your App in Deskpro.

Add a new Meta App to Deskpro

Go to the Deskpro Admin interface and navigate to Channels > Messenger. If you haven’t activated Messenger previously in your Deskpro instance, you will be offered the option Self-managed

Navigate to Messenger > Apps, then click the top right button New to add your App, and complete the required fields with the details copied from the Meta App Dashboard in the previous point.

Please note that you will need to tick the ‘Test App’ checkbox to add your App whilst it is in Development Mode (before Meta App review)

Click Save and your App will be added to your Deskpro instance.

Overview of Admin Meta App Drawer details

Select your App from Channels > Messenger > Apps. A drawer will open to reveal the App details needed to connect Deskpro to your Facebook Page via the Meta App.

• App Webhook and App Webhook Verification Token are required to setup the Meta App webhook product in the Developer App Dashboard and be able to receive messages from your installed pages.

• App Authorize URI and App Deauthorize URI are required to setup Facebook Login in your Deskpro instance to connect your Facebook pages from which you will receive messages.

Connecting Deskpro to your Meta App

With the details gathered from our Meta App in Deskpro (as shown in the previous point), we can setup the relevant products in the Meta Developers App Dashboard in order to connect Deskpro to Facebook.

You will need to access your Meta App Dashboard in the Meta Developers page. To access your App, go to the following link and select the relevant Meta App: https://developers.facebook.com/apps/

Setting up Webhooks

In your Meta Developer App page, add a new Webhooks product. To show all the available products, click in the link Add Product from the left hand side menu.

From the list of products, select ‘Webhooks’. You should see a page to setup your webhook. From the setup page, select the ‘Page’ object from the dropdown and click ‘Subscribe to this object’

A popup window will appear asking you to enter further details about your webhook. Copy the App Webhook and App Webhook Verification Token shown in our previous point (Overview of Admin Meta App Drawer details) and paste them in the relevant fields. Click ‘Verify and save’ to save your details.

Setting up Facebook Login for Business

In your Meta Developer App page, add a new ‘Facebook Login for Business’ product. To show all the available products, click in the link ‘Add Product’ from the left hand side menu as described in the previous point.

From the list of products, select ‘Facebook Login for Business’.

Don’t use the Quickstart setup, we will be doing this manually. Once your Facebook Login product has been added to the App, we will be able to see it on the left hand side menu. Select Facebook Login > Settings

Copy the App Authorize URI and App Deauthorize URI shown in our previous point (Overview of Admin Meta App Drawer details) and paste them in Client OAuth settings > Valid OAuth Redirect URIs and Deauthorize > ‘Deauthorize callback URL respectively. Click ‘Save changes’ to save your details.

Authorize URI

Deauthorized URI

Install your Facebook Page

In Deskpro, navigate to Channels > Facebook > Pages

1. Click on the button ‘Connect Page’ (top right hand side). A popup window will appear with a list of the available Meta features.

2. Select the Meta App that you want to install Pages for and click ‘Next’

1. A new window will prompt you to login with your Facebook account. Please use the account with administrator credentials to manage your pages.

2. A list of available businesses linked to the Facebook Account will be displayed. Please select the option ‘Opt in to current businesses only’ and choose those businesses that manage the pages that you would like to install in Deskpro and click ‘Continue’.

1. A list of available pages will be displayed. Please select the option ‘Opt in to current Pages only’ and choose those pages that you would like to install in Deskpro and click ‘Continue’. Please note that the App and pages shown to you will be different to the ones shown in the screenshot below

1. A list of the requested permissions to your account will be listed. Please review and click 'Continue'.

1. Click ‘Got it’ to finalise the process and return to Deskpro.

1. Upon completion, you will be redirected to Deskpro, and your installed page(s) should appear as shown in the screenshot below

Re-authenticate your Page access

Your page could become deauthorized for any of the following reasons:

• The App has been uninstalled from your page and Facebook has deauthorized the page as a result

• Facebook has deauthorized the App and the pages linked to it!

You can reauthorize your page(s) by viewing the relevant Page's details and clicking on the ‘Re-Authenticate’ button.

Re-Authentication will take you through the Facebook Login. Please use the same administrator Facebook user that was used to install the pages previously. To Re-Authenticate, please follow steps 2-7 in the previous section ‘Install your Facebook Page’.