Handover Protocol Example Bot

This app is a basic demo of using the Messenger Platform's handover protocol.

Requirements

To run this app you will need the following:

• Facebook developer account
• Facebook developer app with a configured webhook
• Facebook Page
• A server that has Node.js installed

Setting Up the Webhook

This repo contains code for the webhook and application logic for an example Messenger bot. To run it, do the following:

1. Download this repo
2. Deploy the repo to your server
3. Create an env file with the following module.exports object:

module.exports = {
  "PAGE_ACCESS_TOKEN": "<YOUR PAGE ACCESS TOKEN>",  
  "VERIFY_TOKEN": "YOUR WEBHOOK VERIFY TOKEN"
}  

Alternatively, you can set the above as environment variables.

4. Run npm install in the repo directory
5. Run node index.js to start the webhook
6. Configure the webhook in your Facebook app settings
7. Subscribe the Facebook app to receive webhook events for your Page

Using the bot

1. Send any text message to the bot. The bot will respond with a greeting message and 'Pass to Inbox' quick reply.

2. Tap the 'Pass to Inbox' quick reply. The bot will respond with this quick reply:

3. Go to your Page Inbox and reply to the conversation. Messages sent from the Page inbox will appear in the conversation in Messenger.

4. Check the 'Done' checkbox to pass control back to the bot.

5. Tap the 'Send to Inbox' quick reply. The conversation will be moved to the Page inbox, and the bot will respond with this quick reply:

6. Tap the 'Take from Inbox' quick reply. The bot will respond with this quick reply: