跳转到主要内容

Bot 可获取的群信息与管理动作

汇总 Bot 可通过 getChat / getChatAdministrators / getChatMember / getChatMemberCount 读取的群与成员信息,以及在管理权限下删除或撤回普通成员消息的边界,并区分 deleteMessage 与 recallMessage,说明常见 403/400 错误预期。

一句话结论

Bot 可通过 getChat* 系列读取群与成员资料;在具备相应管理权限时可删除或撤回普通成员的消息。不能撤回群主或其他管理员的消息。字段级细节以 core.mp.net/bots 为准。


总览

本文是能力索引。精确返回字段与错误码见 core.mp.net/bots

可读取的群信息

  • 群名称、群头像。

  • 成员头像、显示名、username(若有)。

  • 排序与展示由你方产品决定——API 返回数据,不规定 UI 顺序。

方法索引

方法

典型用途

getChat

群标题、头像与基础会话字段。

getChatAdministrators

列出群管理员。

getChatMember

单个成员的状态 / 资料字段。

getChatMemberCount

成员数量。

字段路径遵循官方 Chat / ChatMember 类型,不要臆造字段名。

删除群成员聊天内容

权限足够时,Bot 可从群历史中删除消息。若被删消息仍被其它消息引用,客户端引用位显示「已删除的消息」。

撤回 vs 删除

  • recallMessage / recallMessages 是 MPChat 扩展的撤回语义方法。

  • deleteMessage / deleteMessages 仍是兼容删除方法(DocOnly / 兼容边界——读旧示例时两边都要留意)。

  • Bot 被设为管理员且具备撤回权限后,可撤回普通成员消息,不能撤回群主或其他管理员的消息。

  • 撤回还受可信发送时间窗口约束(官方撤回方法为 48 小时)。缺失 / 过期 → 400;权限不足 → 403

权限不足时的错误预期

Bot 不在群内或缺少管理权限时常见 403;非法 id / 过期撤回目标常见 400。写客户端文案前先对照线上方法页,勿写死未确认的错误句。

相关

权威来源

参数与错误细节以 core.mp.net/bots 为准。

这是否解答了您的问题?