一句话结论
Bot 可通过 getChat* 系列读取群与成员资料;在具备相应管理权限时可删除或撤回普通成员的消息。不能撤回群主或其他管理员的消息。字段级细节以 core.mp.net/bots 为准。
总览
本文是能力索引。精确返回字段与错误码见 core.mp.net/bots。
可读取的群信息
群名称、群头像。
成员头像、显示名、username(若有)。
排序与展示由你方产品决定——API 返回数据,不规定 UI 顺序。
方法索引
方法 | 典型用途 |
| 群标题、头像与基础会话字段。 |
| 列出群管理员。 |
| 单个成员的状态 / 资料字段。 |
| 成员数量。 |
字段路径遵循官方 Chat / ChatMember 类型,不要臆造字段名。
删除群成员聊天内容
权限足够时,Bot 可从群历史中删除消息。若被删消息仍被其它消息引用,客户端引用位显示「已删除的消息」。
撤回 vs 删除
recallMessage/recallMessages是 MPChat 扩展的撤回语义方法。deleteMessage/deleteMessages仍是兼容删除方法(DocOnly / 兼容边界——读旧示例时两边都要留意)。Bot 被设为管理员且具备撤回权限后,可撤回普通成员消息,不能撤回群主或其他管理员的消息。
撤回还受可信发送时间窗口约束(官方撤回方法为 48 小时)。缺失 / 过期 →
400;权限不足 →403。
权限不足时的错误预期
Bot 不在群内或缺少管理权限时常见 403;非法 id / 过期撤回目标常见 400。写客户端文案前先对照线上方法页,勿写死未确认的错误句。
相关
API 方法矩阵
核心概念 / 群内 Privacy Mode
用户向:多 Bot 同群时指令如何排序
