Botpy-Docs

创建精华消息

用于将messageId添加为子频道 channelId 内的精华消息。

注意

  • 精华消息在一个子频道内最多只能创建 20 条。
  • 只有可见的消息才能被设置为精华消息。
  • 接口返回对象中 message_ids 为当前请求后子频道内所有精华消息 message_id 数组。

使用示例

import botpy

from botpy.message import Message

class MyClient(botpy.Client):
    async def on_at_message_create(self, message: Message):
        await self.api.put_pin(channel_id=message.channel_id, message_id=message.id)

intents = botpy.Intents(public_guild_messages=True)
client = MyClient(intents=intents)
client.run(appid={appid}, token={token})

参数说明

字段名必填类型描述
channel_id是string子频道 ID
message_id是string消息 ID

返回说明

返回 PinsMessage 对象。

PinsMessage

字段名类型描述
guild_idstring频道 ID
channel_idstring子频道 ID
message_idsstring 列表消息 ID 列表

返回示例

data：

{
  "guild_id": "xxxxxx",
  "channel_id": "xxxxxx",
  "message_ids": ["xxxxx"]
}