资源介绍

资源定义

飞书聊天中的一条消息。

字段说明

名称	类型	描述
message_id	string	消息id，说明参见：消息ID说明
root_id	string	根消息id，用于回复消息场景，说明参见：消息ID说明
parent_id	string	父消息的id，用于回复消息场景，说明参见：消息ID说明
msg_type	string	消息类型包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，类型定义请参考：发送消息Content
create_time	string	消息生成的时间戳（毫秒）
update_time	string	消息更新的时间戳（毫秒）
deleted	boolean	消息是否被撤回
updated	boolean	消息是否被更新
chat_id	string	所属的群
sender	sender	发送者，可以是用户或应用
∟ id	string	该字段标识发送者的id
∟ id_type	string	该字段标识发送者的id类型，可选值有`open_id`， `app_id`
∟ sender_type	string	该字段标识发送者的类型，可选值有`user`， `app`
∟ tenant_key	string	租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识
body	message_body	消息内容
∟ content	string	消息内容，json结构，不同msg_type对应不同内容。消息类型包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，具体格式说明参考：发送消息Content
mentions	mention[]	被@的人或机器人的id列表
∟ key	string	被@的用户或机器人的序号。例如，第3个被@到的成员，值为“@_user_3”
∟ id	string	被@的用户或者机器人的open_id
∟ id_type	string	被@的用户或机器人 id 类型，目前仅支持 `open_id` (什么是 Open ID？)
∟ name	string	被@的用户或机器人的姓名
∟ tenant_key	string	tenant key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识
upper_message_id	string	合并转发消息中，上一层级的消息id message_id，说明参见：消息ID说明

数据示例

{
        "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:测试消息"
        },
        "mentions": [
            {
                "key": "@_user_1",
                "id": "ou_155184d1e73cbfb8973e5a9e698e74f2",
                "id_type": "open_id",
                "name": "Tom",
                "tenant_key": "736588c9260f175e"
            }
        ],
        "upper_message_id": "om_40eb06e7b84dc71c03e009ad3c754195"
}

消息相关ID说明

1、message_id 说明

message_id 是一条消息的唯一标识。当发送一条消息时，系统会自动生成唯一ID。message_id 的格式是以om_ 开头的字符串，例如：om_934be5776f5a87239a298af9e74c0f72

如何获取message_id?

方式一：调用发送消息接口，从响应的结果中获取 message_id 字段；

方式二：监听接收消息事件，从事件体中获得message实体的 message_id 字段

方式三：调用获取会话历史消息接口，从响应的结果中获取 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。

资源定义#

字段说明#

数据示例#

消息相关ID说明#

1、message_id 说明#

2、root_id 与 parent_id 说明#