一句話結論
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 同群時指令如何排序
