ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

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 или вашего собственного кода; новые сообщения пересылаются на ваш эндпоинт по мере поступления.

10 per 10 min

Количество вызовов Messenger Profile API, разрешённых для Страницы в каждом 10-минутном интервале.

4 questions

Наибольшее число стартовых вопросов, которое задаёт API; если заданы оба варианта, стартовые вопросы API имеют приоритет над кнопкой Get Started.

20 items

Наибольшее число пунктов верхнего уровня в постоянном меню; заголовок каждого пункта ограничен 30 символами.

24 hours

Сколько может занять обновление постоянного меню на уровне Страницы; меню, заданное для одного человека, обновляется в реальном времени.

Deprecated

Текст приветствия, который, согласно справке Meta, больше не работает в Messenger на Android и iOS.

Что хранит профиль Messenger?

Настройки, с которых начинается работа Messenger на Странице. API профиля Messenger от Meta перечисляет эти свойства; каждое задаётся и читается через один и тот же эндпоинт. Для приложения в режиме разработки настройки видны только людям, имеющим роль в приложении:

get_startedThe payload sent as a messaging_postbacks event when someone taps Get Started
greetingLocale-specific welcome screen text, which Meta marks deprecated as of November 2026
ice_breakersUp to 4 questions a person can tap to start the conversation
persistent_menuUp to 20 buttons kept in the conversation, per locale
commandsKeywords a person can tap or type, each with a description
whitelisted_domainsUp to 50 HTTPS domains for the Messenger Extensions SDK and the checkbox plugin
account_linking_urlThe HTTPS callback for linking a person's account with the business
subject_to_new_eu_privacy_rulesRead-only flag for Pages affected by Meta's Messenger API updates for Europe

Как читаются, задаются и удаляются свойства?

Тремя методами на одном эндпоинте, вызываемом с токеном Страницы. POST принимает тело JSON со свойствами и перезаписывает только названные в нём, GET принимает fields в виде списка через запятую, а DELETE принимает тело JSON, где массив fields называет, что удалить; POST и DELETE возвращают result success. Кнопка Get Started и меню задаются одним вызовом:

Get Started and a persistent menu in one POST
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 часов, прежде чем дойдёт до людей.
Настройка с EasyCoexistence

Настройка профиля 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 дня бесплатны.

Читайте дальше

Messenger Send API: отправка сообщений со страницы FacebookКак страница Facebook отправляет сообщения Messenger через POST /{page-id}/messages: PSID, messaging_type, текст и вложения, ограничения и ошибки.Протокол передачи Messenger: общий доступ к диалогам Страницы для ИИ-агента и людейКак диалоги Messenger Страницы переходят между приложениями и Meta Business Suite: Conversation Routing, pass_thread_control и владелец треда.Теги сообщений Messenger в 2026 году: что может отправить страница Facebook после окна 24 часаЧто может отправить страница Facebook после 24-часового окна Messenger в 2026 году: HUMAN_AGENT, CUSTOMER_FEEDBACK, три отключённых тега и замены.Поля вебхука Страницы Facebook: полный списокMeta документирует 64 поля вебхука Страницы Facebook: feed, mention, поля Messenger вроде messages и поля профиля, а также нужное разрешение.Вебхук Messenger для Facebook Page: сообщения и упоминанияПоля вебхука Facebook Page для сообщений Messenger и упоминаний: формат тела запроса, ID отправителей, вложения и доставка событий на ваш эндпоинт.Разрешения Facebook Page API и требования App ReviewДевять разрешений Facebook Page, что открывает каждое и что App Review требует: расширенный доступ, верификация бизнеса, запись экрана.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на