Протокол передачи Messenger: общий доступ к диалогам Страницы для ИИ-агента и людей
Meta заменила протокол передачи для Messenger на Conversation Routing, который сохранил вызовы управления тредом: pass_thread_control передаёт диалог другому приложению, например Meta Business Suite с app ID 263902037430900, take_thread_control забирает его, request_thread_control запрашивает управление, а release_thread_control возвращает тред в простой. При включённой маршрутизации приложение, управляющее тредом, получает его сообщения, а остальные получают их по каналу standby.
easyCoexistence даёт вашему ИИ-агенту диалоги Messenger Страницы через один коннектор MCP: send_social_dm отвечает в пределах окна обслуживания клиентов, а новые сообщения пересылаются на ваш эндпоинт по мере поступления.
target_app_id, который Meta выдаёт для передачи управления диалогом в Meta Business Suite.
Подкод ошибки 10 для сообщения, которое не отправилось, потому что диалог контролирует другое приложение.
Если человек не пишет в течение 24 часов, тред переходит в простой, и отправлять может только приложение по умолчанию.
На сколько extend_thread_control может продлить управление приложения за пределы окна обслуживания клиентов.
Управлять диалогами с вашим Business AI: при выключенной опции отправки без тега в диалог Business AI завершаются с кодом 10, подкодом 2018300.
Что случилось с протоколом передачи?
Meta включила его в Conversation Routing. В руководстве сказано, что Meta больше не поддерживает протокол передачи для Messenger, что бизнес перенесён на Conversation Routing и что маршрутизация обратно совместима с большинством вызовов протокола передачи, поэтому pass_thread_control, take_thread_control и вебхук messaging_handovers должны продолжать работать. Изменилось то, кто принимает решение: бизнес задаёт приложение по умолчанию и правила маршрутизации в настройках Страницы, в разделе Conversation Routing.
Кто контролирует диалог?
Одно приложение за раз, которое Meta называет владельцем треда. Тред активен, пока человек и владеющее приложение общаются, и переходит в простой, если человек не писал 24 часа или владелец снял управление; в простое отправлять может только приложение по умолчанию, в пределах окна обслуживания клиентов. Правила маршрутизации определяют, кто берёт тред:
- Приложение по умолчанию: отвечает, когда никакое другое приложение не настроено или не отвечает.
- Social routing: приложение, которое берёт управление, когда человек открывает тред в простое или нажимает «Get Started».
- Link routing: приложение, назначенное каждой ссылке m.me.
- Campaign routing: приложение, выбранное для рекламы Click-to-Messenger; оно управляет диалогом в пределах окна обслуживания клиентов, до 7 дней.
Какие вызовы переводят управление между приложениями?
Каждый вызов это POST-запрос к edge Страницы, где recipient указывает PSID человека, и каждый в ответе возвращает success true. Большинство также принимает строку metadata, которую получит следующее приложение:
pass_thread_control: передаёт тред приложению изtarget_app_id, которое получает событиеmessaging_handovers.release_thread_control: завершает управление приложения и возвращает тред в простой.take_thread_control: делает вызывающее приложение владельцем, для приложений, которым бизнес разрешает брать управление.request_thread_control: запрашивает управление диалогом.extend_thread_control: сохраняет управление дольше окна обслуживания клиентов, до 7 дней; длительность задаётся в секундах.- Send API может передать или снять управление вместе с самим сообщением через объект
thread_control.
POST /{page-id}/pass_thread_control
?recipient={id:<PSID>}
&target_app_id=263902037430900
&metadata=Customer asked for a person
{ "success": true }Как люди подключаются к Meta Business Suite?
Ответом. Conversation Routing считает Meta Business Suite ещё одним подключённым приложением, которое бизнес может назначить приложением по умолчанию. Когда кто-то отвечает там в диалоге, который Meta Business Suite не контролирует, или переносит диалог в папку «Основные», Meta Business Suite берёт управление. Приложение передаёт диалог людям через pass_thread_control с target_app_id 263902037430900, а приложение, которое пересылает ответ человека после окна обслуживания клиентов, отправляет его с тегом HUMAN_AGENT в течение 7 дней после последнего сообщения человека.
Что происходит, когда Business AI от Meta владеет диалогом?
Другие приложения получают сообщения человека по каналу standby и не должны на них отвечать. Руководство Meta советует начинать отвечать после события messaging_handovers с pass_thread_control. Уведомление messages может содержать admin_text и handoff_reason, например human_requested или purchase_intent, но не передаёт владение. Если опция «Управлять диалогами с вашим Business AI» выключена, что является значением по умолчанию, отправка без тега в такой диалог завершается ошибкой с кодом 10, подкодом 2018300.
Как приложение проверяет, кто владеет тредом?
GET /{page-id}/thread_owner с recipient, равным PSID, возвращает app_id владеющего приложения и время окончания его управления; ответ получает сам владелец или приложение Страницы по умолчанию. Поле is_owner в Conversations API отвечает на тот же вопрос для каждого диалога, когда маршрутизация включена. GET /{page-id}?fields=messaging_feature_status показывает статус Conversation Routing Страницы в полях вроде msgr_multi_app.
Что происходит без Conversation Routing?
Meta называет это поведением по умолчанию. Оно рассчитано на Страницу с одним подключённым приложением, которое получает сообщения и отвечает на них само. Все подключённые приложения получают вебхуки сообщений и могут ответить на одно и то же сообщение; take_thread_control заблокирован, пока не задано приложение по умолчанию, и доступна только Campaign routing. Совет Meta для такой схемы: согласовать приложение и Meta Business Suite, чтобы никто не отвечал на одно сообщение дважды.
Что делает easyCoexistence в общем диалоге?
Он подписывает каждую Страницу на feed, messages и mention, но не на messaging_handovers, standby или message_echoes. Поэтому он пересылает сообщения человека, пока его приложение их получает, и не видит ни событий передачи, ни ответов, отправленных из Meta Business Suite. send_social_dm отправляет RESPONSE без thread_control; когда Meta отказывает в отправке, потому что другое приложение держит диалог, инструмент возвращает вашему ИИ код 10 и сообщение Meta. Вызовов управления тредом, thread_owner и is_owner среди его инструментов нет.
Распространённые ошибки
- Ответы на сообщения standby. Они приходят приложению, которое не владеет тредом; дождитесь pass_thread_control, прежде чем отвечать.
- Принимать admin_text за передачу. Уведомление messages с контекстом передачи не переносит владение; это делает только событие messaging_handovers.
- Запускать ИИ и Meta Business Suite параллельно без маршрутизации. При поведении по умолчанию получают оба, а Meta просит согласовать работу, чтобы не было двух ответов.
- Удерживать тред после окончания сценария. Meta рекомендует снимать управление сразу, как приложение закончило работу, а не ждать, пока истечёт время ответа.
Вызовов управления тредом Meta среди его инструментов нет; человек берёт диалог на себя, ответив в Meta Business Suite. От US$ 9 за подключение в месяц, до US$ 0,75 по мере добавления подключений, с бесплатным пробным периодом на 3 дня.
Часто задаваемые вопросы
Нужна ли Conversation Routing, если на одной Странице два приложения для Messenger?
Meta рекомендует её, когда подключено несколько приложений для сообщений и каждое должно отвечать на определённые диалоги. Если одно приложение получает сообщения и отвечает на них, достаточно поведения по умолчанию.
Как долго приложение удерживает управление диалогом?
До тех пор, пока оно не снимет управление или тред не перейдёт в простой, через 24 часа после последнего сообщения человека. extend_thread_control добавляет время, до 7 дней.
Доходит ли ответ из Meta Business Suite до других приложений?
Приложения, подписанные на message_echoes, получают его как echo, у которого app_id равен 263902037430900, ID Meta Business Suite. Так описано в журнале изменений Meta для Graph API v12.0 и новее.
Что происходит с ответами easyCoexistence, когда человек отвечает из Meta Business Suite?
При включённом Conversation Routing управление переходит к Meta Business Suite. Пока оно не вернулось, сообщения человека доходят до приложения easyCoexistence только по каналу standby, на который оно не подписано. Без маршрутизации оба приложения продолжают их получать.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на