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

Instagram 评论 Webhook:逐字段解析负载

Instagram 评论 Webhook 字段会在有人评论专业账户的媒体(包括 Reels)或回复某条评论时,通知应用。Meta 会发送一条 field 设为 comments 的变更,其 value 包含评论的 id 与文本、作者基于 Instagram 范围的 ID 和用户名(位于 from 中)、媒体的 id 与 media_product_type,以及评论为回复时的 parent_id。

easyCoexistence 会将每个已连接的 Instagram 账户订阅到 comments,并在 Meta 为其投递评论事件时,将其即时转发到你的 HTTPS 端点,附带该账户的密钥签名,且不保留副本。

parent_id

评论为回复时存在该字段,其值为所回复评论的 ID。

self_ig_scoped_id

账户评论自己的媒体时,会添加到 from 中,与账户自身的 ID 并列。

live_comments

直播期间的评论使用单独的字段,直播结束后其通知停止。

Advanced Access

comments 和 live_comments 通知需要 Advanced Access;私密账户的媒体不会触发任何通知。

7 days

可以向评论者发送一条私密回复的剩余时间,以评论的 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 上的一条回复:

A comments notification, as Meta sends it
{
  "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 地址。不保留副本,也不会重试。
A forwarded comment, headers included
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,该字段需要单独订阅,并在直播结束后停止。
使用 EasyCoexistence 完成这些操作

评论转私信规则和自动化全天候回复同一批评论。每个连接每月 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 监控

验证时间