The BotSharp Facebook integration allows you to easily create a Facebook Messenger bot with natural language understanding, based on the BotSharp technology.
**Setting Up Facebook**
In order to set up the Facebook integration for your agent, you'll need the following:
* A Facebook account
* A Facebook page to add your agent to
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 display name and contact email.
4. Click **Create App ID**.
5. On the next page, click the **Set up** button for the **Messenger** option.
6. Under the **Token Generation** section, choose one of your Facebook pages (**Create a new page** if not exist).
This will generate a **Page Access Token**. Keep this token handy, as you'll need to enter it in BotSharp.
**Setting Up BotSharp**
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. Or edit agents.json under App_Data\DbInitializer\Agents, update **Page Access Token** and **Verify Token**.
3. 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.
**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.
