View source for 5.19:Configure-facebook-messenger-for-integration

=Configure Facebook Messenger for Integration with Bright Pattern Contact Center=


Integrating Facebook Messenger with {{BPCC}} requires a {{BPCC}} integration account. The connection parameters page in {{BPCC}} administrator contains settable parameters for a Facebook Page username, a Facebook Page ID, a Facebook access token, and a webhook verify token.

For more information about the {{BPCC}} integration connection parameters page, see [[Integrate-facebook-messenger|Integrate Facebook Messenger with {{BPCC}}]].
 
These instructions describe how to set up Facebook Messenger to get the required values to fill in the {{BPCC}} integration account connection parameters page.

* [[#Create a Facebook App|Create a Facebook App]]
* [[#Create a Facebook Page and Set the Username | Create a Facebook Page and Set the Username]] 
* [[#Link the Facebook App to the Page | Link the Facebook App to the Facebook Page]]
* [[#Generate a Facebook Access Token | Generate a Facebook Access Token]]
* [[#Set the Webhook and Callback URL | Set the Webhook and Callback URL]]

{{Note | These instructions are current at the time of publication. Check for updated instructions by visiting [http://developers.facebook.com/  Meta for Developers].}}

'''Dependencies'''

* A Meta Developer's account
* Administrator access to {{BPCC}} Administrator


== Create a Facebook App ==


# Log in to http://developers.facebook.com/.
# Click '''My Apps'''.
# Click '''Create App'''.

{{Image650| 2022-11-01-facebook-create-an-app.png| Selecting an app type in the Create an App page in My Apps on the Meta for Developers site.}}

#<li value="4"> Select '''Business''' as the app type, then click '''Next'''. </li> 

{{Image650|2022-11-01-facebook-app-basic-info.png |The basic information form displayed when creating a Facebook app.}}

#<li value="5"> Enter values for '''Display Name''' and '''App contact email''', then click '''Create App'''. </li> 

{{Image650| 2022-11-01-facebook-add-products-to-app.png| The product tiles page is displayed when adding the Messenger product to a Facebook App.}}

#<li value="6">On the '''Add products to your app''' page, find the '''Messenger''' tile, then click '''Set up''' to open the Messenger > Settings page. </li> 

== Create a Facebook Page and Set the Username ==


# Click '''Create New Page''' in the '''Access Tokens''' section of the '''Settings''' page.


{{Image650| 2022-11-01-facebook-create-a-page.png |The blank Create a Page form is displayed when creating a Facebook Page.}}

# <li value="2"> Enter values for '''Page name''' and '''Category''', then click '''Create Page'''. </li> 
# Click '''See all Profiles''', then select a '''Page'''. 
# Click the Page's profile picture in the top right.
# Click '''Settings & privacy''', then click '''Settings'''.
# Below '''General Page settings''', click '''Edit''' next to '''Username'''.
# Enter a username.

{{Note | This username will be entered into the '''Page Username''' field of the '''Connection Parameters''' page in {{BPCCA}} when [[Integrate-facebook-messenger| configuring a Facebook Integration account]].}}

#<li value="8"> Click '''Save changes'''.</li>
# Click the profile photo in the top right.
# Click '''See all Profiles''', then select a '''Page'''.
# Click '''Save'''.
# Navigate to the page.

== Link the Facebook App to the Page ==


# Click '''Messenger > Settings''' in the '''App Dashboard'''.
# Find the '''Access Tokens''' section and click '''Add or remove Pages'''. 

{{Image650|2022-11-01-facebook-what-pages-to-use.png|Selecting a page to use with Facebook app.}}

#<li value="3"> Select the '''Pages''' to use with the app, then click '''Next'''.</li>

== Generate a Facebook Access Token ==


{{Image650|2022-11-01-facebook-access-tokens.png|The Access Tokens section with buttons to generate and link tokens to a Facebook Page. }}

# Click '''Messenger > Settings''' in the '''App Dashboard'''.
# In the '''Access Tokens''' section, find the added Page, then click '''Generate token'''.
# Copy the generated token.

{{Note | This token will be entered into the '''Token''' field of the '''Connection Parameters''' page in {{BPCCA}} when [[Integrate-facebook-messenger| configuring a Facebook Integration account]].}}

== Set the Webhook and Callback URL ==

# Click Messenger > Settings in the App Dashboard.
# In the Webhooks section, enter values for '''Callback URL''' and '''Verify token'''. 
<br>
The format of the Callback URL:

:<pre>https://tenant_url/clientweb/fb/webhook</pre>

:''tenant_url'' is the domain of your {{BPCC}} client web server.

{{Note | The '''Verify token''' is generated in {{BPCCA}} and is found in the '''Webhook Verify Token''' field in the connection parameters page of the Facebook Messenger integration account. For more, see  [[Integrate-facebook-messenger| configuring a Facebook Integration account]].}}

{{Image650|2022-11-01-facebook-webhook-page.png|Setting Facebook’s webhook.}}

{{Note| As of {{BPCC}} 5.3, one Facebook App can work with multiple Facebook Pages and multiple Facebook Messenger integrations can be added for a Facebook Page, sharing the same webhook.}}

#<li value="3">In the Webhooks section, click Add Subscription on the Page’s row in the Pages table.</li> 

{{Image650|2022-11-01-facebook-integration-edit-page-subscriptions.png|Editing Facebook’s page subscriptions.}}

#<li value="4">Select messages, message_deliveries, and message_reads in the Edit page subscriptions dialog, then click Save.</li>