Вебхук комментариев Instagram: полезная нагрузка поле за полем
Поле comments вебхука Instagram уведомляет приложение, когда кто-то комментирует посты или Reels профессионального аккаунта либо отвечает на комментарий к ним. Meta присылает изменение, где field равен comments, а value содержит id и text комментария, Instagram-scoped ID и имя пользователя автора в from, id медиа и media_product_type, а также parent_id, если комментарий является ответом.
easyCoexistence подписывает каждый подключённый аккаунт Instagram на comments и пересылает события comments, которые Meta доставляет для него, на ваш HTTPS-эндпоинт по мере поступления, подписанные секретом этого аккаунта, без хранения копии.
Присутствует, когда комментарий является ответом, и содержит ID комментария, на который он отвечает.
Добавляется в from, когда аккаунт комментирует собственное медиа, рядом с ID самого аккаунта.
Отдельное поле для комментариев во время трансляции Live; уведомления по нему прекращаются по окончании трансляции.
Требуется для уведомлений comments и live_comments; медиа приватных аккаунтов не порождает ни одного уведомления.
Оставшееся время, чтобы отправить автору комментария один личный ответ, адресованный по ID комментария.
Когда срабатывает поле comments?
Когда кто-то комментирует медиа, которым владеет профессиональный аккаунт, или упоминает аккаунт, при условии что и приложение, и аккаунт подписаны на это поле. Каждый комментарий составляет одно изменение в уведомлении, и эти случаи имеют одинаковую структуру:
- Новый комментарий к посту, Reels, Stories или рекламе, с полем media.
media_product_type, которое указывает, на какой поверхности находится медиа. - Ответ на существующий комментарий, который содержит
parent_idс ID комментария, на который он отвечает. - Комментарий, который аккаунт оставляет к собственному медиа, включая ответы на него: from.id равен ID самого аккаунта, а в from добавляется
self_ig_scoped_id. - Упоминание аккаунта (@mention): при Instagram Login Meta включает упоминания в уведомление comments, а не в отдельное поле.
- Комментарий во время трансляции Live приходит по отдельному полю
live_commentsс той же структурой значения и прекращается по окончании трансляции.
Как выглядит уведомление о комментарии?
POST-запрос, в JSON которого object равен instagram и есть массив entry. Каждый элемент entry соответствует одному профессиональному аккаунту: его ID, время отправки уведомления Meta и массив changes с одним изменением на каждый комментарий. Ответ на Reels выглядит так:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"parent_id": "<PARENT_COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": {
"id": "<INSTAGRAM_SCOPED_ID>",
"username": "<USERNAME>"
},
"media": {
"id": "<MEDIA_ID>",
"media_product_type": "REELS"
}
}
}
]
}
]
}Что означает каждое поле?
Поля, которые справочник вебхука Meta перечисляет для комментария, от внешних к внутренним:
- entry[].id: ID профессионального аккаунта, то есть
user_id, который возвращает /me для него. По нему определяется, какому аккаунту принадлежит комментарий. - entry[].time: время отправки уведомления Meta в формате Unix timestamp. Это не время написания комментария.
- changes[].field: comments или
live_commentsдля трансляции Live. Проверьте его перед чтением value. - value.id: ID комментария, на который отвечают публично или лично, который скрывают или удаляют.
- value.text: текст комментария, он включается, если в комментарии есть текст.
- value.from.id и value.from.username: Instagram-scoped ID и имя пользователя автора. Поле value.from.
self_ig_scoped_idпоявляется, когда комментарий написал сам аккаунт. - value.media.id и value.media.
media_product_type: медиа, к которому оставлен комментарий, и его место размещения; справочник Meta по медиа называет AD, FEED, STORY и REELS. - value.
parent_id: в ответе ID комментария, на который он отвечает. У комментария верхнего уровня этого поля нет. - value.media.
ad_id,ad_titleиoriginal_media_id: перечислены в справочнике для комментариев к рекламе.
Чего поле comments не передаёт?
Некоторых вещей, которые может ожидать обработчик, в событии нет или они не присылаются, по руководству по настройке и справочникам Meta:
- Комментарии к медиа приватного аккаунта: Meta не присылает по ним уведомления ни о комментариях, ни об упоминаниях.
- ID альбомов: событие их не включает, и Meta советует искать альбом по ID комментария.
- ID рекламы для медиа, которое используется в динамической рекламе.
- Время создания комментария: GET /<
COMMENT_ID>?fields=timestamp возвращает его в формате ISO 8601. - Комментарии Live после окончания трансляции, когда уведомления по live-медиа прекращаются.
- Упоминания в Stories: API упоминаний Meta их не поддерживает, и они приходят аккаунту как личные сообщения.
- Прошлые события: Meta не хранит историю уведомлений для запросов, поэтому сохраняйте нужное по мере поступления каждого.
Что нужно полю comments?
При Instagram Login нужны разрешения instagram_business_basic и instagram_business_manage_comments, а также Advanced Access, который Meta требует для уведомлений comments и live_comments. Приложение должно быть переведено в режим Live и подписано на comments в App Dashboard, а каждый аккаунт подписывается через POST /<IG_ID>/subscribed_apps, где в subscribed_fields указан comments. Meta настоятельно рекомендует этот вебхук вместо опроса для комментариев, поскольку он экономит ограничение частоты запросов.
Как ответить на комментарий из события?
Используя переданные в нём ID. POST /<COMMENT_ID>/replies с message публично отвечает под комментарием по value.id. POST /<IG_ID>/messages с recipient.comment_id, равным value.id, отправляет автору один личный ответ в течение 7 дней после комментария или пока длится трансляция Live. from.id является Instagram-scoped ID, но личное сообщение, отправленное напрямую на него, не пройдёт, пока человек сам не написал аккаунту, поэтому личный ответ и есть способ связаться с ним в DM.
Как easyCoexistence пересылает комментарий?
Сразу по мере поступления, как только для аккаунта задан эндпоинт через set_social_webhook_destination из Claude или ChatGPT либо через PUT /channels/:id/webhook в Partner API. easyCoexistence подписывает каждый подключённый аккаунт на поля, в которых приходят его комментарии, упоминания и личные сообщения, проверяет подпись Meta на каждой доставке, немедленно отвечает Meta и отправляет каждый entry этого аккаунта POST-запросом на ваш HTTPS-URL в конверте:
- platform и
external_id: instagram и Instagram ID аккаунта, равный entry.id. account_id: ID подключения в easyCoexistence, тот, который возвращаетlist_social_accountsи принимают инструменты MCP.- entry: entry Meta для аккаунта без изменений, поэтому пакетная доставка превращается в один POST на каждый entry. Поле object Meta и X-Hub-Signature-256 не передаются.
- Доставка: одна попытка с ожиданием до 8 секунд, без следования перенаправлениям, на HTTPS-адрес, который разрешается в публичный IP. Копии не хранятся, повторы не выполняются.
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"media": { "id": "<MEDIA_ID>", "media_product_type": "FEED" }
}
}
]
}
}Что делают правила «комментарий в DM» с тем же событием?
Они читают то же событие параллельно с пересылкой. Правило срабатывает, когда комментарий содержит одно из его ключевых слов без учёта регистра, на одном выбранном посте или на всех, и отправляет автору правила DM как личный ответ, а также публичный ответ, если он задан в правиле. Комментарии самого аккаунта пропускаются, автоматизации, которые запускаются по комментарию, получают те, на которые ни одно правило не ответило, а комментарий, на который ответило правило, всё равно доходит до вашего эндпоинта. Публичный ответ правила может вернуться как новое событие comments от самого аккаунта.
Распространённые ошибки
- Поиск comment_id. При Instagram Login ID комментария находится в value.id, а comment_id относится к полезным нагрузкам других вариантов входа Meta.
- Ответы на собственные комментарии аккаунта. Они приходят как события comments с from.id, равным entry.id, и автоматизация, которая отвечает на них, начинает разговаривать сама с собой.
- Чтение entry.time как времени комментария. Это поле фиксирует, когда Meta отправила уведомление; собственное поле timestamp комментария показывает, когда он был написан.
- Ожидание комментариев Live в поле comments. Они приходят в live_comments, которому нужна собственная подписка и которое замолкает по окончании трансляции.
Правила «комментарий в DM» и автоматизации отвечают на те же комментарии круглосуточно. Цена от US$ 9 до US$ 0,75 за подключение в месяц, снижается по мере добавления подключений, с бесплатным пробным периодом на первые 3 дня.
Часто задаваемые вопросы
Включает ли вебхук комментариев Instagram ответы на комментарии?
Да. Ответ приходит как отдельное событие comments, в котором parent_id содержит ID комментария, на который он отвечает.
Срабатывает ли вебхук комментариев Instagram на комментарии к Reels?
Да. Комментарий к Reels приходит по полю comments так же, как и к посту, а media.media_product_type позволяет их различить.
Почему не срабатывает вебхук комментариев Instagram?
Чаще всего приложение не в режиме Live или нет Advanced Access, аккаунт никогда не подписывался через /subscribed_apps, медиа принадлежит приватному аккаунту или комментарий был к трансляции, которая использует live_comments.
Включает ли вебхук комментариев имя пользователя комментатора?
Да. value.from содержит имя пользователя рядом с Instagram-scoped ID автора, поэтому для показа того, кто оставил комментарий, дополнительный запрос не нужен.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на