後臺 IM 資料查詢
平臺管理後臺的“IM 資料”用於跨租戶定位記錄、處理工單和執行有許可權的處置。它與租戶控制台的應用資料頁不同：平臺列表可以不指定應用，租戶控制台只展示當前租戶允許訪問的資料。
預設看到什麼
進入 IM 使用者、群組、聊天室、音視訊通話、訊息審查、檔案審查、推送管控或回撥管控時，頁面直接展示當前可見的最新記錄，不必先輸入租戶和應用。列表按建立時間倒序、同一時間按 ID 倒序排列，預設每頁 20 條，可選 10、20、50、100 條。
“最新”是查詢時的結果，不表示即時訂閱：需要重新獲取時點選重新整理。列表不返回已刪除應用的資料；IM 使用者和推送憑據等還會排除相應的已刪除記錄。租戶級檔案可能沒有應用名，這不等於應用欄位丟失。
統一篩選欄
- 租戶：輸入名稱或部分
org_name搜尋候選，也可填寫完整租戶標識。 - 應用：先選擇租戶，再從聯動候選中搜索應用名稱或
app_name；候選支援繼續載入。 - 業務條件：按當前頁面填寫 ID／關鍵字，選擇狀態、型別等；通話列表還可以填寫參與者使用者名稱。
- 點選查詢。修改租戶後原應用會清空，避免把上一個租戶的應用留在條件中。清空條件後可重新檢視跨應用的最新資料。
- 查詢條件儲存在位址列，重新整理頁面或通過詳情頁返回時可恢復。更改條件後從第一頁開始，不繼續使用舊篩選條件的游標。
條件之間取交集。例如選擇某租戶、某應用、狀態為 active，再輸入群名片段，會同時滿足這四個條件才返回。ID 是精確匹配，資源名稱按字面包含匹配；%、_ 不是萬用字元。訊息和通話沒有名稱檢索，優先使用其 ID；不要把這裡的查詢當成訊息正文全文搜尋。
八類列表與許可權
| 頁面 | 常見篩選與返回資訊 | 最低角色 |
|---|---|---|
| IM 使用者 | 使用者標識／名稱片段、狀態、建立來源；暱稱、封禁方、最近登入時間 | viewer |
| 群組 | 群 ID／名稱片段、型別、狀態 | viewer |
| 聊天室 | ID／名稱片段、建立來源、狀態 | viewer |
| 音視訊通話 | 通話 ID、語音／影片、狀態、參與者使用者名稱 | viewer |
| 訊息審查 | 訊息 ID、訊息型別、正常／撤回／擦除狀態 | reviewer |
| 檔案審查 | 檔案 ID／名稱片段、型別、狀態 | reviewer |
| 推送管控 | 憑據 ID／名稱片段、渠道、狀態 | viewer |
| 回撥管控 | 地址記錄 ID／名稱片段、狀態 | viewer |
表格顯示所屬租戶、應用、資源標識、可用的名稱／型別／狀態、建立時間和詳情入口。reviewer、operator、finance 的許可權不是簡單的同名等級替代，具體以平臺角色與頁面許可權為準；super_admin 擁有管理許可權。
從列表到詳情與處置
點選名稱、ID 或“檢視詳情”，進入該記錄所屬應用的詳情。列表只提供定位所需元資訊：不返回訊息正文、檔案下載地址、推送金鑰或回撥憑據。
檢視訊息內容、解析／下載檔案、檢視留證、封禁、刪除等操作繼續使用原業務介面的許可權、原因、審計和重新驗證要求。能夠看到一條元資訊，不意味著能夠檢視全部內容或執行寫操作。遇到“需要重新驗證”時，完成平臺安全驗證後返回原操作；不要反覆重新整理登入代替驗證。
如果列表有記錄而詳情無法開啟，檢查角色、資源是否已被刪除、媒體模組是否啟用，以及所需處置許可權。許可權失敗不能解釋成“列表沒有資料”。
介面與分頁
這些是平臺登入身份介面，不是應用 App Token 的 OpenAPI。以下路徑均以 /platform/v1/im-data/ 開頭：
| 資源 | 路徑字尾 |
|---|---|
| 使用者、群組、聊天室、通話 | users、groups、chatrooms、calls |
| 訊息、檔案、推送、回撥 | messages、files、push、callbacks |
通用引數為 org、app、keyword、status、type、limit、cursor；通話另有 username。篩選可省略，limit 為 1–100，預設 20。返回 {items, next_cursor}；公共欄位為 id、name、type、status、org_name、app_name、created_at，使用者額外返回 nickname、disabled_by、last_login_at。
游標繫結資源種類與篩選條件。條件改變後使用舊遊標會返回引數錯誤，應清空游標重新查詢。檔案列表僅在媒體模組啟用時註冊。介面沒有提供掃描訊息正文或匯出全部敏感內容的旁路。
常見排查
| 現象 | 先檢查 |
|---|---|
| 應用候選為空 | 是否先選租戶、應用名／標識是否正確、是否還有下一頁候選 |
| 查詢結果為空 | 是否保留了過窄的狀態／型別／關鍵字，資源是否已刪除 |
| 查不到“最近更新”的舊記錄 | 預設按建立時間排序，不是按更新時間；用 ID 或其他條件定位 |
| 下一頁報游標錯誤 | 是否改變了條件或資源頁面後複用了舊遊標 |
| 能看列表，不能看內容 | 檢查內容審查許可權、操作原因和重新驗證要求 |
租戶自己的使用者、群組、訊息和通話操作見應用資料管理。