用户、群组、聊天室与消息
除了通过服务端 REST API，你的团队也可以在控制台中直接管理应用里的 IM 用户、群组、聊天室、消息、通话和文件，适合排查问题、处理用户投诉和日常运营。这些功能在应用详情的“IM 用户”“群组”“消息”“聊天室”“音视频”和“文件存储”标签页中，另外“概览与设置”中显示应用的用户数和连接统计。
控制台中的操作与对应的服务端接口效果相同，例如在控制台中封禁用户，他的设备同样会立即下线。各项操作的详细规则见每节末尾链接的服务端 API 文档。
所有成员都可以查看用户、群组和聊天室，创建用户、群组和聊天室，查看通话和存储用量，上传文件；封禁、删除、禁言等处置操作，查看消息和聊天室最近的消息，结束通话，以及查看、下载和删除文件需要 owner 或 admin，见角色与权限。
用户数与连接统计
“概览与设置”的顶部显示：
| 项目 | 说明 |
|---|---|
| IM 用户数 | 应用当前的用户数（已删除的不计），有上限时同时显示上限。上限是应用套餐的注册用户数 |
| 当前长连接 | 当前与服务保持长连接的客户端连接数 |
| 今日活跃用户 | 今天至少建立过一次长连接的用户数。只调用 HTTP 接口、从不建立长连接的用户不计入 |
| 本月活跃用户 | 本月至少建立过一次长连接的用户数 |
“今天”和“本月”按北京时间划分。当天和当月的数据随时更新，周期结束后不再变化。
IM 用户
“IM 用户”标签页列出应用中的用户，可以按用户名前缀和状态（正常、已封禁）查询。列表中显示用户名、昵称、状态、是否设置了密码、创建方式、最近登录时间和创建时间。
创建用户
点击“创建用户”，填写：
| 字段 | 说明 |
|---|---|
| 用户名 | 1 到 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 频道管理。成员的占位数、授权状态和实际媒体在线数各有含义，不能用列表长度代替占位统计。