消息段

text 纯文本

参数示例

字段名	数据类型	说明
text	string	纯文本内容

{
    "type": "text",
    "data": {
        "text": "这是一个纯文本"
    }
}

mention 提及（即 @）

参数示例

字段名	数据类型	说明
user_id	string	提及的用户 ID

{
    "type": "mention",
    "data": {
        "user_id": "1234567"
    }
}

mention_all 提及所有人

参数示例

无。

{
    "type": "mention_all",
    "data": {}
}

image 图片

参数示例

字段名	数据类型	说明
file_id	string	图片文件 ID

{
    "type": "image",
    "data": {
        "file_id": "e30f9684-3d54-4f65-b2da-db291a477f16"
    }
}

voice 语音

参数示例

字段名	数据类型	说明
file_id	string	语音文件 ID

{
    "type": "voice",
    "data": {
        "file_id": "e30f9684-3d54-4f65-b2da-db291a477f16"
    }
}

audio 音频

提示

音频消息段和语音消息段的区别是：语音消息段在聊天软件中表现为用户当场录制的声音，而音频消息段可能是直接发送的一个音乐文件，在消息列表中显示为可播放。

参数示例

字段名	数据类型	说明
file_id	string	音频文件 ID

{
    "type": "audio",
    "data": {
        "file_id": "e30f9684-3d54-4f65-b2da-db291a477f16"
    }
}

video 视频

参数示例

字段名	数据类型	说明
file_id	string	视频文件 ID

{
    "type": "video",
    "data": {
        "file_id": "e30f9684-3d54-4f65-b2da-db291a477f16"
    }
}

file 文件

参数示例

字段名	数据类型	说明
file_id	string	文件 ID

{
    "type": "file",
    "data": {
        "file_id": "e30f9684-3d54-4f65-b2da-db291a477f16"
    }
}

location 位置

参数示例

字段名	数据类型	说明
latitude	float64	纬度
longitude	float64	经度
title	string	标题
content	string	地址内容

{
    "type": "location",
    "data": {
        "latitude": 31.032315,
        "longitude": 121.447127,
        "title": "上海交通大学闵行校区",
        "content": "中国上海市闵行区东川路800号"
    }
}

reply 回复

提示

在一些平台上回复消息会在消息内容中多加一个提及消息段，建议 OneBot 实现将该提及消息段合并到回复消息段。

参数示例

字段名	数据类型	说明
message_id	string	回复的消息 ID
user_id	string	回复的消息发送者 ID，发送时可以不传入

{
    "type": "reply",
    "data": {
        "message_id": "6283",
        "user_id": "1234567"
    }
}

message_nodes 合并转发消息

node 数据数型

字段名	数据类型	说明
user_id	string	该条消息的发送者
message	message	该条消息的内容

参数示例

字段名	数据类型	说明
nodes	list[node]	合并转发消息中的每条消息组成的数组

{
    "type": "message_nodes",
    "data": {
        "nodes": [
            {
                "user_id": "10086",
                "message": [
                    {
                        "type": "text",
                        "data": {
                            "text": "测试消息1"
                        }
                    }
                ]
            },
            {
                "user_id": "10087",
                "message": [
                    {
                        "type": "text",
                        "data": {
                            "text": "测试消息2"
                        }
                    }
                ]
            }
        ]
    }
}