We’ve changed our name! API.AI is now Dialogflow. Learn more here.

Facebook Messenger

The Dialogflow Facebook integration allows you to easily create a Facebook Messenger bot with natural language understanding, based on the Dialogflow technology.

Setting Up Facebook

In order to set up the Facebook integration for your agent, you'll need the following:

When a user visits your page and sends you a message, they'll be talking to your agent.

Create a Facebook App

  1. Log into the Facebook Developer Console.
  2. Click on My Apps in the upper right hand corner.
  3. Click on Add a New App and enter a name and contact email address
  4. Click Create App ID.

  5. On the next page, click the Get Started button for the Messenger option.

  6. Under the Token Generation section, choose one of your Facebook pages.

This will generate a Page Access Token. Keep this token handy, as you'll need to enter it in Dialogflow.

Setting Up Dialogflow

  1. Click on the Integrations option in the left menu and switch on
    Facebook Messenger. In the dialog that opens, enter the following information:
    • Verify Token - This can be any string and is solely for your purposes
    • Page Access Token - Enter the token generated in the Facebook Developer Console
  2. Click the Start button.

Webhook Configuration

To configure your agent's webhook, return to the Facebook Developer Console:

  1. Click the Setup Webhooks button under the Webhooks section and enter the following information:
    • Callback URL - This is the URL provided on the Facebook Messenger integration page
    • Verify Token - This is the token you created
    • Check the messages and messaging_postbacks options under Subscription Fields
  2. Click the Verify and Save button.

You'll be taken back to the settings page and Webhooks should have a "Complete" status.

Testing

In order to make your agent available for testing, you'll need to make your app public:

  1. Click on App Review in the left menu of the Facebook Developer Console.
  2. Click on the switch under Make APP_NAME public? You'll be prompted to choose a category for your app.
  3. Choose Apps for Messenger from the list
  4. Click the Confirm button.

You will also need to set a username for your page. This is the username users will chat with when using your agent. To set the username, click the Create Page @Username link under your page's profile picture and title.