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

Instagram message_reactions Webhook:表情回应与取消回应的负载

message_reactions Webhook 字段会在用户于其与专业账户的对话中对某条消息添加表情回应,或移除该表情回应时,通知应用。该事件位于 messaging 数组中,包含一个 reaction 对象:mid 是被回应消息的 ID;action 为 react 或 unreact;仅在 react 时还包含 reaction(如 love)和 emoji(表情符号本身)。

easyCoexistence 会为每个已连接的 Instagram 账户订阅 comments、messages 和 mentions,并在事件到达时将其转发至您的 HTTPS 端点,使用该账户的密钥签名,每条消息附带其 mid。

react / unreact

reaction.action 有两个值:表情回应被添加,或表情回应被移除。

v12.0

Meta 从 Graph API 某一版本起,在此 Webhook 中支持 angry、sad、wow、love、like、laugh 及其他表情回应。

No echo

账户自己对用户消息添加或取消表情回应时,Meta 不发送任何通知。

Default

message_reactions 是应用控制台中新建的 Instagram 产品默认订阅的字段之一。

100/sec

每个账户每秒可调用 Send API 的次数,适用于文本、链接、表情回应和贴纸。

message_reactions 何时触发?

当用户在其与专业账户的对话中对消息添加表情回应,以及移除该表情回应时,只要应用和账户已订阅该字段,就会触发。Meta 的 Instagram Messaging 指南对相反方向说得很明确:账户本身添加或取消表情回应时,不发送通知,messages 也不会为此推送回显。

表情回应通知是什么样子?

一个 POST 请求,object 设为 instagram,其 entry 中包含 messaging 数组。与私信不同,该事件不包含 message 对象:表情回应位于自己的 reaction 对象中,与 sender、recipient 和 timestamp 并列。以下是 Meta 为 Instagram Login 提供的示例:

A message_reactions notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "reaction": {
            "mid": "<MESSAGE_ID>",
            "action": "react",
            "reaction": "love",
            "emoji": "\u{2764}\u{FE0F}"
          }
        }
      ]
    }
  ]
}

各字段分别是什么意思?

以下是 Meta 为表情回应事件记录的字段,由外到内排列:

  • entry[].id 和 recipient.id:专业账户。sender.id:添加表情回应的用户的 Instagram 范围 ID。
  • timestamp:事件触发的时间,Meta 示例中以毫秒计;entry[].time 是 Meta 发送通知的时间。
  • reaction.mid:被回应消息的 ID,与该消息在 messages 事件中的 mid 相同。
  • reaction.action:添加表情回应时为 react,移除时为 unreact。
  • reaction.reaction:表情回应的名称,如 love;Meta 列出的有 angry、sad、wow、love、like、laugh 及其他。
  • reaction.emoji:以 Unicode 字符串表示的表情符号,如 love 对应的 \u{2764}\u{FE0F}。
  • 在 unreact 时,reaction 和 emoji 均不包含在内。

unreact 是什么样子?

与上面相同的事件,action 设为 unreact,且不包含 reaction 和 emoji,因为已无可命名的内容。通过 reaction.mid 和 sender.id 将其与被移除的表情回应对应,然后从您的记录中删除该用户对该消息的表情回应。

The reaction object of an unreact
"reaction": {
  "mid": "<MESSAGE_ID>",
  "action": "unreact"
}

mid 指向哪条消息?

指向用户所回应的消息,其 mid 与该消息在 messages 事件中的相同,账户自己发送的消息回显也包括在内。存储 mid 的处理程序可以将表情回应关联到对话中的正确位置。Meta 指出一个不足:对轮播帖子中某张图片的表情回应,会报告轮播的第一张图片,这未必是用户选择的那张。

账户如何对消息添加表情回应?

通过 POST /<IG_ID>/messages:recipient.id 设为用户的 Instagram 范围 ID,sender_action 设为 react,payload 字段中包含 message_id 和 reaction(表情符号或其 UTF-8 形式)。使用其他表情符号重复调用可更改表情回应;将 sender_action 设为 unreact 并只传入 message_id 则会移除表情回应。两种调用都不会产生 Webhook 通知。

Reacting to a person's message
POST https://graph.instagram.com/<IG_ID>/messages
Authorization: Bearer <INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json

{
  "recipient": { "id": "<IGSID>" },
  "sender_action": "react",
  "payload": {
    "message_id": "<MESSAGE_ID>",
    "reaction": "<EMOJI>"
  }
}

message_reactions 需要什么?

使用 Instagram Login 时,需要 instagram_business_basic 和 instagram_business_manage_messages 权限;对于开发者并不拥有或管理的账户,需要 Advanced Access。应用控制台中新建的 Instagram 产品默认已订阅 message_reactions,每个账户则通过 POST /<IG_ID>/subscribed_apps 订阅。Meta 的《发送消息》指南将其列为 messaging_reactions,但其字段表、应用控制台默认设置和 Webhook 参考均写作 message_reactions。

easyCoexistence 会转发表情回应吗?

否。easyCoexistence 的应用及每个已连接账户仅订阅 comments、messages 和 mentions,因此 message_reactions 事件不会转发至您的端点。表情回应通过 mid 指向的私信及回显则会送达该端点,并使用该账户的密钥签名。

常见错误

  • 不要在 message 中查找表情回应。表情回应事件没有 message 对象;请读取与 sender 和 recipient 并列的 reaction 对象。
  • 未检查 action 就读取 reaction 或 emoji。取消回应时两者都不包含,因此当表情回应被移除时,假定它们存在的代码会出错。
  • 账户添加表情回应后等待 Webhook。Meta 不会为账户自己的表情回应发送任何通知,甚至不发回显,因此应在应用发送时自行记录。
  • 照搬 Meta《发送消息》指南中的名称 messaging_reactions。其字段表、应用控制台默认设置和 Webhook 参考中的字段名是 message_reactions。
使用 EasyCoexistence 完成这些操作

您的 AI 代理在 24 小时窗口内通过 send_social_dm 回复用户。每个连接每月 US$ 9 起,随连接数增加降至 US$ 0.75,首 3 天免费试用。

常见问题

为什么轮播帖子上的表情回应指向第一张图片?

Meta 在用户对轮播中的某张图片添加表情回应时,报告的是轮播的第一张图片,这未必是用户选择的那张。

商家回应消息时,Instagram 会发送 Webhook 吗?

不会。账户对消息添加或取消表情回应时,Meta 既不发送 message_reactions 通知,也不发送回显。

Instagram Webhook 能报告哪些表情回应?

Meta 的 Instagram Messaging 指南列出,自 Graph API v12.0 起包括 angry、sad、wow、love、like、laugh 及其他表情回应,表情符号本身位于 reaction.emoji 中。

Webhook 字段是 message_reactions 还是 messaging_reactions?

是 message_reactions。Meta 的《发送消息》指南写作 messaging_reactions,但其字段表、应用控制台默认设置和 Webhook 参考均使用 message_reactions。

继续阅读

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

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

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

验证时间