Instagram 评论 Webhook:逐字段解析负载
Instagram 评论 Webhook 字段会在有人评论专业账户的媒体(包括 Reels)或回复某条评论时,通知应用。Meta 会发送一条 field 设为 comments 的变更,其 value 包含评论的 id 与文本、作者基于 Instagram 范围的 ID 和用户名(位于 from 中)、媒体的 id 与 media_product_type,以及评论为回复时的 parent_id。
easyCoexistence 会将每个已连接的 Instagram 账户订阅到 comments,并在 Meta 为其投递评论事件时,将其即时转发到你的 HTTPS 端点,附带该账户的密钥签名,且不保留副本。
评论为回复时存在该字段,其值为所回复评论的 ID。
账户评论自己的媒体时,会添加到 from 中,与账户自身的 ID 并列。
直播期间的评论使用单独的字段,直播结束后其通知停止。
comments 和 live_comments 通知需要 Advanced Access;私密账户的媒体不会触发任何通知。
可以向评论者发送一条私密回复的剩余时间,以评论的 ID 指定。
comments 字段何时触发?
当有人评论专业账户拥有的媒体,或提及该账户时触发,前提是应用和账户都已订阅该字段。每条评论是通知中的一个变更,以下几种情况共享相同的结构:
- 在帖子、Reels、限时动态或广告上的新评论,附带 media.
media_product_type,说明媒体所在的展示位置。 - 对现有评论的回复,携带
parent_id,其值为所回复评论的 ID。 - 账户在自己的媒体上发表的评论(包括对评论的回复):from.id 为账户自身的 ID,并且 from 中会添加
self_ig_scoped_id。 - 对该账户的 @ 提及:使用 Instagram Login 时,Meta 会将提及包含在评论通知中,而不是单独的字段。
- 直播期间的评论位于单独的字段
live_comments中,值的结构相同,直播结束后停止。
评论通知是什么样子?
一个 POST 请求,其 JSON 中 object 设为 instagram,并包含一个 entry 数组。每个 entry 对应一个专业账户:包含其 ID、Meta 发送通知的时间,以及一个 changes 数组,其中每条评论对应一个变更。下面是 Reels 上的一条回复:
{
"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 的 webhook 参考文档中列出的评论字段,从外到内依次为:
- entry[].id:专业账户的 ID,即 /me 为该账户返回的
user_id。它说明评论属于哪个账户。 - entry[].time:Meta 发送通知的时间,为 Unix 时间戳。它不是评论发表的时间。
- changes[].field:comments,直播时为
live_comments。读取 value 之前先检查它。 - value.id:评论的 ID,用于公开或私密回复、隐藏或删除评论。
- value.text:评论的文本,仅在评论含有文字时包含。
- value.from.id 和 value.from.username:作者基于 Instagram 范围的 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 格式返回。 - 直播结束后的直播评论,此时直播媒体的通知已停止。
- 限时动态中的提及:Meta 的提及 API 不支持,它们会改为以私信的形式送达账户。
- 历史事件:Meta 不保留可供查询的通知记录,因此请在每个事件到达时保存所需内容。
comments 字段需要什么?
使用 Instagram Login 时,需要 instagram_business_basic 和 instagram_business_manage_comments 权限,并需要 Advanced Access,这是 Meta 对 comments 和 live_comments 通知的要求。应用必须处于 Live 状态,并在应用控制台中订阅 comments;每个账户必须通过 POST /<IG_ID>/subscribed_apps 订阅,并在 subscribed_fields 中包含 comments。Meta 强烈建议对评论使用此 webhook 而非轮询,因为这样可以节省速率限制。
如何根据事件回复评论?
使用事件中携带的 ID。POST /<COMMENT_ID>/replies 并附带 message,会以 value.id 在评论下发布公开回复。POST /<IG_ID>/messages 并将 recipient.comment_id 设为 value.id,则会向作者发送一条私密回复,发送时间须在评论发表后 7 天内,或在直播期间进行。from.id 是基于 Instagram 范围的 ID,但在对方未先私信该账户之前,直接发往该 ID 的私信会失败,因此,私密回复是通过私信联系对方的途径。
easyCoexistence 如何转发评论?
在事件到达时即时转发,前提是已通过 Claude 或 ChatGPT 中的 set_social_webhook_destination,或通过 Partner API 的 PUT /channels/:id/webhook 为该账户设置端点。easyCoexistence 会将每个已连接账户订阅到承载其评论、提及和私信的字段,对每次投递检查 Meta 签名,立即响应 Meta,并将该账户的每个 entry 以 POST 方式发送到您的 HTTPS URL,装入以下信封:
- platform 和
external_id:instagram,以及账户的 Instagram ID,与 entry.id 相等。 account_id:easyCoexistence 中的连接 ID,即list_social_accounts返回的 ID,MCP 工具也使用该 ID。- entry:Meta 为该账户发送的 entry,原样不变,因此批量投递会变为每个 entry 一次 POST。Meta 的 object 字段和 X-Hub-Signature-256 不会被转发。
- 投递:仅尝试一次,最长等待 8 秒,不跟随重定向,目标须为解析到公共 IP 的 HTTPS 地址。不保留副本,也不会重试。
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" }
}
}
]
}
}评论转私信规则如何处理同一事件?
规则会与转发并行读取该事件。当评论包含其中某个关键词时(不区分大小写)即匹配,关键词适用于所选的某条帖子或全部帖子;匹配后,规则的私信内容会作为私密回复发送给作者,若规则设有公开回复,则同时发布公开回复。账户本人的评论会被跳过,以评论为触发条件的自动化会处理未被任何规则回复的评论,而被规则回复过的评论仍会送达你的端点。规则的公开回复可能会以账户本人的新 comments 事件返回。
常见错误
- 查找 comment_id。在 Instagram Login 下,评论的 ID 位于 value.id 中;comment_id 属于 Meta 其他登录方式的负载。
- 回复账户自己的评论。其回复会以 from.id 等于 entry.id 的 comments 事件返回,若自动化对这些回复作出响应,就会变成与自己对话。
- 将 entry.time 当作评论时间。它记录的是 Meta 发送通知的时间;评论自身的时间戳字段才表示其发表时间。
- 在 comments 字段上等待直播评论。它们会到达 live_comments,该字段需要单独订阅,并在直播结束后停止。
评论转私信规则和自动化全天候回复同一批评论。每个连接每月 US$ 9 至 US$ 0.75,连接越多单价越低,前 3 天免费试用。
常见问题
Instagram 评论 Webhook 是否包含对评论的回复?
包含。回复会作为独立的 comments 事件到达,其中 parent_id 为所回复评论的 ID。
Reels 上的评论会触发 Instagram 评论 Webhook 吗?
会。Reels 上的评论与帖子上的评论一样,通过 comments 字段到达,media.media_product_type 可用于区分二者。
为什么我的 Instagram 评论 Webhook 没有触发?
最常见的原因是:应用未处于 Live 状态或缺少 Advanced Access、账户从未通过 /subscribed_apps 订阅、媒体属于私密账户,或评论发表在直播中,而直播评论使用 live_comments。
评论 Webhook 是否包含评论者的用户名?
包含。value.from 中包含该用户的用户名,以及其基于 Instagram 范围的 ID,因此无需额外调用即可显示是谁发表了评论。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间