# 消息内嵌格式
注意
- 消息不支持 markdown 格式,会自动移除 markdown 格式
- 内嵌格式仅在 content 中会生效,在 Ark 和 Embed 中不生效
# 使用示例
import botpy
from botpy.message import Message
class MyClient(botpy.Client):
async def on_at_message_create(self, message: Message):
await self.api.post_message(channel_id="xxxx", content="xxx", msg_id="xxxx", embed=embed)
intents = botpy.Intents(public_guild_messages=True)
client = MyClient(intents=intents)
client.run(appid={appid}, token={token})
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
# 参数说明
参数 | 必填 | 类型 | 说明 |
---|---|---|---|
channelID | 是 | string | 子频道 ID |
content | string | 消息内容,参考支持的格式 | |
embed | Embed | embed 消息,一种特殊的 ark | |
ark | Ark | ark 消息 | |
image | string | 图片 url 地址 | |
msg_id | string | 要回复的消息 id。带了 msg_id 视为被动回复消息,否则视为主动推送消息 |
# Embed
字段名 | 类型 | 描述 |
---|---|---|
title | string | 标题 |
description | string | 描述 |
prompt | string | 消息弹窗内容 |
timestamp | string | 消息创建时间 |
fields | EmbedField[] | 消息创建时间,是个 ISO8601 timestamp 字符串,例:"2021-11-23T15:16:48+08:00" |
# EmbedField
字段名 | 类型 | 描述 |
---|---|---|
name | string | 字段名 |
# Ark
字段名 | 类型 | 描述 |
---|---|---|
template_id | number | ark 模板 id(需要先申请) |
kv | AkrKv[] | kv 值列表 |
# ArkKv
字段名 | 类型 | 描述 |
---|---|---|
key | string | key |
value | string | value |
obj | ArkObj[] | ark obj 类型的列表 |
# ArkObj
字段名 | 类型 | 描述 |
---|---|---|
obj_kv | ArkObjKv[] | ark objkv 列表 |
# ArkObjKv
字段名 | 类型 | 描述 |
---|---|---|
key | string | key |
value | string | value |
# 支持的格式
类型 | 结构 | 描述 | 示例 |
---|---|---|---|
@用户 | <@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
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21