56 lines
2.6 KiB
ReStructuredText
56 lines
2.6 KiB
ReStructuredText
Messenger
|
|
==================
|
|
|
|
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.
|
|
|
|
.. _Facebook Developer Console: https://developers.facebook.com |