登录开始免费试用
easyCoexistence 官方 API

Instagram live_comments Webhook:直播期间的评论

Instagram 的 live_comments Webhook 字段会在专业账户的直播视频播出期间,通知应用该直播收到的评论。每条评论以 changes 项的形式送达,其 field 设为 live_comments,值的结构与 comments 字段相同:包括评论的 id 和 text,作者的 Instagram 作用域 ID 和用户名位于 from 中,以及媒体的 id。直播结束后,通知随即停止。

easyCoexistence 为每个已连接的 Instagram 账户订阅 comments、messages 和 mentions,并在其帖子和 Reel 上的评论到达时,使用该账户的密钥签名后转发至您的 HTTPS 端点。

Advanced Access

与评论通知相同,接收 live_comments 通知需要所需权限;私密账户所拥有的媒体不会发送任何通知。

100/sec

应用针对 Instagram 直播评论,每个账户每秒可发送的私密回复数。

Broadcast end

直播媒体的评论通知何时停止。

During the Live

直播评论的私密回复可在何时发送;直播结束后,即无法再发送。

9 Nov 2021

Meta 推出 live_comments 的时间,用于直播视频在播出期间的评论。

live_comments 何时触发?

当有人在专业账户的直播视频播出期间发表评论,且应用和账户已订阅该字段时,即会触发。它与 comments 不同:帖子、Reel、限时动态或广告上的评论通过 comments 送达,直播期间的评论则通过 live_comments 送达。直播结束后,直播媒体的通知随即停止,私密账户拥有的媒体不会触发任何通知。

live_comments 通知是什么样子的?

这是评论通知的外层结构:object 设为 instagram,每个账户对应一个 entry,并包含一个 changes 数组,其中 field 为 live_comments。Meta 的 Instagram Login 示例为 comments 和 live_comments 提供了同一种值结构,因此字段名是区分两者的唯一依据:

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 的 Webhook 参考文档为 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 作用域 ID 和用户名;当账户自己评论时,会出现 from.self_ig_scoped_id。
  • value.media.id 和 value.media.media_product_type:直播视频及其所在的展示位置。
  • 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

如何回复直播评论?

在直播期间通过私密回复进行。将 recipient.comment_id 设为评论的 ID,调用 POST /<IG_ID>/messages,即可向评论作者发送一条私信。若对方关注了该账户,消息会进入其收件箱,否则进入消息请求。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>" }
}

不使用 Webhook 能否读取直播评论?

只能在直播期间读取。Meta 的评论参考文档指出,直播视频上的评论只能在媒体正在播出时读取,其媒体参考文档对直播视频本身也作了相同说明。用于列出账户当前直播的 live_media 边(edge),其文档仅适用于 graph.facebook.com 上的 Facebook Login。Meta 不保留可供查询的通知历史,因此请在每个事件到达时保存所需的数据。

live_comments 需要哪些条件?

使用 Instagram Login 时,需要 instagram_business_basic 和 instagram_business_manage_comments,这与 comments 所需的权限组合相同,此外还需要 Advanced Access,这是 Meta 对 comments 和 live_comments 通知的要求。应用控制台中新建的 Instagram 产品默认订阅 live_comments,每个账户则通过 POST /<IG_ID>/subscribed_apps 进行订阅。拥有直播的账户必须为公开账户。

easyCoexistence 会转发直播评论吗?

否。easyCoexistence 的应用及每个已连接账户订阅的是 comments、messages 和 mentions,而非 live_comments,因此直播期间发表的评论不会转发。帖子和 Reel 上的评论会转发,reply_to_comment、hide_comment、评论转私信规则和自动化均可对其进行处理。

常见错误

  • 等待 comments 字段接收直播评论。直播评论实际到达 live_comments,字段为 live_comments,并需要在应用中选择该字段。
  • 公开回复直播评论。Meta 不支持对直播视频评论进行回复、隐藏或删除;直播期间发送私密回复才是正确途径。
  • 将私密回复推迟到直播结束后。直播结束后即无法再发送,因此请在直播播出时回复。
  • 把 live_comments 当作历史记录。通知在直播结束后停止,Meta 也不保留可供查询的记录,因此请在每条通知到达时保存所需内容。
使用 EasyCoexistence 完成这些操作

reply_to_comment 可公开回复或发送私密回复,评论转私信规则全天候运行。每个连接每月 US$ 9 至 US$ 0.75,连接越多价格越低,前 3 天免费。

常见问题

Instagram 的 comments Webhook 是否包含直播评论?

不包含。直播期间的评论通过单独的 live_comments 字段送达,其值结构相同。

Meta 是什么时候新增 live_comments Webhook 的?

2021 年 11 月 9 日,针对直播视频播出期间的评论。

我的 live_comments Webhook 为什么停止了?

最可能的原因是直播已经结束,这会停止直播媒体的评论通知。如果从未开始,请检查 Advanced Access、账户的订阅情况,以及该账户是否为公开账户。

应用每秒最多能向 Instagram 直播评论发送多少条私密回复?

每个账户每秒最多 100 条,这是 Meta 针对直播评论的私密回复速率,而帖子和 Reel 评论的上限为每小时 750 条。每条都必须在直播结束前发出。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间