> ## 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.inbound_message.updated

> 当客户编辑已保存的 Messenger 接收文本消息时触发。

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

## 触发条件

当客户编辑已保存的 Messenger 接收文本消息时触发。

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

编辑后仍保留相同的消息 ID、`sendTime` 以及原始消息 `createTime`。事件外层的 `createTime` 为编辑时间。使用 `editCount` 和 `editTime` 跟踪累计编辑信息。

## 语法

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

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "<ID>",
  "type": "messenger.inbound_message.updated",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "messengerInboundMessage": {
    "id": "<ID>",
    "metaMessageId": "<META_MESSAGE_ID>",
    "from": "<FROM>",
    "to": "<TO>",
    "type": "<TYPE>",
    "text": {
      "body": "<BODY>"
    },
    "sendTime": "<SEND_TIME>",
    "createTime": "<CREATE_TIME>",
    "editCount": "<EDIT_COUNT_VALUE>",
    "editTime": "<EDIT_TIME>"
  }
}
```

## 参数

在处理 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.inbound_message.updated`。 |
| `apiVersion` | string | 是 | 用于呈现此事件的 API 版本。 |
| `createTime` | string (date-time) | 是 | 此事件的创建时间，格式采用 [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339)。例如：`2022-06-01T12:00:00.000Z`。 |

### 事件有效载荷

| 参数 | 类型 | 必填 | 描述 |
| - | - | - | - |
| `messengerInboundMessage` | object | 否 | 事件专属的 `messengerInboundMessage` 有效载荷。 |

外层的四个通用字段为必填项。有效载荷字段取决于事件变体。在每个对象表中， **必填** 仅在其父对象存在时适用。可选字段可以省略；示例中的字段并不代表该字段是必填的。

#### messengerInboundMessage

| 参数 | 类型 | 必填 | 描述 |
| - | - | - | - |
| `id` | string | 是 | YCloud 接收消息 ID，表示为十进制字符串。 |
| `metaMessageId` | string | 是 | Meta 消息 ID。 |
| `from` | string | 是 | 作用域限定为 Facebook 公共主页的客户 PSID。 |
| `to` | string | 是 | Facebook 公共主页 ID。 |
| `type` | string | 是 | 取值：`text`。 |
| `text` | object | 是 | 对象字段列于下方。 |
| `sendTime` | string (date-time) | 是 | 已保存的源事件时间，采用精确到毫秒的 UTC RFC 3339 格式。 |
| `createTime` | string (date-time) | 是 | 本地持久化时间，采用精确到毫秒的 UTC RFC 3339 格式。 |
| `editCount` | integer | 否 | Meta 提供的累计编辑次数。首次编辑前省略。 |
| `editTime` | string (date-time) | 否 | 平台保存的编辑时间，采用精确到毫秒的 UTC RFC 3339 格式。首次编辑前省略。 |

> [accordion] messengerInboundMessage.text
>
> | 参数 | 类型 | 必填 | 描述 |
> | - | - | - | - |
> | `body` | string | 是 | 非空白文本。前导和尾随空格将被保留，并在比较重复请求时一并计入。最小长度：`1`。 |

## 示例

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

同一条已保存的消息现在包含最新的文本和累计编辑信息。

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "evt_cdef0123456789abcdef0123",
  "type": "messenger.inbound_message.updated",
  "apiVersion": "v2",
  "createTime": "2026-10-20T02:01:00.000Z",
  "messengerInboundMessage": {
    "id": "1308528868252065793",
    "metaMessageId": "m_EXAMPLE_IN_001",
    "from": "100800000000000",
    "to": "422500000000000",
    "type": "text",
    "text": {
      "body": "  Hello, corrected  "
    },
    "sendTime": "2026-10-20T02:00:00.000Z",
    "createTime": "2026-10-20T02:00:00.100Z",
    "editCount": 2,
    "editTime": "2026-10-20T02:01:00.000Z"
  }
}
```

在验证签名并持久接收该事件后，返回 `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.