后台 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 或其他条件定位 |
| 下一页报游标错误 | 是否改变了条件或资源页面后复用了旧游标 |
| 能看列表,不能看内容 | 检查内容审查权限、操作原因和重新验证要求 |
租户自己的用户、群组、消息和通话操作见应用数据管理。
