Вебхук 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-эндпоинт по мере их поступления, подписанные секретом этого аккаунта.
Требуется для уведомлений live_comments, как и для comments; медиа закрытого аккаунта уведомлений не присылает.
Личных ответов в секунду, которые приложение может отправить с одного аккаунта на комментарии к Instagram Live.
Когда уведомления о комментариях к медиа в прямом эфире прекращаются.
Когда можно отправить личный ответ на комментарий в Live; после окончания эфира это уже невозможно.
Когда 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, поэтому отличает их только имя поля:
{
"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:
| comments | live_comments | |
|---|---|---|
| Fires for | Comments on posts, Reels, Stories and ads | Comments on a Live while it broadcasts |
| Notifications | As each comment is made | Stop when the broadcast ends |
| Public reply | POST /<COMMENT_ID>/replies | Not supported on live video |
| Hide or delete | Supported | Not supported on live video |
| Private reply | Within 7 days of the comment | Only during the broadcast |
| Private reply rate | 750 per hour per account | 100 per second per account |
Как ответить на комментарий в Live?
Личным ответом во время эфира. POST /<IG_ID>/messages с recipient.comment_id, равным ID комментария, отправляет его автору одно личное сообщение. Оно попадает во входящие, если автор подписан на аккаунт, и в запросы сообщений, если нет. Справочники Meta исключают публичные способы на видео в эфире: ответить на комментарий, создать, скрыть и удалить комментарии там не поддерживается. После окончания трансляции личные ответы на её комментарии уже нельзя отправить.
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 их не хранит для запроса, поэтому сохраняйте нужное по мере поступления каждого.
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. Каждый ответ должен уйти до окончания трансляции.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на