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 端点。
与评论通知相同,接收 live_comments 通知需要所需权限;私密账户所拥有的媒体不会发送任何通知。
应用针对 Instagram 直播评论,每个账户每秒可发送的私密回复数。
直播媒体的评论通知何时停止。
直播评论的私密回复可在何时发送;直播结束后,即无法再发送。
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 提供了同一种值结构,因此字段名是区分两者的唯一依据:
{
"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 字段:
| 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 |
如何回复直播评论?
在直播期间通过私密回复进行。将 recipient.comment_id 设为评论的 ID,调用 POST /<IG_ID>/messages,即可向评论作者发送一条私信。若对方关注了该账户,消息会进入其收件箱,否则进入消息请求。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>" }
}不使用 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 也不保留可供查询的记录,因此请在每条通知到达时保存所需内容。
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 监控
验证时间