服务端 API/消息/消息管理/资源介绍
# 资源介绍
## 资源定义
Lark聊天中的一条消息。
## 字段说明
名称 | 类型 | 描述
---|---|---
message_id | string | 消息id，说明参见：[消息ID说明](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2)
root_id | string | 根消息id，用于回复消息场景，说明参见：[消息ID说明](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2)
parent_id | string | 父消息的id，用于回复消息场景，说明参见：[消息ID说明](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2)
msg_type | string | 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，类型定义请参考：[发送消息Content](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json)
create_time | string | 消息生成的时间戳（毫秒）
update_time | string | 消息更新的时间戳（毫秒）
deleted | boolean | 消息是否被撤回
updated | boolean | 消息是否被更新
chat_id | string | 所属的群
sender | sender | 发送者，可以是用户或应用
∟ id | string | 该字段标识发送者的id
∟ id_type | string | 该字段标识发送者的id类型，如`app_id`、`open_id`
∟ sender_type | string | 该字段标识发送者的类型，可选值有`user`， `app`
∟ tenant_key | string | 租户在Lark上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识
body | message_body | 消息内容
∟ content | string | 消息内容，json结构，不同msg_type对应不同内容。消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，具体格式说明参考：[发送消息Content](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json)
mentions | mention\[\] | 被@的人或机器人的id列表
∟ key | string | 被@的用户或机器人的序号。例如，第3个被@到的成员，值为“@_user_3”
∟ id | string | 被@的用户或者机器人的 ID
∟ id_type | string | 被@的用户或机器人 id 类型，如`open_id` ([什么是 Open ID？](https://open.larksuite.com/document/home/user-identity-introduction/open-id))
∟ name | string | 被@的用户或机器人的姓名
∟ tenant_key | string | tenant key，为租户在Lark上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识
thread_id | string | 消息所属的话题 ID（不返回说明该消息非话题消息），可通过该 ID 实现转发话题、获取话题中的所有消息等，请参见：[话题介绍](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/thread-introduction)
upper_message_id | string | 合并转发消息中，上一层级的消息id message_id，说明参见：[消息ID说明](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2)
### 数据示例
```json
{
"message_id": "om_dc13264520392913993dd051dba21dcf",
"root_id": "om_40eb06e7b84dc71c03e009ad3c754195",
"parent_id": "om_d4be107c616aed9c1da8ed8068570a9f",
"msg_type": "card",
"create_time": "1615380573411",
"update_time": "1615380573411",
"deleted": false,
"updated": false,
"chat_id": "oc_5ad11d72b830411d72b836c20",
"sender": {
"id": "cli_9f427eec54ae901b",
"id_type": "app_id",
"sender_type": "app",
"tenant_key": "736588c9260f175e"
},
"body": {
"content": "{\"text\":\"@_user_1 test content\"}"
},
"mentions": [
{
"key": "@_user_1",
"id": "ou_155184d1e73cbfb8973e5a9e698e74f2",
"id_type": "open_id",
"name": "Tom",
"tenant_key": "736588c9260f175e"
}
],
"thread_id": "omt_16f3c7e1268f1749",
"upper_message_id": "om_40eb06e7b84dc71c03e009ad3c754195"
}
```
## 消息相关ID说明
### 1、message_id 说明
`message_id` 是一条消息的唯一标识。当发送一条消息时，系统会自动生成唯一ID。
`message_id` 的格式是以om_ 开头的字符串，例如：om_934be5776f5a87239a298af9e74c0f72
**如何获取message_id?**
- 方式一：调用 [发送消息](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create) 接口，从响应的结果中获取 `message_id` 字段；
- 方式二：监听 [接收消息](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/events/receive)事件，从事件体中获得message实体的 `message_id` 字段
- 方式三：调用 [获取会话历史消息](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/list) 接口，从响应的结果中获取 `message_id` 字段
### 2、root_id 与 parent_id 说明
- `root_id`：如果某一条消息回复了其他的消息，则`root_id`为回复树上根消息的`message_id`
- `parent_id`: 如果某一条消息回复了另一条消息，则`parent_id`为被回复的这条消息的`message_id`
- 注意：话题群帖子内的回复消息，都是回复根消息，所以`root_id`和`parent_id`都是根消息ID。
**以下图的消息回复举例：**
- msg2 回复了 msg1，则 msg2 的 `root_id` 和 `parent_id` 均为 msg1 的 `message_id`；
- msg3 回复了msg2，则 msg3的`root_id` 是 msg1 的`message_id`，`parent_id` 是 msg2 的`message_id`
### 3、upper_message_id 说明
`upper_message_id` 是合并转发消息中子消息所在的合并转发消息的 `message_id`。
**以下图的消息回复举例：**
msg1，msg2，msg3是合并转发消息中的三条子消息，它们的`upper_message` 即为所在的合并转发消息的`message_id`。
