API профиля Messenger: приветствие, Get Started, стартовые вопросы и постоянное меню
Профиль Messenger Страницы Facebook задаётся через /{page-id}/messenger_profile с токеном доступа Страницы и разрешением pages_messaging: POST записывает свойства get_started, greeting, ice_breakers, persistent_menu и commands, GET читает их с параметром fields, а DELETE удаляет свойства, перечисленные в массиве fields. Meta разрешает 10 вызовов за 10 минут на одну Страницу, и перезаписываются только отправленные свойства.
easyCoexistence отвечает в переписках Messenger Страницы через send_social_dm в пределах 24-часового окна, из Claude, ChatGPT или вашего собственного кода; новые сообщения пересылаются на ваш эндпоинт по мере поступления.
Количество вызовов Messenger Profile API, разрешённых для Страницы в каждом 10-минутном интервале.
Наибольшее число стартовых вопросов, которое задаёт API; если заданы оба варианта, стартовые вопросы API имеют приоритет над кнопкой Get Started.
Наибольшее число пунктов верхнего уровня в постоянном меню; заголовок каждого пункта ограничен 30 символами.
Сколько может занять обновление постоянного меню на уровне Страницы; меню, заданное для одного человека, обновляется в реальном времени.
Текст приветствия, который, согласно справке Meta, больше не работает в Messenger на Android и iOS.
Что хранит профиль Messenger?
Настройки, с которых начинается работа Messenger на Странице. API профиля Messenger от Meta перечисляет эти свойства; каждое задаётся и читается через один и тот же эндпоинт. Для приложения в режиме разработки настройки видны только людям, имеющим роль в приложении:
Как читаются, задаются и удаляются свойства?
Тремя методами на одном эндпоинте, вызываемом с токеном Страницы. POST принимает тело JSON со свойствами и перезаписывает только названные в нём, GET принимает fields в виде списка через запятую, а DELETE принимает тело JSON, где массив fields называет, что удалить; POST и DELETE возвращают result success. Кнопка Get Started и меню задаются одним вызовом:
POST /{page-id}/messenger_profile
{
"get_started": { "payload": "GET_STARTED" },
"persistent_menu": [
{
"locale": "default",
"composer_input_disabled": false,
"call_to_actions": [
{ "type": "postback", "title": "Talk to an agent", "payload": "AGENT" },
{ "type": "web_url", "title": "Shop now", "url": "https://example.com/shop" }
]
}
]
}
{ "result": "success" }Как работает кнопка Get Started?
Она находится на экране приветствия, где показаны название Страницы, изображение профиля и обложка, а также обычное время ответа бизнеса. Нажатие отправляет Get Started в переписку, передаёт get_started.payload в приложение как событие messaging_postbacks и открывает стандартное окно переписки. Meta сообщает, что кнопка не поддерживается, когда Messenger работает во встроенном браузере приложения Facebook, а постоянное меню требует, чтобы она была задана первой.
Работает ли текст приветствия?
На телефонах нет. Справка Meta теперь называется «[Deprecated] Greeting Text»: функция больше не работает в Messenger на Android и iOS. API может по-прежнему принимать свойство greeting, но клиенты его не увидят, поэтому Meta просит разработчиков его не использовать. Согласно документации, greeting содержит один текст на каждую локаль, обязательна локаль default, текст до 160 символов, персонализация через {{user_first_name}}, {{user_last_name}} или {{user_full_name}}, а задать его может только роль Administrator на Странице.
Как работают стартовые вопросы?
Они содержат до 4 вопросов, которые человек может нажать, чтобы начать переписку; вопрос публикуется в диалоге так, будто его задал человек, а его payload возвращается как событие postback. С апреля 2022 года они локализованы: каждый объект в ice_breakers содержит call_to_actions и locale, локаль default обязательна, а DELETE для ice_breakers удаляет все объекты. Meta ранжирует элементы, которые конкурируют за новую переписку:
- Стартовые вопросы API имеют приоритет над кнопкой Get Started, если заданы оба варианта.
- Оба стоят раньше пользовательских вопросов, заданных во входящих Страницы; их редактирование отключено, пока заданы стартовые вопросы API.
Как устроено постоянное меню?
Это массив меню, по одному на каждую локаль с обязательной локалью default; в каждом до 20 call_to_actions типа web_url или postback. Заголовок ограничен 30 символами, payload postback до 1 000, а composer_input_disabled со значением true оставляет меню, кнопки и webview единственным способом взаимодействия. Требования Meta перед появлением меню:
- Кнопка Get Started уже задана и есть разрешение
pages_messaging. - Страница опубликована, а приложение переведено в публичный режим.
- Тот, кто задаёт меню, имеет роль Administrator на Странице.
- Messenger v106 или новее на iOS или Android, вне встроенного браузера приложения Facebook.
- Изменения на уровне Страницы могут занять до 24 часов; меню для одного человека, заданное через
custom_user_settingsс PSID, обновляется в реальном времени.
Что такое команды?
Ключевые слова, которые человек может вызвать в любой момент из меню команд рядом с полем ввода, набрав косую черту или знак @, либо из всплывающего окна при вводе подходящего слова. На каждую локаль приходится от 1 до 100 команд; имя от 1 до 32 символов без ведущей косой черты, описание от 1 до 64 символов. Когда команды заданы, они имеют приоритет над постоянным меню. Вызванные команды приходят в приложение внутри события messages, в message.commands.
Что делают whitelisted_domains и account_linking_url?
Оба обслуживают сценарии вне самой переписки. whitelisted_domains перечисляет до 50 доменов, которые webview Messenger может открывать для Messenger Extensions SDK и плагина checkbox; каждый должен отдаваться по HTTPS и иметь полностью определённое имя, но не IP-адрес и не localhost, а задать список может только роль Administrator на Странице. account_linking_url является HTTPS-колбэком, который связывает аккаунт человека в Messenger с его аккаунтом у бизнеса.
Как easyCoexistence задаёт профиль Messenger Страницы?
Нет: ни один инструмент не вызывает {page-id}/messenger_profile, а токены Page не выдаются, поэтому настройка профиля выходит за рамки этого подключения. Команды, которые вызывают люди, приходят в событии messages, которое easyCoexistence пересылает и которое читают автоматизации. Нажатия, которые Meta передаёт как события messaging_postbacks, от Get Started, пунктов меню с postback и стартовых вопросов, не пересылаются, так как Страницы подписаны на feed, messages и mention.
Распространённые ошибки
- Задание постоянного меню до Get Started. Требования Meta включают кнопку Get Started, поэтому сначала задайте get_started.
- Пропуск локали по умолчанию. Стартовым вопросам, меню и командам нужен объект с locale, равным default, как запасным вариантом.
- Вызов API профиля в цикле. Meta разрешает 10 вызовов за 10 минут на одну Страницу, поэтому передавайте несколько свойств в одном POST.
- Ожидание мгновенного изменения меню. Обновление меню на уровне Страницы может занять до 24 часов, прежде чем дойдёт до людей.
Настройка профиля Messenger среди его инструментов не предусмотрена. От US$ 9 до US$ 0,75 за подключение в месяц, с падением цены по мере добавления подключений; первые 3 дня бесплатно.
Часто задаваемые вопросы
Может ли постоянное меню отличаться для каждого человека?
Да. custom_user_settings с PSID человека переопределяет меню Страницы для него, обновляется в реальном времени и допускает 10 вызовов на человека за 10 минут.
Какие локали поддерживает профиль Messenger?
Те, что есть в списке поддерживаемых локалей Meta, например en_GB, pt_BR или ja_JP, а также default, запасной вариант, который используется, когда ни одна локаль не совпадает с локалью человека.
Кто может менять профиль Messenger Страницы?
Приложение с токеном Страницы, в котором есть разрешение pages_messaging. Для постоянного меню, приветствия и списка доменов также нужна роль Administrator на Странице.
Сколько стоит easyCoexistence для Страницы Facebook?
Каждая Страница учитывается как одно подключение: от US$ 9 до US$ 0,75 за подключение в месяц; цена падает по мере роста числа подключений, а первые 3 дня бесплатны.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на