How to configure the Conversation Menu
The Conversation Menu or Persistent Menu allows you to have an always-on user interface element inside Messenger conversations. This is an easy way to help people access information in your Messenger channel at any point in the conversation.
Menu items of the Conversation Menu can trigger messages, open websites within Messenger or open sub-menus. The top level menu has a maximum of 3 items, each sub-menu has a maximum of 5 items and the maximum menu depth is 3, which leaves you with 75 items in total (3 x 5 x 5).
You can configure the menu in the Conversation Menu section of MailPort.
Adding a new menu item
By default you will see a menu with one menu item, the MailPort branding. This can’t be removed unless you upgrade to a Premium account. To create a new menu item, just click “+ Add menu item”.
When the new menu item is added, you can name the new item and a box opens up to the right. This box lets you choose what should happen when a user clicks this menu item in the conversation. The three options are: “Reply with message”, “Open website” and “Open sub-menu”.
Example 1: Open a website
As first example we choose “Open a website”. We can rename the menu item to something like “Visit our website” and in the “Website URL” field to the right we can enter the website which will be opened when clicking this menu item. With “Save” it will be saved to our conversation menu.
Example 2: Open a submenu
When choosing “Open sub-menu” you can see that a new menu opens up directly beneath the currently active menu item. By clicking “Save” this menu item will lead the user to the sub-menu we need to create in the next step.
⚠️ Please note that a sub-menu can’t be empty!
Sub-menu items can be added by clicking “+ Add menu item” for a specific menu item.
Example 3: Reply with a message
Each menu item can also trigger a message which will be sent to the user. To do that, just choose “Reply with message” and enter the message you want to send.
Beneath the message you have a section called “Actions”. These are so called “Reply actions” which are executed before the message is sent to the user. Actions are optional and can simply be added by clicking “+ Add Action”. You can then choose from a list of available actions. You can add multiple actions to a message. These actions can be used for example to subscribe or unsubscribe a user to or from a MailChimp list.
In this example, we have a menu item called “Unsubscribe”. When the user clicks this menu item, the reply action (in this case: unsubscribe the user from a MailChimp list called MailPort) will be executed and your message (“You are now unsubscribed”) will be send out to the user.
Publish the menu
As last step we need to publish the menu to Facebook Messenger. You can do that by simply clicking the “Publish menu” button at the bottom of the menu. A confirmation text “Your menu has been published” will appear beneath the button after it was successfully published to Facebook Messenger.
Edit menu items
Every item can be edited by clicking the edit icon đź“ť at the right of each item.
⚠️ Please don’t forget to publish the menu again after editing to push the updates to Facebook Messenger.
Delete menu items
To delete a menu item, first click the edit icon to open the item. Next to the “Save” button you will also see a red “Delete” button. This will delete the menu item. If this item contains a sub-menu, the whole sub-menu will be deleted as well. Please be informed that this action is irreversible.
⚠️ Don’t forget to publish the menu after deleting an item, otherwise users will see menu items which are not available in our system anymore.
