Deploy a Messenger Endpoint
Description
With the implementation of a Messenger Endpoint you can easily connect your Facebook Messenger Bot with COGNIGY.AI.
This tutorial covers the necessary steps for creating and connecting a Facebook Messenger Endpoint. If you want to get information about assigning a Flow to the Endpoint and setting up the Data Management see Endpoints.
Three Step Preparation Process
1 Create a Facebook Page on Facebook
2 Create a Facebook App in the Facebook Developer Center
3 Create and Configure a Messenger Endpoint on COGNIGY.AI
1 Create a Facebook Page
Requirements
Facebook Account
1.1 Pages Overview
Log into your Facebook Account. Then on your landing page click on the Pages entry in the left navigation menu (see Figure 1.1)
Figure 1.1: Menu Entry for the Pages Overview
1.2 Create a Facebook Page
Click on the Pages link and you'll see an overview of your Facebook pages. Create a new one by clicking the green button in the top navigation bar (see Figure 1.2). You can choose any kind of page you want (business or community). Give it a name and a category and you're ready for step 2.
Figure 1.2: Create Page Button
2 Create a Facebook App
Requirements
Facebook Account
Facebook Page
2.1 Add new App
First, you've to log into your Facebook account. Then, after getting redirected, click on Manage Apps (see Figure 2.1a) and select Add a New App (see Figure 2.1b)
Figure 2.1a: Menu entry for Manage Apps
Figure 2.1b: Apps menu
A prompt opens for creating a new Facebook App (see Figure 2.1c). Create the App entering the necessary information in the requested fields.
Figure 2.1c: Create New App Prompt
2.2 Add the Messenger Product
After creating the Facebook App you'll see an overview of the available products. Select Messenger by clicking set up (see Figure 2.2)
Figure 2.2: Messenger Product
2.3 Get the Page Token
If you're on the overview page of your Facebook App go to the settings of the Messenger product of your app (see Figure 2.3a).
Figure 2.3a: Navigation Menu for Products
Scroll down to the Access Tokens section and add the page you've created in Step 1 by clicking in Add or Remove Pages. (see Figure 2.3b).
Figure 2.3b: Access Tokens menu
After adding the page, press on Generate Token (See Figure 2.3c)
Figure 2.3c: Access token with added page
Read the warning and check the "I Understand" box so the token will be revealed, copy the token and click done (see "Figure 2.3d**)
Figure 2.3d: Generate Token menu
Now you good to go to step 3 and set up the Messenger Enpoint with COGNIGY.AI.
3 Create and Configure a Messenger Endpoint
Requirements
Facebook Page Access Token
3.1 Create a Messenger Enpoint
First you have to create an Endpoint of the type Messenger (see Figure 3.1).
Figure 3.1: Messenger Endpoint Creating Prompt
3.2 Configure the Messenger Endpoint
Expand the Facebook Page Setup panel (see Figure 3.2) and paste the saved Page Access Token into the corresponding field.
Figure 3.2: Facebook Page Setup Panel
Optional Secret Validation
You can add an optional security layer and verify for every message that it was actually sent from Facebook Messenger. To do this, add your App ID and App Secret in the corresponding fields in your Endpoint Facebook Page Setup.
3.3 Get the Endpoint URL
Move to the top of the Endpoint Configuration page and copy the Endpoint URL which is displayed above the General Settings (see Figure 3.3).
Figure 3.3: Endpoint URL
Final Step: Connect Your Facebook App to the Endpoint
Requirements
Endpoint URL
Switch back to your Facebook App and there to the settings page of the Messenger Product. Scroll to the Webhooks section and click on Add callback URL. A prompt opens and asks for (see Figure 4.1):
- a Callback URL
- a Verify Token
Figure 4.1: Webhooks Setup
As the Callback URL paste in the Endpoint URL which you gathered in step 3.3.
The Verify Token is by default cognigy123 but it depends on the installation of your COGNIGY.AI platform (for further information please contact the technical support). Press Verify and save to continue.
After adding the Callback URL you will have a view with details about the webhook (see Figure 4.2)
Figure 4.2: Webhook details
Now we need to add "Subscriptions fields", press the Add subscription fields button, a prompt will open (see Figure 4.3) For the Subscription Fields select the messages and messaging_postbacks events. If you want to use referrals, you'll also need to subscribe to the messaging_referrals event.
Select the fields and press save.
Figure 4.2: Edit subscription fields
You should be all set up to use the Messenger Endpoint you've created with a Flow of your choice.
Updated about 2 years ago