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

Messenger Send API: отправка сообщений со страницы Facebook

Страница Facebook отправляет сообщения Messenger через POST /{page-id}/messages с токеном доступа страницы: получатель указывается идентификатором в рамках страницы (PSID), messaging_type имеет значение RESPONSE или UPDATE внутри стандартного окна обслуживания клиентов либо MESSAGE_TAG после него, а в поле message передаётся текст или вложение, например изображение, аудио, видео или файл. Meta возвращает recipient_id и message_id.

easyCoexistence отвечает на личные сообщения в Messenger через send_social_dm из Claude, ChatGPT или вашего кода в пределах 24-часового окна, текстом; медиа, быстрые ответы и шаблоны не поддерживаются.

300 per second

Вызовы Send API, которые приложение может сделать на страницу для сообщений с текстом, ссылками, реакциями и стикерами.

10 per second

Вызовы Send API, которые приложение может сделать на страницу для сообщений с аудио или видео.

25 MB

Наибольший ресурс, который Messenger Platform сохраняет для повторного использования: изображение, загруженное по URL, ограничено 8 МБ.

30 images

Максимальное число изображений в массиве attachments одного сообщения; это единственный тип медиа, допустимый в нём.

90 days

Срок жизни сохранённого attachment_id, после которого медиа нужно загрузить повторно.

Что содержит запрос Send API?

Meta перечисляет шесть компонентов, которые должна содержать отправка: идентификатор отправляющей страницы, идентификатор получателя, токен доступа страницы, разрешение от человека, тип сообщения и его содержимое. Запрос представляет собой POST с JSON на /{page-id}/messages; ответ человеку, который только что написал, выглядит так:

A text reply, and Meta's answer
POST /{page-id}/messages
{
  "recipient": { "id": "<PSID>" },
  "messaging_type": "RESPONSE",
  "message": { "text": "Your order ships tomorrow." }
}

{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }

Какой ID указывать в recipient?

Обычно это идентификатор в рамках страницы, или PSID, который Meta присваивает человеку при первом сообщении странице; он приходит как sender.id в вебхуке сообщений. Объект recipient принимает и другие виды ID для отдельных случаев:

  • id: PSID, уникальный для этого человека и этой страницы.
  • user_ref: для человека, который написал странице через плагин или кнопку postback.
  • comment_id или post_id: для приватного ответа на комментарий или публикацию посетителя.
  • ID из Facebook Login привязаны к приложению и не работают в Messenger Platform.

Какой messaging_type должно иметь сообщение?

Тип сообщает Meta, почему оно отправляется, и определяет, когда отправка разрешена. В справочнике Meta по сообщениям страницы перечислены четыре значения:

  • RESPONSE: ответ на сообщение, полученное страницей, рекламное или нет, в стандартном окне обслуживания клиентов.
  • UPDATE: сообщение, которое страница отправляет по собственной инициативе, рекламное или нет, тоже в пределах окна.
  • MESSAGE_TAG: нерекламное сообщение, отправленное после окна, с тегом, соответствующим одобренному сценарию использования.
  • UTILITY: служебное сообщение по одобренному шаблону, например о заказе или записи на приём.

Что может нести сообщение?

Текст или один объект вложения с типом и полезной нагрузкой: вложения-изображения, аудио, видео и файлы указывают на URL или сохранённый attachment_id, а шаблонные вложения передают структурированные сообщения с кнопками. Тот же эндпоинт принимает и эти параметры:

  • attachments: массив до 30 изображений, отправляемых одним сообщением.
  • reply_to с mid: ответ на конкретное предыдущее сообщение, от человека или от страницы.
  • quick_replies: до 13 кнопок над полем ввода, у каждой заголовок до 20 символов.
  • sender_action: индикатор набора, отметка о прочтении или реакция; отправляется отдельным запросом, а не вместе с самим сообщением.
  • notification_type: REGULAR по умолчанию, либо SILENT_PUSH или NO_PUSH.

Каким может быть размер вложений?

Руководство Meta по сохранению ресурсов задаёт ограничения для медиа, которые Messenger Platform получает и хранит: ресурсы до 25 МБ, изображения до 8 МБ при загрузке по URL, аудио с Content-Type для аудио, а видео забирается в течение 75 секунд. При is_reusable, равном true, возвращается attachment_id, который может повторно использовать только страница, отправившая его, в течение 90 дней; POST /{page-id}/message_attachments загружает медиа заранее.

Какие ограничения частоты запросов у Send API?

Meta считает их по страницам и по типу содержимого. В справочнике Meta по сообщениям страницы в списке ошибок отправки есть код 613: «Вызовы к этому API превысили ограничение частоты запросов». Поэтому при его появлении нужно замедлиться, а не повторять сразу:

  • 300 вызовов в секунду на страницу для сообщений с текстом, ссылками, реакциями и стикерами.
  • 10 вызовов в секунду на страницу для сообщений с аудио или видео.
  • Слишком много сообщений в одну переписку может ограничиваться отдельно.
  • Общее число вызовов Messenger API: в 200 раз больше числа вовлечённых пользователей за скользящие 24 часа.
  • Свыше 40 сообщений в секунду папка входящих страницы перестаёт показывать новые сообщения, и страница не может отправлять, пока объём не снизится.

Какие ошибки возвращает Send API?

В таблице ошибок Messenger у Meta каждый код соотнесён с подкодом, который называет причину. Ниже те, с которыми страница чаще всего сталкивается при отправке:

  • 10 с 2018278 или 2534022: это сообщение отправлено вне допустимого окна.
  • 10 с 2018300: переписку контролирует другое приложение.
  • 100: неверный параметр, например неправильный ID получателя; подкод 2018001 означает «Подходящий пользователь не найден».
  • 551: человек недоступен, возможно, заблокировал страницу или деактивировал аккаунт; 200 с 1545041 означает «Этот человек сейчас недоступен».
  • 200 с 2018028: приложение не может писать людям вне своих ролей, пока pages_messaging не пройдёт проверку и приложение не будет в рабочем режиме.
  • 10904: в настройках страницы отключены сообщения.

Как easyCoexistence отправляет через него?

send_social_dm принимает account_id, recipient_id получателя, который является sender.id в пересланном событии messages, и текст, и отправляет их на /{page-id}/messages с messaging_type RESPONSE. Результатом становится ответ Meta с message_id; при отказе возвращаются код ошибки Meta и её описание. Медиа, быстрые ответы, шаблоны и действия отправителя среди инструментов отсутствуют: send_social_dm отправляет текст.

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

  • Отправка индикатора набора вместе с сообщением. Meta требует, чтобы sender_action отправлялся отдельно, только с получателем, а текст или шаблоны шли отдельным запросом.
  • Серия быстрых отправок одному человеку. Meta может ограничить одну переписку отдельно, помимо 300 вызовов в секунду на страницу.
  • Отправка аудио или видео в темпе текста. Сообщения с аудио или видео ограничены 10 вызовами в секунду на страницу.
  • Повторное использование attachment_id старше 90 дней. Сохранённые идентификаторы вложений истекают, поэтому для нового нужно загрузить медиа заново.
Настройка с EasyCoexistence

Автоматизации сами отвечают на новые сообщения фиксированным текстом или ответом ИИ. От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений; первые 3 дня бесплатно.

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

Бесплатен ли Messenger Send API?

Да, для стандартных сообщений. Обзор Meta называет Messenger Platform бесплатной для использования, поэтому страница, отвечающая людям, которые ей написали, не платит за каждое сообщение; маркетинговые сообщения тарифицируются за сообщение.

Какая задача страницы нужна для отправки сообщения?

В обзоре Messenger Meta требуется токен страницы от человека, который может выполнять задачи MESSAGING и MODERATE, при предоставленном разрешении pages_messaging.

Может ли easyCoexistence отвечать изображениями в Messenger?

Сейчас нет. send_social_dm отправляет текст, и ни один инструмент не отправляет вложения.

Сколько стоит easyCoexistence для страницы Facebook?

Каждая подключённая страница считается одним подключением. Оплата от US$ 9 до US$ 0,75 за подключение в месяц в зависимости от их общего числа; первые 3 дня бесплатно.

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

Теги сообщений Messenger в 2026 году: что может отправить страница Facebook после окна 24 часаЧто может отправить страница Facebook после 24-часового окна Messenger в 2026 году: HUMAN_AGENT, CUSTOMER_FEEDBACK, три отключённых тега и замены.Чтение истории диалогов Messenger через APIЧитайте историю Messenger Facebook Page через Conversations API: /{page-id}/conversations, поля сообщений, лимит 20 сообщений и разрешения.Окно 24 часа в Messenger: когда страница Facebook может написать человекуКогда страница Facebook может написать человеку в Messenger: стандартное окно 24 часа, действия, которые его открывают, и до 7 дней после рекламы.Протокол передачи Messenger: общий доступ к диалогам Страницы для ИИ-агента и людейКак диалоги Messenger Страницы переходят между приложениями и Meta Business Suite: Conversation Routing, pass_thread_control и владелец треда.Ошибка Facebook 10: доступ запрещён или сообщение вне разрешённого окнаОшибка Facebook 10: «Application does not have permission for this action» или в Messenger «This message is sent outside of allowed window».Ошибка Facebook 551: человек недоступен в MessengerОшибка Facebook 551: Messenger не смог доставить сообщение. Человек мог заблокировать Страницу или деактивировать аккаунт.

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

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

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

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