消息格式兼容情况

消息列表

支持使用 CQ码 发送

标有 <JSON> 的表示 收到的时候的消息类型是 json

消息格式	介绍	收	发	备注
text	纯文本	✅	✅
face	qq 表情	✅	✅
image	图片	✅	✅
record	语音	✅	✅
video	视频	✅	✅
at	@某人	✅	✅
rps	猜拳魔法表情	✅	✅
dice	骰子	✅	✅
shake	私聊窗口抖动	❌	❌
poke	群聊戳一戳	✅	✅	事件上报与接口调用 不通过消息
share <JSON>	链接分享	✅	❌
contact <JSON>	推荐好友/群	✅	✅
location <JSON>	位置	✅	❌
music <JSON>	音乐分享	✅	✅
reply	回复消息	✅	✅
forward	转发消息	✅	✅
node	转发消息节点	✅	✅
json	json 信息	✅	✅
mface	qq 表情包	✅	✅	收到的 mface 会是 image, 见商城表情
file	文件	✅	✅
markdown	markdown	❌	✅	发是在双层合并转发内 无法直接发送
lightapp<JSON>	小程序卡片	✅	✅	发是调用扩展接口get_mini_app_ark

提示

标有 [收] 仅限收到

标有 [发] 仅限发送

标有 [选] 发送可选

text

{
  "type": "text",
  "data": {
    "text": "文本"
  }
}

face

{
  "type": "face",
  "data": {
    "id": "123"
  }
}

image

普通图片

{
  "type": "image",
  "data": {
    "name": "", // [发] [选]
    "summary": "", // [选]
    "file": "",
    "sub_type": "", // [选]
    "file_id": "", // [收]
    "url": "", // [收]
    "path": "", // [收]
    "file_size": "", // [收]
    "file_unique": "", // [收]
  }
}

商城表情

{
  "type": "image",
  "data": {
    "name": "", // [发] [选]
    "summary": "", // [选]
    "file": "marketface",
    "file_id": "", // [收]
    "url": "", // [收]
    "path": "", // [收]
    "file_unique": "", // [收]
  }
}

record

{
  "type": "record",
  "data": {
    "file": "",
    "name": "", // [发] [选]
    "url": "", // [收]
    "path": "", // [收]
    "file_id": "", // [收]
    "file_size": "", // [收]
    "file_unique": "", // [收]
  }
}

video

{
  "type": "video",
  "data": {
    "file": "",
    "name": "", // [发] [选]
    "thumb": "", // [发] [选]
    "url": "", // [收]
    "path": "", // [收]
    "file_id": "", // [收]
    "file_size": "", // [收]
    "file_unique": "", // [收]
  }
}

at

{
  "type": "at",
  "data": {
    "qq": "10001",
    "qq": "all" // @全体
  }
}

rps

{
  "type": "rps",
  "data": {
    "result": "" // [收]
  }
}

dice

{
  "type": "dice",
  "data": {
    "result": "" // [收]
  }
}

contact

{
  "type": "contact",
  "data": {
    "type": "qq", // [发] 推荐好友
    "type": "group", // [发] 推荐群聊
    "id": "10001" // [发] QQ号或群号
  }
}

music

现有音源

{
  "type": "music",
  "data": {
    "type": "qq", // [发]
    "type": "163", // [发]
    "type": "kugou", // [发]
    "type": "migu", // [发]
    "type": "kuwo", // [发]
    "id": "" // [发]
  }
}

自定义音源

{
  "type": "music",
  "data": {
    "type": "custom", // [发]
    "url": "", // [发] 点击后跳转目标 URL
    "audio": "", // [发] 音乐 URL
    "title": "", // [发]
    "image": "kuwo", // [发] [选]
    "singer": "kuwo", // [发] [选]
  }
}

reply

{
  "type": "reply",
  "data": {
    "id": ""
  }
}

forward

{
  "type": "forward",
  "data": {
    "id": "",
    "content": [] // [收]
  }
}

node

TIP

id 和 content 二选一

现有信息

{
  "type": "node",
  "data": {
    "id": "", // [发]
    "content": [] // [发]
  }
}

伪造信息

{
  "type": "node",
  "data": {
    "user_id": "10001", // [发]
    "nickname": "雪雪看不见我", // [发]
    "id": "", // [发]
    "content": [] // [发]
  }
}

json

{
  "type": "json",
  "data": {
    "data": ""
  }
}

mface

{
  "type": "mface",
  "data": {
    "emoji_id": "", // [发]
    "emoji_package_id": "", // [发]
    "key": "", // [发]
    "summary": "" // [选]
  }
}

file

{
  "type": "file",
  "data": {
    "name": "", // [发] [选]
    "file": "empty",
    "path": "empty", // [收]
    "url": "empty", // [收]
    "file_id": "empty", // [收]
    "file_size": "empty", // [收]
    "file_unique": "empty" // [收]
  }
}