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.

In your Conversation Handover plugin, you can also add keywords that would trigger the conversation to return to the bot. You'll find this field in the end of the plugin card

You can insert the keywords in any language you wish, but it's best if the language matches the one you have set up in your AI tab. If the user types one of the keywords, the conversation will be handed back from the third-party app you're using. Keep in mind that the bot can't read the messages your operators send from the third-party app - the user needs to type those.  

If you want to make sure that the user knows they are no longer in the third-party app, in a live chat session with your agent - you can simply place a Text Card after your Conversation Handover plugin that makes that clear.
Any of your bot's cards can be placed after the Conversation Plugin - and it will be delivered to the user right after the handover session is finished.
You can use this to collect feedback on the Live Chat sessions, or simply return your users into a specific part of the bot's flow.

Also keep in mind that, while the Conversation Handover is active, Live Chat won't be available for that specific user.

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

Additional information:

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


Did this answer your question?