跳至主要內容

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 為準。

是否回答了您的問題?