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

Вебхук комментариев 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-эндпоинт по мере поступления, подписанные секретом этого аккаунта, без хранения копии.

parent_id

Присутствует, когда комментарий является ответом, и содержит ID комментария, на который он отвечает.

self_ig_scoped_id

Добавляется в from, когда аккаунт комментирует собственное медиа, рядом с ID самого аккаунта.

live_comments

Отдельное поле для комментариев во время трансляции Live; уведомления по нему прекращаются по окончании трансляции.

Advanced Access

Требуется для уведомлений comments и live_comments; медиа приватных аккаунтов не порождает ни одного уведомления.

7 days

Оставшееся время, чтобы отправить автору комментария один личный ответ, адресованный по 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 выглядит так:

A comments notification, as Meta sends it
{
  "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. Копии не хранятся, повторы не выполняются.
A forwarded comment, headers included
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, которому нужна собственная подписка и которое замолкает по окончании трансляции.
Настройка с EasyCoexistence

Правила «комментарий в 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 автора, поэтому для показа того, кто оставил комментарий, дополнительный запрос не нужен.

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

Вебхук сообщений Instagram: тело DM, эхо и поляЧто вебхук сообщений Instagram передаёт для DM: IGSID отправителя, текст, вложения, ответы на сторис и эхо, поле за полем, и окно 24 часа.Верификация вебхуков Instagram: hub.challenge и X-Hub-Signature-256Как настроить вебхуки Instagram: ответить на hub.challenge, проверить X-Hub-Signature-256 секретом приложения, подписать каждый аккаунт и обработать повторы.События вебхука Instagram: комментарии, упоминания и личные сообщения (DM)Как комментарии, упоминания и DM из Instagram доходят до вашего эндпоинта: что содержит каждое событие, как подписываются доставки и что проверить.API приватных ответов в Instagram: ответ на комментарий личным сообщениемОтправьте приватный ответ в Instagram через API Meta: POST /<IG_ID>/messages с ID комментария, один на комментарий в течение 7 дней, ошибка 2534025.Модерация комментариев в Instagram через APIКак API Instagram читает комментарии, отвечает на них, скрывает и удаляет: публичные ответы, один личный ответ на комментарий в течение 7 дней и правила.Упоминания в Instagram через API: поиск и ответы на @упоминанияКак @упоминания в Instagram приходят через API в вебхуке комментариев с Instagram Login и как на них отвечать в комментариях и подписях.

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

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

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

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