В данной статье описываются действия по добавлению постоянного меню для Facebook Messenger. Данные действия осуществляются за счет настройки параметров чата Facebook.
Что такое постоянное меню?
Постоянное меню отражается для пользователя бота по дополнительной иконке рядом с полем ввода. В такое меню можно включить наиболее важные действия, которые должны быть постоянно доступны пользователю. Такое меню позволит удобнее и быстрее взаимодействовать с ботом как новым, так и постоянным пользователям.
Добавление и удаление постоянного меню
Как добавить постоянное меню не очевидно. Благо сделать это нужно только один раз. Для этого надо использовать POST запрос к боту с помощью утилиты Postman или аналога.
Для добавления меню используйте следующий пример запроса:
curl -X POST -H "Content-Type: application/json" -d '{ "setting_type" : "call_to_actions", "thread_state" : "existing_thread", "call_to_actions":[ { "type":"postback", "title":"Помощь", "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_HELP" }, { "type":"postback", "title":"Новый заказ", "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_START_ORDER" }, { "type":"web_url", "title":"Перейти к сайту", "url":"<a href="http://petersapparel.parseapp.com/">http://sherlock.im/</a>" } ] }' "<a href="https://graph.facebook.com/v2.6/me/thread_settings?access_token=PAGE_ACCESS_TOKEN">https://graph.facebook.com/v2.6/me/thread_settings?access_token=PAGE_ACCESS_TOKEN</a>"
В данном примере коды, указанные в реквизитах payload, должны совпадать с кодами сценариев бота Sherlock Platform или обрабатываться в боте каким-либо другим способом. Для идентификации нужной страницы необходимо передать корректный PAGE_ACCESS_TOKEN.
Для удаления постоянного меню используйте запрос по шаблону ниже:
curl -X DELETE -H "Content-Type: application/json" -d '{"setting_type":"call_to_actions","thread_state":"existing_thread"}' "<a href="https://graph.facebook.com/v2.6/me/thread_settings?access_token=PAGE_ACCESS_TOKEN">https://graph.facebook.com/v2.6/me/thread_settings?access_token=PAGE_ACCESS_TOKEN</a>"
Для изменения меню достаточно повторно направить тот же запрос, что и для создания меню.