# 删除频道成员

移除频道的某个成员。

注意

  • 公域机器人暂不支持申请,仅私域机器人可用,选择私域机器人后默认开通。
  • 注意: 开通后需要先将机器人从频道移除,然后重新添加,方可生效。

# 使用示例

import botpy
from botpy.message import Message

class MyClient(botpy.Client):
    async def on_at_message_create(self, message: Message):
        await self.api.get_delete_member(
            guild_id="xxxx", 
            user_id="xxx", 
            add_blacklist=True, 
            delete_history_msg_days=7
        )

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
11
12
13
14
15

注意

  • 需要使用的 token 对应的用户具备踢人权限。如果是机器人,要求被添加为管理员。
  • 操作成功后,会触发频道成员删除事件

# 参数说明

字段名 必填 类型 描述
guild_id string 频道 ID
user_id string 用户 ID
add_blacklist bool 是否拉入黑名单
delete_history_msg_days int 撤回移除成员的消息,可指定撤回消息的时间范围

注:消息撤回时间范围仅支持固定的天数:3,7,15,30。 特殊的时间范围:-1: 撤回全部消息。默认值为0不撤回任何消息。

# 返回说明

# 返回示例

data:

{}
1
手机QQ扫码
开发者社区
加入官方频道开发者社区