Поля вебхуков 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 эндпоинт по мере поступления, подписанные секретом этого аккаунта.
Поля, на которые новый продукт Instagram в панели управления приложения подписан по умолчанию, среди них comments, messages и message_reactions.
Поля выбираются для приложения, а не для аккаунта: аккаунт получает поля, которые выбрало приложение.
Уровень доступа, который руководство Meta по настройке указывает для вебхуков Instagram Login, а для уведомлений о comments и live_comments требует Advanced Access.
Отмечено как недоступное для Instagram Login в таблице полей Meta, где поле предлагается с Facebook Login и Unified Login.
Когда Meta добавила вебхук message_edit для Business Login for Instagram и Facebook Login for Business.
Какие поля вебхука предлагает Instagram Login?
Ниже приведены поля из таблицы полей Meta, с описанием того, что запускает каждое, по примерам таблицы и справочнику по вебхукам. Каждому полю также нужно instagram_business_basic сверх указанного разрешения, а для уведомлений о comments и live_comments Meta требует Advanced Access.
Какие поля недоступны с 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 со списком полей, выбранных в панели, через запятую.
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, пока сторис активна.
События по умолчанию не хранятся; аккаунт с включённой автоматизацией хранит свои 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.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на