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

Чтение истории диалогов Messenger через API

История переписки Facebook Page в Messenger читается запросом GET /{page-id}/conversations?platform=messenger, который возвращает ID диалогов со временем последнего обновления. Затем GET /{conversation-id}?fields=messages даёт ID сообщений, а GET /{message-id} для каждого сообщения возвращает отправителя, получателя, текст и вложения. Meta отдаёт подробности только для 20 последних сообщений диалога, а вызовы требуют токена доступа Page с разрешением pages_messaging.

easyCoexistence пересылает новые сообщения Messenger Page на ваш эндпоинт по мере поступления, а send_social_dm отвечает внутри окна обслуживания клиентов (24 часа), из Claude, ChatGPT или вашего собственного кода.

20 messages

Подробности возвращаются только для 20 последних сообщений диалога; более старые дают ошибку о том, что сообщение удалено.

2 per second

Количество вызовов Conversations API, которые приложение может сделать для одной Facebook Page.

30 days

Диалоги в папке «Запросы», которые не были активны столько времени, не включаются в результаты API.

MESSAGING or MODERATE

Задача Page, которую должен уметь выполнять человек, стоящий за токеном, чтобы читать диалоги.

80006

Ошибка при слишком большом числе вызовов Messenger API к аккаунту Page; Meta советует подождать и повторить попытку.

Как получить список диалогов Page?

Запросом GET /{page-id}/conversations с параметром platform, равным messenger. Результат содержит массив data с ID диалогов, у каждого есть updated_time, время добавления последнего сообщения, и объект paging. В справке Meta указано, что пагинация по времени на этом эндпоинте недоступна, поэтому для перехода по списку используйте объект paging.

Listing a Page's Messenger conversations
GET /{page-id}/conversations?platform=messenger

{
  "data": [
    { "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
    { "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
  ],
  "paging": { ... }
}

Как найти диалог с одним человеком?

Добавьте в тот же запрос параметр user_id со значением Page-scoped ID этого человека. Meta вернёт ID диалога между Page и этим человеком. Это самый короткий путь от вебхука messages, где PSID приходит как sender.id, к истории, которая за ним стоит:

One person's conversation
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>

{ "data": [ { "id": "<CONVERSATION_ID>" } ] }

Как прочитать сообщения в диалоге?

В два шага. GET /{conversation-id} с fields=messages возвращает ID сообщений диалога, каждый с created_time, сначала самые новые. Затем GET /{message-id} с нужными полями, например id, created_time, from, to, message и reply_to, возвращает содержимое одного сообщения. По умолчанию возвращаются id и created_time, а поле без данных в ответ не попадает.

Какие поля можно прочитать?

Диалог и сообщение отдают разные поля. Ниже перечислены те, что Meta указывает в справке по сообщениям Page:

  • Диалог: id, updated_time, participants с ID, name и email, messages, а также is_owner, когда включена Conversation Routing.
  • Сообщение: id, created_time, from и to, каждый с ID, name и email, и message, текст, который пуст, если его нет.
  • attachments: файлы, изображения и видео с URL в CDN, а также is_unsupported, который приходит только тогда, когда сообщение содержит неподдерживаемое содержимое.
  • reactions, reply_to с mid сообщения, на которое дан ответ, и is_self_reply, а также shares для опубликованных постов и reels.
  • tags: папка и источник сообщения, например inbox, read или source:chat.

Как далеко назад можно читать?

На всю глубину диалога для ID, но не для содержимого. В руководстве Meta сказано, что эндпоинт диалога возвращает все ID сообщений, а подробности приходят только для 20 последних сообщений; запрос более старого даёт ошибку о том, что сообщение удалено. Диалоги в папке «Запросы», неактивные 30 дней, не возвращаются вовсе.

Какие разрешения и задачи нужны?

Токен доступа Page от человека, который может выполнять задачу MESSAGING или MODERATE на Page, с разрешениями pages_manage_metadata, pages_read_engagement и pages_messaging. Чтение диалогов с людьми, у которых нет роли в приложении, на Page или в бизнесе, требует Advanced Access, который Meta выдаёт через App Review.

Какие ограничения действуют на вызовы?

Ограничения частоты запросов Meta дают Conversations API 2 вызова в секунду на Page. Вызовы сверх лимита возвращают код 613 или 80006 с текстом «There have been too many messenger api calls to this Page account». Page, которая упирается в высокий лимит Meta, например при отправке более 40 сообщений в секунду, не может получить список диалогов, пока нагрузка не снизится, но один диалог по-прежнему можно проверять на новые сообщения.

Когда использовать API вместо вебхуков?

Для прошлого. Вебхуки доставляют новые сообщения по мере их поступления, а Meta отмечает, что прошлые уведомления позже не запросить. Поэтому Conversations API нужен, чтобы интеграция прочитала то, что пришло до её подключения, или наверстала упущенное после простоя. При включённой Conversation Routing поле is_owner сужает список до диалогов, на которые отвечает приложение, и Meta рекомендует это для восстановления после простоя.

Как easyCoexistence читает историю Messenger?

Он не читает историю. Page подключается с разрешениями pages_messaging, pages_manage_metadata и pages_read_engagement, но ни один инструмент не вызывает Conversations API, а токены Page не выдаются. Новые сообщения поступают на ваш эндпоинт через set_social_webhook_destination по мере прихода и передаются без сохранения копии, так что ваша собственная система хранит нужную ей историю.

Распространённые ошибки

  • Ожидание содержимого сообщений в запросе списка. Эндпоинт диалогов возвращает ID сообщений; поля каждого сообщения читайте из /{message-id}.
  • Расчёт на всю историю. Подробности доступны только для 20 последних сообщений, поэтому сохраняйте нужное из вебхуков по мере поступления сообщений.
  • Опрос на новые сообщения. При 2 вызовах в секунду на Page цикл опроса быстро упрётся в ограничение частоты запросов, тогда как вебхук messages доставляет сообщения сразу.
  • Пагинация диалогов по дате через since и until. Пагинация по времени на эндпоинте диалогов недоступна; используйте объект paging.
Настройка с EasyCoexistence

Инструмента для Conversations API нет, поэтому более раннюю историю читают в Meta Business Suite. От US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений цена снижается, с бесплатным пробным периодом на первые 3 дня.

Часто задаваемые вопросы

Входит ли в Conversations API сообщения самой Page?

Да. Поля from и to в сообщении указывают человека или Page, поэтому сообщения диалога включают обе стороны.

Можно ли читать диалоги Messenger без App Review?

Людям с ролью в приложении или на Page достаточно Standard Access. Для диалогов с любыми другими людьми нужен Advanced Access, который выдаётся через App Review.

Может ли Conversations API отправлять ответы?

Нет. В справке Meta по диалогам сказано, что этот эндпоинт не публикует сообщения; ответы отправляются через Send API по адресу /{page-id}/messages.

Сохраняет ли easyCoexistence мои диалоги Messenger?

Не по умолчанию. Пересланные события передаются дальше без сохранения копии. Если включена автоматизация, текст сообщений хранится 7 дней, а журналы её запусков 30 дней.

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

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

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

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

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

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