messenger.message_reaction.updated

使用 messenger.message_reaction.updated 在您的 Webhook 端点处理此事件。

触发条件

当客户对 Messenger 消息添加或移除回应时触发。在您配置 Webhook 端点时订阅 messenger.message_reaction.updated。使用 action 来区分添加回应与撤回回应。撤回回应时可以省略 reaction 和 emoji。目标 Meta 消息无需在 YCloud 本地拥有消息记录。事件信封中的 createTime 为源交互时间。

语法

YCloud 会向您配置的 Webhook URL 发送 HTTP POST 请求。以下结构展示了一种负载变体。尖括号中的值为占位符；其类型列在参数下。可选字段和其他变体如下文所述。

{
  "id": "<ID>",
  "type": "messenger.message_reaction.updated",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "messengerMessageReaction": {
    "pageId": "<PAGE_ID>",
    "psid": "<PSID>",
    "metaMessageId": "<META_MESSAGE_ID>",
    "action": "<ACTION>",
    "reaction": "<REACTION>",
    "emoji": "<EMOJI>"
  }
}

参数

在处理 JSON 请求体之前，请先验证 YCloud-Signature HTTP 请求头。参见签名验证。

事件信封

参数	类型	是否必填	说明
`id`	string	是	事件的唯一 ID。最小长度：`6`。最大长度：`128`。
`type`	string	是	固定为 `messenger.message_reaction.updated`。
`apiVersion`	string	是	用于呈现此事件的 API 版本。
`createTime`	string (date-time)	是	此事件创建的时间，格式采用 RFC 3339。例如 `2022-06-01T12:00:00.000Z`。

事件负载

参数	类型	是否必填	说明
`messengerMessageReaction`	object	否	事件特定的 `messengerMessageReaction` 负载。

四个通用信封字段为必填项。负载字段取决于事件变体。在每个对象表格中，当父对象存在时， 是否必填 规则生效。可选字段可以省略；示例中包含某个字段并不代表该字段是必填的。

messengerMessageReaction

参数	类型	是否必填	说明
`pageId`	string	是	限定此对话范围的 Facebook 主页 ID。
`psid`	string	是	做出回应的客户的主页范围 ID（Page-scoped ID）。
`metaMessageId`	string	是	被回应消息的 Meta ID。
`action`	string	是	使用 react 表示添加回应，使用 unreact 表示撤回回应。
`reaction`	string	否	Meta 提供的回应名称。可能省略，包括撤回回应时。
`emoji`	string	否	Meta 提供的回应表情符号。可能省略，包括撤回回应时。

示例

以下 JSON 是传递给您的接收器的请求体。ID、电话号码和其他账户值仅供参考。

Messenger 消息回应

目标 Meta 消息无需在 YCloud 本地拥有消息记录。

{
  "id": "evt_abcdef0123456789abcdef01",
  "type": "messenger.message_reaction.updated",
  "apiVersion": "v2",
  "createTime": "2026-10-20T02:00:04.000Z",
  "messengerMessageReaction": {
    "pageId": "422500000000000",
    "psid": "100800000000000",
    "metaMessageId": "m_EXAMPLE_OUT_001",
    "action": "react",
    "reaction": "love",
    "emoji": "❤️"
  }
}

撤回 Messenger 消息回应

撤回时可以省略回应名称和表情符号。

{
  "id": "evt_bcdef0123456789abcdef012",
  "type": "messenger.message_reaction.updated",
  "apiVersion": "v2",
  "createTime": "2026-10-20T02:00:05.000Z",
  "messengerMessageReaction": {
    "pageId": "422500000000000",
    "psid": "100800000000000",
    "metaMessageId": "m_EXAMPLE_OUT_001",
    "action": "unreact"
  }
}

验证签名并持久接收该事件后，返回 2xx 响应。耗时任务请以异步方式处理。

HTTP/1.1 200 OK

开始使用

指南

接口

Webhook reference

messenger.message_reaction.updated

触发条件

语法

参数

事件信封

事件负载

messengerMessageReaction

示例

​触发条件

​语法

​参数

​事件信封

​事件负载

​messengerMessageReaction

​示例

触发条件

语法

参数

事件信封

事件负载

messengerMessageReaction

示例