> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# messenger.message_reaction.updated

> 当客户对 Messenger 消息添加或移除回应时触发。

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

## 触发条件

当客户对 Messenger 消息添加或移除回应时触发。

在您[配置 Webhook 端点](https://docs.ycloud.com/zh/api-reference/guides/api-fundamentals/configure-webhooks.md)时订阅 `messenger.message_reaction.updated`。

使用 `action` 来区分添加回应与撤回回应。撤回回应时可以省略 `reaction` 和 `emoji`。目标 Meta 消息无需在 YCloud 本地拥有消息记录。事件信封中的 `createTime` 为源交互时间。

## 语法

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

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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 请求头。参见[签名验证](https://docs.ycloud.com/zh/api-reference/guides/api-fundamentals/configure-webhooks.md)。

### 事件信封

| 参数 | 类型 | 是否必填 | 说明 |
| - | - | - | - |
| `id` | string | 是 | 事件的唯一 ID。最小长度：`6`。最大长度：`128`。 |
| `type` | string | 是 | 固定为 `messenger.message_reaction.updated`。 |
| `apiVersion` | string | 是 | 用于呈现此事件的 API 版本。 |
| `createTime` | string (date-time) | 是 | 此事件创建的时间，格式采用 [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339)。例如 `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、电话号码和其他账户值仅供参考。

> [accordion] Messenger 消息回应
>
> 目标 Meta 消息无需在 YCloud 本地拥有消息记录。
>
> ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
> {
>   "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": "❤️"
>   }
> }
> ```

> [accordion] 撤回 Messenger 消息回应
>
> 撤回时可以省略回应名称和表情符号。
>
> ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
> {
>   "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 theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.