跳至主要內容

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。寫客戶端文案前先對照線上方法頁,勿寫死未確認的錯誤句。

群事件與入群申請

官方將來自 Kafka 的群事件和入群申請處理標為預發布。請先確認部署狀態,再配置所需的 Webhook 或輪詢事件類型。

相關

權威來源

參數與錯誤細節以 core.mp.net/bots 為準。

是否回答了您的問題?