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

Поля вебхуков Instagram: полный список

Для профессионального аккаунта с Instagram Login таблица полей вебхуков Meta перечисляет comments, live_comments, messages, message_echoes, message_reactions, messaging_postbacks, messaging_referral, messaging_seen, messaging_optins, messaging_handover и standby; упоминания приходят внутри comments, а в примерах добавлено message_edit. Каждому полю нужно разрешение instagram_business_basic плюс instagram_business_manage_comments или, для большинства полей сообщений, instagram_business_manage_messages. Поле story_insights с Instagram Login не предлагается.

easyCoexistence подписывает каждый подключённый аккаунт Instagram на comments, messages и mentions и передаёт эти события на ваш HTTPS эндпоинт по мере поступления, подписанные секретом этого аккаунта.

8

Поля, на которые новый продукт Instagram в панели управления приложения подписан по умолчанию, среди них comments, messages и message_reactions.

Per app

Поля выбираются для приложения, а не для аккаунта: аккаунт получает поля, которые выбрало приложение.

Advanced Access

Уровень доступа, который руководство Meta по настройке указывает для вебхуков Instagram Login, а для уведомлений о comments и live_comments требует Advanced Access.

story_insights

Отмечено как недоступное для Instagram Login в таблице полей Meta, где поле предлагается с Facebook Login и Unified Login.

10 Sep 2025

Когда Meta добавила вебхук message_edit для Business Login for Instagram и Facebook Login for Business.

Какие поля вебхука предлагает Instagram Login?

Ниже приведены поля из таблицы полей Meta, с описанием того, что запускает каждое, по примерам таблицы и справочнику по вебхукам. Каждому полю также нужно instagram_business_basic сверх указанного разрешения, а для уведомлений о comments и live_comments Meta требует Advanced Access.

commentsA comment or reply on the account's posts, Reels, Stories or ads, @mentions included. instagram_business_manage_comments.
live_commentsA comment on the account's Live while it is broadcast. instagram_business_manage_comments.
mentionsNo field of its own with Instagram Login: Meta includes mentions in the comments notification.
messagesA DM: text, attachments, shares, Story replies and mentions, quick replies, deletions, and echoes of the account's own messages. instagram_business_manage_messages.
message_echoesListed with instagram_business_manage_comments; the account's own messages arrive on messages with is_echo set to true.
message_reactionsA person reacts to a message or removes the reaction. instagram_business_manage_messages.
message_editA person edits a message, with mid, text and num_edit. In Meta's examples and changelog, not in its fields table.
messaging_postbacksA tap on an ice breaker, a template's postback button or a persistent menu item. instagram_business_manage_messages.
messaging_referralAn ig.me link with a ref parameter, opened in an existing conversation. instagram_business_manage_messages.
messaging_seenA person reads a message, reported as read.mid. instagram_business_manage_messages.
messaging_optinsListed with instagram_business_manage_messages; Meta's Instagram examples show no payload for it.
messaging_handoverThread control passed, taken or requested between apps under the handover protocol. instagram_business_manage_messages.
standbyA message that arrives while another app controls the conversation. instagram_business_manage_messages.

Какие поля недоступны с Instagram Login?

Три строки таблицы полей Meta не имеют разрешения для Instagram Login, поэтому приложение с Instagram Login их не получает, и ещё одно поле существует только вне него:

  • story_insights: метрики сторис по истечении срока, с Facebook Login или Unified Login и разрешением instagram_manage_insights. Справочник Meta по медиа-инсайтам указывает, что вебхук insights не поддерживается с Instagram Login.
  • messaging_policy_enforcement и response_feedback: только в колонке для Instagram Messaging API от Meta.
  • mentions как отдельное поле: Facebook Login и Unified Login перечисляют его с instagram_manage_comments, тогда как Instagram Login включает упоминания в comments.

Как подписаться на поля?

В два этапа. В панели управления приложения, в настройках вебхука продукта Instagram, сохраните URL обратного вызова и токен верификации; это запускает запрос верификации Meta. Затем выберите поля. Новый продукт Instagram по умолчанию подписан на восемь из них. После этого подпишите каждый аккаунт методом POST /<IG_ID>/subscribed_apps на graph.instagram.com, передав subscribed_fields со списком полей, выбранных в панели, через запятую.

Subscribing one account to three fields
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
  ?subscribed_fields=comments,messages,message_reactions
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{ "success": true }

Может ли каждый аккаунт получать разные поля?

Нет. Руководство Meta по настройке говорит, что поля нельзя выбрать для аккаунта каждого пользователя приложения: аккаунт получает поля, выбранные для приложения. subscribed_fields в подписке аккаунта предназначен перечислять поля панели управления, поэтому обработчик должен ожидать любое поле, которое выбрало приложение, и решать по содержимому события, а не по тому, что один аккаунт запросил.

Как отличить поля в уведомлении?

По форме записи entry. Поля комментариев приходят в массиве changes, и каждое изменение называет своё поле. Поля сообщений приходят в массиве messaging без имени поля, и ключ рядом с sender, recipient и timestamp их различает:

  • changes[].field: comments или live_comments, с комментарием в value.
  • message: messages, включая эхо собственных сообщений аккаунта, у которых is_echo установлено в true.
  • реакция: message_reactions. postback: messaging_postbacks. прочтение: messaging_seen. редактирование: message_edit.
  • referral рядом с sender: messaging_referral. referral внутри message относится к messages, из нового диалога или рекламы Click-to-Direct.
  • pass_thread_control, take_thread_control или request_thread_control: messaging_handover, как перечисляет справочник вебхуков Meta.

На какие поля подписывается easyCoexistence?

comments, messages и mentions, список, на который подписывается каждый аккаунт Instagram при подключении. С Instagram Login упоминания приходят внутри comments, поэтому подписка охватывает комментарии и личные сообщения (DM): эхо, ответы на сторис, упоминания в сторис и вложения входят в личные сообщения. Остальные поля таблицы доставляются Meta приложению, подписанному на них, и не входят в подписку подключения. Когда эндпоинт задан через set_social_webhook_destination или Partner API, easyCoexistence проверяет подпись Meta, сразу отвечает Meta и отправляет на эндпоинт каждую запись аккаунта:

  • platform и external_id: instagram, и ID аккаунта Instagram, равный entry.id.
  • account_id: ID подключения в easyCoexistence, тот, который принимают инструменты MCP.
  • entry: запись Meta для аккаунта без изменений. Поле object от Meta и заголовок X-Hub-Signature-256 не передаются.
  • X-EC-Signature: t=<unix>,v1=<hex>, HMAC-SHA256 от метки времени, точки и исходного тела, ключом служит собственный секрет аккаунта.
  • Доставка: одна попытка, до 8 секунд, без перенаправлений, без сохранения копии и без повторов.

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

  • Ожидание поля mentions с Instagram Login. Meta включает упоминания в уведомление о комментариях, поэтому обработчик, привязанный к полю mentions, никогда не срабатывает.
  • Предположение, что аккаунт получает только поля, которые назвала его собственная подписка. Meta доставляет поля, выбранные для приложения, поэтому ветвите по содержимому каждого события.
  • Считать message.referral и referral верхнего уровня одним событием. Первое идёт в messages; второе это messaging_referral для ссылки ig.me, открытой в существующем диалоге.
  • Ожидание story_insights с Instagram Login. Meta помечает его там как недоступное, поэтому метрики сторис читайте из эндпоинта insights, пока сторис активна.
Настройка с EasyCoexistence

События по умолчанию не хранятся; аккаунт с включённой автоматизацией хранит свои DM и комментарии 7 дней. Задайте эндпоинт через set_social_webhook_destination из Claude или ChatGPT либо через Partner API. От US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений снижается, первые 3 дня бесплатно.

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

Есть ли у Instagram Login отдельное поле вебхука mentions?

Нет, отдельного поля нет. Meta включает упоминания в уведомление о комментариях для Instagram Login; mentions это самостоятельное поле с Facebook Login и Unified Login.

Доступен ли story_insights с Instagram Login?

Нет. Таблица полей Meta помечает его как недоступное для Instagram Login, а справочник по медиа-инсайтам указывает, что вебхук insights там не поддерживается.

Какие разрешения нужны вебхуку сообщений Instagram?

instagram_business_basic и instagram_business_manage_messages, с Advanced Access, который руководство Meta по настройке указывает для вебхуков Instagram Login.

Когда Meta добавила вебхук message_edit для Instagram?

10 сентября 2025 г., для Business Login for Instagram и Facebook Login for Business. Редактирование приходит в массиве messaging под ключом message_edit.

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

Вебхук комментариев Instagram: полезная нагрузка поле за полемЧто вебхук комментариев Instagram присылает при комментарии к постам и Reels аккаунта: поля полезной нагрузки, чего в ней нет и ловушки.Вебхук сообщений Instagram: тело DM, эхо и поляЧто вебхук сообщений Instagram передаёт для DM: IGSID отправителя, текст, вложения, ответы на сторис и эхо, поле за полем, и окно 24 часа.Вебхук message_reactions в Instagram: тело запроса при реакции и снятии реакцииЧто вебхук message_reactions Instagram отправляет, когда человек ставит реакцию на личное сообщение или убирает её: mid, action, reaction и emoji.Вебхук Instagram messaging_postbacks: айсбрейкеры и кнопкиЧто отправляет вебхук messaging_postbacks Instagram при нажатии айсбрейкера, кнопки или пункта меню: title, payload, mid и как настроить.Вебхук messaging_referral в Instagram: ссылки ig.me и рекламные переходыЧто Instagram передаёт в вебхуке messaging_referral при открытии ссылки ig.me с ref и куда приходят переходы из рекламы.Вебхук live_comments в Instagram: комментарии во время LiveЧто вебхук live_comments присылает в Instagram, пока аккаунт ведёт прямой эфир: данные, отличия от комментариев и ответ на комментарий Live.

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

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

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

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