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

Вебхук live_comments в Instagram: комментарии во время Live

Поле вебхука live_comments уведомляет приложение о комментариях к прямому эфиру профессионального аккаунта, пока тот идёт. Каждый комментарий приходит как элемент changes с полем field, равным live_comments, и той же структурой value, что и поле comments: id и текст комментария, Instagram-scoped ID и имя автора в from, а также id медиа. Уведомления прекращаются, когда эфир заканчивается.

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

Advanced Access

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

100/sec

Личных ответов в секунду, которые приложение может отправить с одного аккаунта на комментарии к Instagram Live.

Broadcast end

Когда уведомления о комментариях к медиа в прямом эфире прекращаются.

During the Live

Когда можно отправить личный ответ на комментарий в Live; после окончания эфира это уже невозможно.

9 Nov 2021

Когда Meta ввела live_comments для комментариев к видео в прямом эфире, пока оно транслируется.

Когда срабатывает live_comments?

Когда кто-то комментирует видео Live профессионального аккаунта во время трансляции, при условии что приложение и аккаунт подписаны на это поле. Оно отделено от comments: комментарий к посту, Reels, Stories или рекламе приходит в comments, а комментарий во время Live в live_comments. Уведомления о медиа в эфире прекращаются по окончании трансляции, а медиа закрытого аккаунта их не вызывает.

Как выглядит уведомление live_comments?

Конверт, как у комментария: object со значением instagram, одна запись entry на аккаунт и массив changes, где поле field равно live_comments. В примере Meta для Instagram Login у comments и live_comments одна и та же структура value, поэтому отличает их только имя поля:

A live_comments notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000,
      "changes": [
        {
          "field": "live_comments",
          "value": {
            "id": "<COMMENT_ID>",
            "text": "<COMMENT_TEXT>",
            "from": {
              "id": "<INSTAGRAM_SCOPED_ID>",
              "username": "<USERNAME>"
            },
            "media": {
              "id": "<LIVE_MEDIA_ID>",
              "media_product_type": "<MEDIA_PRODUCT_TYPE>"
            }
          }
        }
      ]
    }
  ]
}

Что означает каждое поле?

Поля, которые справочник вебхуков Meta перечисляет для live_comments, от внешнего уровня к внутреннему:

  • entry[].id: профессиональный аккаунт. entry[].time: когда Meta отправила уведомление, а не когда написан комментарий.
  • changes[].field: live_comments. Проверьте его до чтения value, так как структура совпадает с comments.
  • value.id: ID комментария, по которому адресуется личный ответ.
  • value.text: текст комментария.
  • value.from.id и value.from.username: Instagram-scoped ID и имя автора; from.self_ig_scoped_id появляется, когда комментирует сам аккаунт.
  • value.media.id и value.media.media_product_type: видео Live и раздел, где оно размещено.
  • value.parent_id: в справочнике указан для комментария, который является ответом на другой комментарий.

Чем live_comments отличается от comments?

Структура данных совпадает, а правила нет. Справочники Meta по комментариям выделяют комментарии к видео в прямом эфире в отдельный случай, и их ограничения частоты и правила личных ответов имеют другие значения. Для сравнения, слева поле comments:

commentslive_comments
Fires forComments on posts, Reels, Stories and adsComments on a Live while it broadcasts
NotificationsAs each comment is madeStop when the broadcast ends
Public replyPOST /<COMMENT_ID>/repliesNot supported on live video
Hide or deleteSupportedNot supported on live video
Private replyWithin 7 days of the commentOnly during the broadcast
Private reply rate750 per hour per account100 per second per account

Как ответить на комментарий в Live?

Личным ответом во время эфира. POST /<IG_ID>/messages с recipient.comment_id, равным ID комментария, отправляет его автору одно личное сообщение. Оно попадает во входящие, если автор подписан на аккаунт, и в запросы сообщений, если нет. Справочники Meta исключают публичные способы на видео в эфире: ответить на комментарий, создать, скрыть и удалить комментарии там не поддерживается. После окончания трансляции личные ответы на её комментарии уже нельзя отправить.

A private reply to a Live comment
POST https://graph.instagram.com/<IG_ID>/messages
Authorization: Bearer <INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json

{
  "recipient": { "comment_id": "<COMMENT_ID>" },
  "message": { "text": "<REPLY_TEXT>" }
}

Можно ли читать комментарии к Live без вебхука?

Только пока идёт эфир. Справочник комментариев Meta говорит, что комментарии к видео в прямом эфире можно читать только во время трансляции, и справочник медиа говорит то же о самом видео. Связь live_media, которая показывает текущий Live аккаунта, описана для Facebook Login на graph.facebook.com. Meta не хранит историю уведомлений для запроса, поэтому сохраняйте нужное из каждого события по мере его поступления.

Что нужно для live_comments?

С Instagram Login: instagram_business_basic и instagram_business_manage_comments, та же пара, что и для comments, плюс Advanced Access, который Meta требует для уведомлений о comments и live_comments. Новый продукт Instagram в App Dashboard по умолчанию подписан на live_comments, а каждый аккаунт подписывается через POST /<IG_ID>/subscribed_apps. Аккаунт, владеющий Live, должен быть публичным.

Пересылает ли easyCoexistence комментарии из Live?

Нет. Приложение easyCoexistence и каждый подключённый аккаунт подписаны на comments, messages и mentions, а не на live_comments, поэтому комментарии во время Live не пересылаются. Комментарии к постам и Reels пересылаются, и по ним могут действовать reply_to_comment, hide_comment, правила «комментарий в личное сообщение» и автоматизации.

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

  • Ожидание комментариев из Live в поле comments. Они приходят в live_comments, с полем field, равным live_comments, и это поле нужно выбрать для приложения.
  • Публичный ответ на комментарий в Live. Meta не поддерживает ответы, скрытие и удаление комментариев к видео в эфире; путь к ответу это личный ответ во время трансляции.
  • Отложенные личные ответы «на потом». После окончания Live их уже нельзя отправить, поэтому отвечайте, пока эфир идёт.
  • Использование live_comments как истории. Уведомления прекращаются по окончании эфира, а Meta их не хранит для запроса, поэтому сохраняйте нужное по мере поступления каждого.
Настройка с EasyCoexistence

reply_to_comment отвечает публично или личным сообщением, а правила «комментарий в личное сообщение» работают круглосуточно. От US$ 9 до US$ 0,75 за подключение в месяц, снижаясь по мере добавления подключений, первые 3 дня бесплатно.

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

Включает ли вебхук комментариев Instagram комментарии из Live?

Нет. Комментарии во время трансляции Live приходят в отдельное поле live_comments, с той же структурой value.

Когда Meta добавила вебхук live_comments?

9 ноября 2021 г., для комментариев к видео в прямом эфире во время трансляции.

Почему перестал приходить вебхук live_comments?

Скорее всего, трансляция закончилась, а это останавливает уведомления о комментариях к медиа в эфире. Если он не приходил с самого начала, проверьте Advanced Access, подписку аккаунта и то, что аккаунт публичный.

Как быстро приложение может отправлять личные ответы на комментарии к Instagram Live?

До 100 в секунду с одного аккаунта: это личный лимит Meta для комментариев в Live, против 750 в час для комментариев к постам и Reels. Каждый ответ должен уйти до окончания трансляции.

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

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

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

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

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

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