消息内嵌格式
::: warning 注意
- 消息不支持 markdown 格式,会自动移除 markdown 格式。
- 内嵌格式仅在
content
中会生效,在 Ark
和 Embed
中不生效。
:::
使用示例
async function demo() {
let { data } = await client.messageApi.postMessage(channelID, message);
}
参数说明
MessageToCreate
字段名 |
类型 |
描述 |
content |
string |
消息内容,参考支持的格式 |
image |
string |
图片 url 地址 |
msg_id |
string |
要回复的消息 id。带了 msg_id 视为被动回复消息,否则视为主动推送消息 |
支持的格式
类型 |
结构 |
描述 |
示例 |
@用户 |
<@user_id> |
解析为 @用户 标签 |
<@1234000000001> |
@所有人 |
@everyone |
解析为 @所有人 标签,需要机器人拥有发送 @所有人 消息的权限 |
@everyone |
#子频道 |
<#channel_id> |
解析为 #子频道 标签,点击可以跳转至子频道,仅支持当前频道内的子频道 |
<#12345> |
表情 |
<emoji:id> |
解析为系统表情,具体表情 id 参考 Emoji 列表,仅支持 type=1 的系统表情,type=2 的 emoji 表情直接按字符串填写即可 |
<emoji:4> 解析为得意表情 |
返回说明
返回Message 对象。
Message
字段名 |
类型 |
描述 |
id |
string |
消息 ID |
channel_id |
string |
子频道 ID |
guild_id |
string |
频道 ID |
content |
string |
消息内容 |
timestamp |
string |
消息创建时间,是个 iISO8601 timestamp 字符串,例:”2021-11-23T15:16:48+08:00” |
author |
User |
消息创建者 |
member |
Member |
消息创建者的 member 信息 |
User
字段名 |
类型 |
描述 |
id |
string |
用户 ID |
username |
string |
用户名 |
bot |
boolean |
是否是机器人 |
Member
字段名 |
类型 |
描述 |
roles |
string[] |
用户在频道内的身份组 ID,默认值可参考DefaultRoleIDs |
joined_at |
string |
用户加入频道的时间,是个 ISO8601 timestamp 字符串,例:”2021-11-23T15:16:48+08:00” |
DefaultRoleIDs
系统默认生成下列身份组 ID。
身份组 ID 默认值 |
描述 |
1 |
全体成员 |
2 |
管理员 |
4 |
群主/创建者 |
5 |
子频道管理员 |
返回示例
以发送文本内容<@!1234>hello world
为例,下面是返回示例:
data
:
{
"id": "xxxxxx",
"channel_id": "xxxxxx",
"guild_id": "xxxxxx",
"content": "<@!1234>hello world",
"timestamp": "2021-05-13T14:45:45+08:00",
"tts": false,
"mention_everyone": false,
"author": {
"id": "xxxxxx",
"username": "abc",
"avatar": "",
"bot": true
},
"embeds": [{}],
"pinned": false,
"type": 0,
"flags": 0
}