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

Facebook 主页 feed Webhook:推送的评论、帖子和反应事件

Facebook 主页 Webhook 的 feed 字段几乎会实时报告主页动态的所有变化。每项变化都包含一个 item(如 post、comment 或 reaction)和一个 verb(如 add、edit 或 remove),并附带相关 ID、发起者 from 以及文本 message。Meta 以 JSON 格式发送,并使用 X-Hub-Signature-256 签名。

easyCoexistence 会为您连接的每个主页订阅 feed 字段,并在变化发生时将其实时转发至您的 HTTPS 端点,转发时使用该主页的密钥签名;评论转私信规则和自动化则针对新评论执行。

10K likes

只有点赞数少于此数的主页,才会发送主页点赞的 feed 通知。

Ad posts

feed 字段不会为广告帖子本身发送通知,但会发送其下的评论。

pages_manage_metadata

主页管理员须具备 MODERATE 权限,并完成授权,主页 Webhook 才能送达应用。

1,000

Meta 大多会把多项更新合并为一次 Webhook 投递,但并不保证一定合并。

36 hours

Meta 对投递至应用端点失败的请求重试的时长,以及重试频率的递减方式。

feed 字段会报告哪些内容?

主页动态的几乎所有变化,按 Meta 的说法包括帖子、评论、反应和分享;每项变化所携带的内容取决于其类型。Meta 不会为广告帖子本身发送通知,但会送达其下的评论;同时,只有在主页点赞数少于 10,000 时,才会发送主页点赞的通知。

item 和 verb 是什么意思?

每项变化 value 中的两个字段说明发生了什么:

  • item:变化的类型,取自 Meta 的列表,包括 post、status、photo、video、link、share、comment、reaction 和 album。
  • verb:对该内容所做的操作:add、edit、edited、delete、remove、hide、unhide、block、unblock、follow、mute 或 update。
  • 新评论的 item 为 comment,verb 为 add,这正是评论转私信规则所匹配的内容。
  • 表情反应的 item 为 reaction,并附带一个 reaction_type 字段说明其类型。

feed 变化是什么样子的?

一个 POST 请求,其 JSON 中 object 设为 page,并为每个主页提供一条 entry,其中包含主页 ID、时间以及一个 changes 数组。以下是 Meta 官方示例,即一位用户在主页上发帖:

A feed change, as Meta sends it
{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1520544816,
      "changes": [
        {
          "field": "feed",
          "value": {
            "from": { "id": "<USER_ID>", "name": "<NAME>" },
            "item": "post",
            "post_id": "<PAGE_POST_ID>",
            "verb": "add",
            "created_time": 1520544814,
            "is_hidden": false,
            "message": "<POST_TEXT>"
          }
        }
      ]
    }
  ]
}

一项变化可以包含哪些字段?

Meta 参考文档列出了 feed 变化 value 中可能出现的字段,具体取决于变化的类型:

  • post_id、comment_id 和 parent_id:帖子、评论,以及该评论所属的内容。
  • from:发起变化者的 ID 和名称。
  • message:文本内容,附带内容则使用 link、photo、photos 或 video。
  • created_time,编辑内容时另有 edited_time。
  • reaction_type 对应表情反应,is_hidden 表示帖子是否被隐藏。
  • post:包含 status_type、is_published、updated_time 和 permalink_url 等详细信息。

主页如何订阅?

应用需由具备 CREATE_CONTENT、MANAGE 或 MODERATE 任务权限的人员,使用主页的访问令牌,发送 POST /{page-id}/subscribed_apps 请求,其中 subscribed_fields=feed,并且已授予 pages_manage_metadata 和 pages_show_list 权限。只有在主页已安装该应用,且未在设置中关闭应用平台时,Meta 才会发送通知。easyCoexistence 在连接时会为每个主页订阅 feed、messages 和 mention。

feed 事件如何到达您的端点?

Meta 将事件投递至 easyCoexistence 的应用,该应用会校验 X-Hub-Signature-256,立即向 Meta 作出应答,并将每条已连接主页的 entry 转发至您为其设置的 HTTPS 端点。转发请求携带 X-EC-Signature 头部,其值为以该主页密钥计算的时间戳与原始请求体的 HMAC-SHA256 值。转发只进行一次,不保留副本,也不会重试。您可以使用 set_social_webhook_destination,或在 Partner API 上调用 PUT /channels/:id/webhook 来设置端点。

哪些 feed 变化会触发评论规则和自动化?

只有新评论会触发:即主页某条帖子下 item 为 comment、verb 为 add 的变化。评论转私信规则会检查其 message 是否包含关键词,并跳过主页自己发表的评论;自动化则处理没有被任何规则回复的评论。编辑、隐藏、反应和帖子则会直接发送至您的端点(如果您已设置)。

常见错误

  • 把任何 feed 变化都当作新评论。请检查 item 和 verb:反应、编辑、隐藏和移除也出现在同一字段中。
  • 回复主页自己的评论。主页的回复同样会以 feed 变化的形式返回,因此请跳过 from.id 为主页 ID 的变化。
  • 假设每次投递只包含一项变化。Meta 最多可将 1,000 项更新合并为一次投递,因此需遍历每个 entry 及其中的每项 change。
  • 把 entry.time 当作变化发生的时间。Meta 将其设为通知发送的时间;value 中的 created_time 才是对象的创建时间。
使用 EasyCoexistence 完成这些操作

每个连接每月 US$ 9 至 US$ 0.75,连接越多,单价越低,并享有 3 天免费试用。

常见问题

Feed Webhook 包含评论吗?

包含。新评论会以 feed 变化的形式到达,其 item 为 comment、verb 为 add,并携带 comment_id、post_id、from 和 message。

我会收到主页点赞的 Webhook 吗?

只会收到点赞数少于 10,000 的主页的通知,依据是 Meta 的主页 Webhook 参考文档。

广告帖子会出现在 feed Webhook 中吗?

广告帖子本身不会,但其下的评论会被发送。

获取主页的 feed 事件是否需要自己的 Meta 应用?

不需要。Meta 会将事件投递至 easyCoexistence 的应用,再由它转发至您为该主页设置的端点。

继续阅读

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

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

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

验证时间