Чтение истории диалогов 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 последних сообщений диалога; более старые дают ошибку о том, что сообщение удалено.
Количество вызовов Conversations API, которые приложение может сделать для одной Facebook Page.
Диалоги в папке «Запросы», которые не были активны столько времени, не включаются в результаты API.
Задача Page, которую должен уметь выполнять человек, стоящий за токеном, чтобы читать диалоги.
Ошибка при слишком большом числе вызовов Messenger API к аккаунту Page; Meta советует подождать и повторить попытку.
Как получить список диалогов Page?
Запросом GET /{page-id}/conversations с параметром platform, равным messenger. Результат содержит массив data с ID диалогов, у каждого есть updated_time, время добавления последнего сообщения, и объект paging. В справке Meta указано, что пагинация по времени на этом эндпоинте недоступна, поэтому для перехода по списку используйте объект paging.
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, к истории, которая за ним стоит:
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.
Инструмента для 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 дней.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на