The Messenger platform has a “Handover Protocol” feature that allows you to have more than one app participate in a conversation within your Page’s inbox — while making sure the conversation flow isn’t broken, and there are specific rules that control this. 

This feature can be used in many ways to make managing your conversations easier. For example, you can make sure that you’re using a Chatfuel bot for general conversations, and then a different app to allow the users to talk to a live support agent. 

Within Chatfuel, you can take advantage of this Facebook functionality using the Conversation Handover plugin.

No matter what you’d like to do using this plugin, here are the basic steps you need to take in order to set it up.

1. Go to your Facebook page’s Settings → Messenger Platform. Click “Configure”

2. You’ll need to set only one app to be the Primary Receiver (this should be Chatfuel). For the Secondary Receiver role - you can have one app, or more defined in your settings.

3. Go to Chatfuel, and add the “Conversation Handover” plugin

4. You’ll first need to pick your Secondary Receiver app here

5. You can also set up the desired timeout period here. That means that the bot will take control of the conversation after the specified amount of time. Keep in mind that changing timeout in the plugin will affect only future handovers for your users. You can also use the Graph API request defined in the plugin if you want to return control to Chatfuel before the timeout kicks in.


Congratulations! You have your handover protocol set up.

If you have any trouble with with the Conversation Handover plugin, send it over to the support team and we’ll help you out — team@chatfuel.com

Additional information:

Facebook’s documentation (including the Handover Protocol API Reference)

Did this answer your question?