使用者、群組、聊天室與訊息
除了透過服務端 REST API，你的團隊也可以在控制檯中直接管理應用裡的 IM 使用者、群組、聊天室、訊息、通話和檔案，適合排查問題、處理使用者投訴和日常運營。這些功能在應用詳情的“IM 使用者”“群組”“訊息”“聊天室”“音影片”和“檔案儲存”標籤頁中，另外控制檯的概覽和應用詳情的“概覽與設定”中顯示應用的使用者數和連線統計。
控制檯中的操作與對應的服務端介面效果相同，例如在控制檯中封禁使用者，他的裝置同樣會立即下線。各項操作的詳細規則見每節末尾連結的服務端 API 文件。
所有成員都可以檢視使用者、群組和聊天室，建立使用者、群組和聊天室，檢視通話和儲存用量，上傳檔案；封禁、刪除、禁言等處置操作，檢視訊息和聊天室最近的訊息，結束通話，以及檢視、下載和刪除檔案需要 owner 或 admin，見角色與許可權。
使用者數與連線統計
控制檯概覽的實時指標和應用詳情“概覽與設定”的頂部顯示：
| 專案 | 說明 |
|---|---|
| IM 使用者數 | 應用當前的使用者數（已刪除的不計），有上限時同時顯示上限。上限是應用套餐的註冊使用者數 |
| 當前長連線 | 當前與服務保持長連線的客戶端連線數 |
| 今日活躍使用者 | 今天至少建立過一次長連線的使用者數。只呼叫 HTTP 介面、從不建立長連線的使用者不計入 |
| 本月活躍使用者 | 本月至少建立過一次長連線的使用者數 |
“今天”和“本月”按北京時間劃分。當天和當月的資料隨時更新，週期結束後不再變化。
IM 使用者
“IM 使用者”標籤頁列出應用中的使用者，可以按使用者名稱字首和狀態（正常、已封禁）查詢。列表中顯示使用者名稱、暱稱、狀態、是否設定了密碼、建立方式、最近登入時間和建立時間。
使用者名稱字首最多 64 個字元，僅支援英文字母、數字、下劃線（_）、連字元（-）和點（.）；輸入框顯示當前字數並限制輸入長度。點選“查詢”時先校驗輸入，格式有誤會提示修改，透過後才發起請求；字首留空表示不按使用者名稱篩選。
查詢成功但沒有匹配項時，頁面提示“未找到符合條件的使用者，請調整查詢條件”；沒有篩選條件且應用確實沒有使用者時，才提示建立使用者。請求失敗時顯示“使用者列表載入失敗”和錯誤原因，可點選“重試”重新載入。
建立使用者
點選“建立使用者”，填寫：
| 欄位 | 說明 |
|---|---|
| 使用者名稱 | 1 到 64 個英文字母、數字、下劃線、點或連字元，不能僅為一個或兩個點。輸入框顯示當前字數（如 5 / 64）並限制輸入長度；儲存為小寫，建立後不能修改 |
| 密碼 | 可選，1 到 64 個字元。設定後使用者可以在客戶端用使用者名稱和密碼登入；不設定時只能由服務端簽發的登入憑證登入 |
| 暱稱 | 可選，最多 64 個字元 |
| 頭像地址 | 可選，http 或 https 地址 |
使用者名稱規則和其他建立方式見使用者管理。
檢視和修改使用者
點選列表中的一行，開啟使用者詳情，有以下幾個標籤頁：
| 標籤頁 | 內容 |
|---|---|
| 資料 | 狀態、是否線上、暱稱、頭像、是否設定了密碼、封禁資訊、全域性禁言、自定義屬性、建立和最近登入時間 |
| 登入裝置 | 使用者當前登入的裝置（裝置、平臺、登入方式、IP、登入時間），以及當前的長連線 |
| 推送 | 登記了推送的裝置和令牌、推送設定和會話免打擾，可以解綁裝置、修改推送設定和發測試推送，見使用者的推送裝置與設定 |
| 好友 | 使用者的好友列表，可以“解除”某個好友關係，見好友 |
| 加入的群 | 使用者加入的群 |
在“資料”中可以：
- 修改資料：修改暱稱和頭像，見使用者管理。頭像可以直接填寫圖片地址，也可以點選頭像地址旁的“上傳”，選擇一張 JPEG、PNG、GIF 或 WebP 圖片（5 MB 以內）作為這個使用者的頭像：圖片縮放為長邊不超過 640 畫素後儲存，地址自動填入，點選“確定”儲存資料後生效；
- 設定密碼（
owner、admin）：為使用者設定新密碼，該使用者全部裝置上的登入隨即失效，需要用新密碼重新登入，見密碼與封禁。
上傳的頭像屬於這個使用者，地址可以公開訪問。上傳後 24 小時內沒有儲存到他的資料中的頭像會被自動刪除；更換頭像後，原來上傳的頭像 7 天后刪除。
封禁與解封
owner 或 admin 在使用者的“資料”中點選“封禁”，可以填寫原因和時長（1 到 87600 小時，不填為永久）。封禁後：
- 使用者全部裝置上的登入立即失效，線上的裝置被斷開，不能再登入；
- 使用者的資料、好友、群和訊息都保留；
- 到期後自動解封，也可以點選“解封”提前解封。解封后使用者需要重新登入。
如果使用者被平臺封禁，資料中顯示“平臺封禁”，只能由平臺解封，控制檯中不能解封或刪除。詳見密碼與封禁。
全域性禁言
owner 或 admin 在“資料”中點選“全域性禁言”，選擇場景（單聊、群聊或聊天室），可以填寫時長（分鐘，不填為永久）和原因。被禁言的使用者不能在客戶端傳送對應場景的訊息，其他功能不受影響；服務端以他的身份傳送不受限制。已有的禁言顯示在“全域性禁言”一項中，點選標籤上的關閉按鈕可以解除。詳見全域性禁言。
踢下線
在使用者的“登入裝置”中：
- 點選某臺裝置的“踢下線”，這臺裝置的登入失效並斷開連線，需要重新登入；
- 點選“踢掉全部裝置”，使用者的全部裝置立即下線，需要重新登入。
踢下線不會阻止使用者再次登入；要阻止登入請封禁使用者。詳見登入與登入裝置。
刪除使用者
owner 或 admin 在“資料”中點選“刪除”。刪除後使用者全部裝置下線，資料被清空，他上傳的頭像隨即刪除，不能恢復；使用者名稱被釋放，之後可以重新註冊同名的使用者。他發過的訊息預設保留，應用開啟了刪除使用者時擦除他發過的訊息的，這些訊息會被清空，他上傳的訊息附件和群檔案也被刪除。詳見使用者管理。
群組
“群組”標籤頁列出應用中的群，可以按群名稱字首、群主使用者名稱和狀態（正常、已封禁、已解散）查詢。列表中顯示群名稱、群 ID、型別、群主、人數（當前人數 / 上限）、狀態和建立時間。
建立群組
點選“建立群組”，填寫：
| 欄位 | 說明 |
|---|---|
| 群主（使用者名稱） | 群主必須是應用中已有的使用者 |
| 初始成員 | 可選，使用者名稱之間用逗號或空格分隔，最多 100 個 |
| 群名稱 | 可選，最多 64 個字元 |
| 型別 | 私有群：只能被邀請加入；公開群：使用者可以申請加入 |
| 簡介 | 可選，最多 512 個字元 |
部分初始成員不能加入時（如使用者不存在、加入的群數已達上限），群照常建立，頁面列出沒有加入的成員和原因。詳見群組管理。
管理群組
點選列表中的一行，開啟群詳情。所有成員都可以：
- 轉讓群主：填寫新群主的使用者名稱，新群主必須是群成員；
- 新增成員：在成員列表上方填寫使用者名稱（用逗號或空格分隔），點選“新增”；
- 設為管理員、取消管理員、移出：在成員列表中對某個成員操作。
owner 或 admin 還可以：
- 全員禁言：開啟開關後，只有群主和群管理員可以在群裡發言；
- 禁言、解除禁言：禁止某個成員在群裡發言，直到解除；
- 封禁、解封：封禁期間成員保留，但群裡不能發言，也不能加入新成員；可以填寫原因，原因不會展示給群成員。被平臺封禁的群只能由平臺解封；
- 解散：解散後成員都不能再在群裡發言，群檔案隨之刪除，不能恢復。
聊天室
“聊天室”標籤頁的上方是聊天室統計，下方列出應用中的聊天室，可以按名稱字首、所有者的使用者名稱和狀態（正常、已封禁、已解散）查詢，不選狀態時列出正常和已封禁的。列表中顯示名稱、聊天室 ID、所有者、線上人數（當前人數 / 上限）、是否出現在客戶端的聊天室列表中、狀態和建立時間。聊天室的概念和規則見聊天室管理。
聊天室統計
| 專案 | 說明 |
|---|---|
| 今天的訊息數、本月的訊息數 | 應用的全部聊天室中發出的訊息條數 |
| 今天的連線數峰值、本月的連線數峰值 | 應用的全部聊天室中同時線上的連線數的最大值，每分鐘統計一次。今天的峰值旁顯示出現的時間 |
下方可以選擇按日或按月檢視一段時間的歷史，按日一次最多 92 天，按月最多 24 個月，沒有聊天室活動的日期或月份不列出。“已定稿”表示這一天或這個月已經結束、數值不再變化。“今天”和“本月”按北京時間劃分。
建立聊天室
點選“建立聊天室”，填寫：
| 欄位 | 說明 |
|---|---|
| 名稱 | 1 到 128 個字元 |
| 所有者（使用者名稱，可選） | 必須是應用中已有的使用者，不要求他在聊天室裡。不填時沒有所有者，由你的服務端管理 |
| 簡介 | 可選，最多 512 個字元 |
| 公告 | 可選，最多 2048 個字元 |
| 人數上限 | 可選，1 到 500000。不填時跟隨執行策略中的聊天室人數上限，填寫後取兩者中較小的一個 |
| 出現在客戶端的聊天室列表中 | 預設開啟。關閉後使用者只能按聊天室 ID 進入 |
應用中未解散的聊天室數達到上限時不能再建立，上限由應用的套餐和平臺的配額決定。詳見建立聊天室。
管理聊天室
點選列表中的一行，開啟聊天室詳情，上方顯示狀態（被封禁的另外標出是平臺封禁還是租戶封禁，以及原因）、線上人數和上限、所有者、管理員、全員禁言、建立方式、屬性數、簡介和公告。所有成員都可以：
- 修改資料：修改名稱、簡介、公告、封面地址、人數上限和是否出現在聊天室列表中。人數上限清空後跟隨執行策略。儲存時如果提示資料已被其他人修改，請重新整理後重新修改；
- 轉讓所有者：填寫新所有者的使用者名稱，不要求他在聊天室裡；
- 設定管理員、取消管理員：在“管理員”中操作，每個聊天室最多 99 個管理員，被封禁的使用者不能設為管理員；
- 設定屬性、刪除屬性：在“屬性”中操作。控制檯設定的屬性與服務端設定的相同，會覆蓋任何人設定的同名鍵，見聊天室屬性。
owner 或 admin 還可以：
- 全員禁言：開啟開關後，只有所有者、管理員和白名單中的使用者可以在客戶端發言；
- 禁言、移出、封禁：在“線上成員”中對某個使用者操作（禁言為 1 小時），或在“禁言名單”“封禁名單”中填寫使用者名稱（多個用逗號或空格分隔）、時長（分鐘，不填為永久）和原因，批次禁言或封禁。被移出的使用者可以再次進入，被封禁的使用者在封禁期間不能進入。所有者不能被禁言、移出或封禁；
- 白名單：在“白名單”中新增或移出使用者，白名單中的使用者在全員禁言時仍可以發言；
- 解除禁言、解除封禁：在名單中點選“解除”；
- 封禁、解封聊天室：封禁時可以填寫原因，原因不會展示給客戶端。封禁後線上使用者全部被移出，期間不能進入和傳送訊息。被平臺封禁的聊天室只能由平臺解封；
- 解散：線上使用者全部被移出，聊天室不能恢復。
聊天室的訊息
owner 和 admin 在聊天室詳情的“最近的訊息”中檢視和傳送聊天室訊息，例如排查投訴或傳送系統通知。每次檢視和傳送都要先在上方填寫原因（最多 256 個字元），原因寫入操作日誌，訊息內容不寫入。
- 檢視最近的訊息：列出聊天室儲存的最近的訊息，包括時間、傳送者和身份、內容（文字直接顯示，其他型別只顯示型別）、優先順序和來源；
- 撤回：點選訊息右側的“撤回”，聊天室中的線上成員會收到撤回的通知；
- 傳送訊息：填寫傳送者的使用者名稱、優先順序（高優先順序、普通、低優先順序）和文字內容，點選“傳送”。傳送者不填時以系統的身份傳送；指定使用者時以他的身份傳送，需要重新驗證身份。
控制檯只能傳送文字訊息。傳送其他型別的訊息，請使用服務端的傳送聊天室訊息介面。
訊息
“訊息”標籤頁用於排查問題時檢視使用者的會話和訊息，或以使用者身份傳送訊息。這些操作只有 owner 和 admin 可以使用，並且：
訊息屬於你的使用者的隱私
請只在處理投訴、排查問題等必要時檢視訊息，並如實填寫原因。租戶的 owner 和 admin 可以在操作日誌中看到誰在什麼時候、以什麼原因檢視過訊息。
檢視會話和訊息
在“檢視使用者的會話和訊息”中輸入使用者名稱，點選“檢視會話”，左側列出他的會話（單聊顯示對方的使用者名稱，群聊顯示群 ID）以及訊息數和未讀數。點選一個會話，右側顯示其中的訊息：傳送者、序號、時間和傳送途徑，內容為文字時直接顯示；已撤回或被擦除的訊息顯示為“已撤回”“已擦除”。點選“載入更早的訊息”向前翻頁。
使用者傳送的訊息右側有“撤回”按鈕，撤回不受撤回時限的限制，會話中的成員會收到撤回通知。
服務端查詢訊息的介面見查詢與匯出訊息和會話與歷史訊息，撤回見撤回、編輯與置頂。
以使用者身份傳送訊息
在“以使用者身份傳送訊息”中填寫傳送者的使用者名稱，選擇發給使用者還是群，填寫接收者的使用者名稱或群 ID 和文字內容，點選“傳送”。發給群時可以不填傳送者，以系統身份傳送。傳送成功後頁面顯示訊息所在的會話、序號和訊息 ID。
控制檯只能傳送文字訊息。傳送其他型別的訊息或批次傳送，請使用服務端的傳送訊息介面。
音影片
“音影片”標籤頁顯示本應用的音影片能否使用、通話統計和通話列表。所有成員都可以檢視，owner 和 admin 可以結束通話和把成員移出通話。是否開啟音影片、振鈴時間和群通話人數上限在執行策略中設定。通話的規則見音視訊通話。
頁面頂部顯示音影片的狀態：
| 狀態 | 說明 |
|---|---|
| 音影片可以使用 | 平臺已有媒體服務；實際通話還須應用策略開啟、新模式下本應用音影片餘額為正、併發額度及應用狀態允許。切換前按歷史套餐許可權 |
| 本應用的音影片已被平臺停用 | 同時顯示停用的原因和時間。停用時進行中的通話立即結束，之後不能發起、接聽和加入通話。如有異議請聯絡我們 |
| 音影片服務暫不可用 | 平臺還沒有可用的媒體服務，不能發起通話，請聯絡我們 |
通話統計
選擇日期範圍（預設最近 7 天，一次最多 92 天），頂部顯示這段時間的合計：
| 專案 | 說明 |
|---|---|
| 通話數 | 這段時間內結束的通話數 |
| 接通率 | 接透過的通話佔通話數的比例 |
| 平均接通等待 | 接透過的通話從發起到接通平均等待的時間 |
| 語音計費分鐘、影片計費分鐘 | 歷史報表欄位，按成員及通話取整；不是新模式實際扣費的標準分鐘。口徑見通話統計，實際扣減見音影片計費 |
| 媒體沒連上的人次 | 加入了通話、但一直沒有連上媒體服務的人次。比例明顯偏高時，可能是部分使用者的網路無法連線媒體服務，請聯絡我們排查 |
下方的表格按天列出通話數、群通話數、接通數、無人接聽、拒絕和忙線、中斷的通話數，通話時長，語音和影片的計費分鐘數，以及同時進行的通話數的峰值。通話計入它結束的那一天，日期按北京時間劃分；沒有通話的日期不列出。
通話列表
通話列表可以按參與過的使用者名稱、群 ID、型別（一對一、群通話）和狀態（振鈴中、通話中、已結束）查詢，顯示通話 ID、型別和媒體（語音、影片）、發起人、人數、狀態和結束原因、時長、計費分鐘數和發起時間。
點選一行開啟通話詳情，顯示結束方、發起、接通和結束的時間、人數上限、同時在通話中的最多人數和自定義欄位，以及每個成員的角色（發起人、被邀請、自己加入）、狀態、離開原因、加入通話的平臺、通話時長和連上媒體服務的時間。狀態和原因的含義見通話的狀態。
對還沒有結束的通話，owner 和 admin 可以：
- 結束通話：點選右上角的“結束通話”，可以填寫原因。在通話中的成員全部離開，正在振鈴的邀請被取消；
- 移出：把在通話中或正在振鈴的成員移出通話，可以填寫原因。一對一通話中移出任何一方等同結束通話。
結束通話和移出成員寫入操作日誌。詳見結束通話和把成員移出通話。
檔案儲存
“檔案儲存”標籤頁顯示應用的儲存用量，owner 和 admin 可以在這裡檢視、下載和刪除應用中的檔案，例如處理使用者對某張圖片或某個群檔案的投訴。所有成員都可以上傳檔案，用於測試或運營。檔案的用途、地址和保留規則見檔案概述。
租戶暫停或處於登出冷靜期時，仍可以檢視用量、檢視和下載檔案，但不能上傳和刪除；應用停用時同樣不能上傳和刪除。
儲存用量
頁面頂部的“儲存用量”中顯示：
| 專案 | 說明 |
|---|---|
| 已用 | 應用中可用的檔案佔用的空間，圖片包括縮圖。上傳中、已刪除和被遮蔽的檔案不計入 |
| 額度 | 應用的儲存額度：平臺為應用設定的儲存配額（預設 1024 GB）與應用套餐的儲存容量中較小的一個 |
| 按用途 | 訊息附件、使用者頭像、群頭像、群檔案各自的檔案數和佔用空間 |
已用加上新檔案的大小超過額度時，新的上傳會失敗，提示“應用的儲存額度已滿”；已有的檔案不受影響，照常可以下載。請刪除不再需要的檔案，或縮短附件保留天數；需要更大的額度時請更換套餐或聯絡我們。
檢視檔案
owner 和 admin 可以在用量下方查詢檔案，每次按以下一種條件查詢：
- 按用途：訊息附件、使用者頭像、群頭像或群檔案；
- 按所屬使用者：填寫使用者名稱，列出屬於這個使用者的檔案，包括他在客戶端上傳的檔案和他的使用者頭像；
- 按群 ID：列出這個群的群檔案。
另外選擇狀態：可用、上傳中、已遮蔽或已刪除，預設為可用。查詢結果按上傳時間從新到舊排列，列表中顯示檔案 ID、檔名、用途、型別和格式、大小、所屬使用者、狀態和上傳時間；滑鼠移到已刪除或已遮蔽的狀態上，可以看到刪除原因或遮蔽原因。
點選一行開啟“檔案資訊”，另外顯示：
| 專案 | 說明 |
|---|---|
| 寬高 | 圖片的寬和高，單位為畫素 |
| 群 | 群檔案所屬的群 ID |
| 正在使用 | 頭像是否正在被使用者或群的資料使用 |
| 上傳方式 | client（客戶端）、openapi（服務端）或 console（控制檯） |
| 地址 | 訊息附件和群檔案為檔案地址，頭像為公開地址 |
| 過期時間 | 訊息附件和設定了保留天數的群檔案按當前的保留天數算出的過期時間，其他檔案顯示“不過期” |
“已遮蔽”的檔案是因違規被遮蔽的檔案，資訊中顯示遮蔽原因，以及是按平臺的規則還是租戶的規則遮蔽的。被遮蔽的檔案不能下載，也不能刪除；如有異議請聯絡我們。
下載檔案
檔案狀態為“可用”時，可以在列表的“操作”一列中下載或檢視：
- 訊息附件和群檔案：點選“下載”，填寫原因（最多 256 個字元，如“處理投訴 123”），按提示重新驗證身份後，瀏覽器在新視窗中開啟檔案。每次下載都寫入操作日誌，包括填寫的原因。開啟的下載地址只在一段時間內有效（最長 90 分鐘），不要轉發給他人；
- 頭像：點選“檢視”，直接開啟頭像的公開地址，不需要原因。
附件和群檔案屬於你的使用者的隱私
請只在處理投訴、排查問題等必要時下載使用者的檔案，並如實填寫原因。租戶的 owner 和 admin 可以在操作日誌中看到誰在什麼時候、以什麼原因下載過檔案。
刪除檔案
owner 或 admin 點選可用檔案的“刪除”，確認後：
- 檔案立即不能再換取下載地址，客戶端下載時提示“檔案已過期”；引用這個檔案的訊息仍在會話中。之前已經開啟的下載地址在到期前（最長 90 分鐘）可能仍然可用；
- 檔案隨後從儲存中刪除，不能恢復；
- 儲存用量隨即減少；
- 刪除操作寫入操作日誌。
刪除正在使用的頭像不會修改使用者或群的資料，資料中的頭像地址隨後無法訪問。要更換某個使用者的頭像，請在使用者的“資料”中修改資料。
上傳檔案
在“儲存用量”右上角點選“上傳檔案”，選擇用途，按需填寫：
| 欄位 | 說明 |
|---|---|
| 用途 | 訊息附件、使用者頭像、群頭像或群檔案 |
| 所屬使用者（使用者名稱） | 使用者頭像必須填寫，為使用這個頭像的使用者；其他用途可選 |
| 群 ID | 只有群檔案需要填寫，檔案上傳到這個群的群檔案中。群必須存在且沒有解散，每個群最多 1000 個群檔案 |
點選“選擇檔案並上傳”選擇本地檔案，上傳完成後頁面顯示檔案的地址，可以複製使用，例如在服務端傳送訊息時作為圖片、檔案訊息的地址，或作為使用者、群的頭像地址。
- 訊息附件和群檔案中，20 MB 以內的 JPEG、PNG、GIF、WebP 圖片按圖片上傳（生成縮圖），影片按影片上傳，其他按檔案上傳。大小上限見執行策略中的附件和群檔案的大小上限，預設 100 MB；
- 頭像只能是 JPEG、PNG、GIF 或 WebP 圖片，5 MB 以內，上傳後縮放為長邊不超過 640 畫素；
- 上傳的訊息附件同樣按附件保留天數刪除；頭像上傳後 24 小時內沒有被使用者或群的資料使用的，會被自動刪除。
服務端上傳檔案的介面見上傳檔案，查詢和刪除檔案的介面見下載與管理檔案。
獨立 RTC 頻道
頻道在應用詳情單獨的“RTC 頻道”頁中管理，不在群組和聊天室的列表中。查詢、關閉、移出和封禁的說明見RTC 頻道管理。成員佔用的席位數、授權狀態和實際的媒體線上人數含義各不相同，不能用成員列表的長度代替佔用的席位數。
平臺跨應用查詢入口
本頁介紹租戶控制檯內的應用管理。平臺管理員的八類 IM 資料列表預設顯示跨應用最新記錄，並提供租戶／應用預選篩選；許可權和步驟見後臺 IM 資料查詢。檢視元資訊不代表已獲內容審查或處置許可權。