超级群场景指南

超级群（UltraGroup）面向大社区、频道化讨论与海量成员场景。rev22 起契约用独立会话类型 SUPER_GROUP(10) 表达超级群（存量 GROUP(2) + groupType=super 可读）；rev23 起消息可带 channelId 按频道投递并过滤历史；rev24 收紧 private 频道列表可见性并补齐各端频道 UI 组件。服务端与四端 SDK（Web/Electron/Android/Flutter）已提供频道/用户组操作、频道消息与频道选择组件；频道成员管理页仍未提供。

与普通群的差异​

核心模型​

超级群与频道​

超级群本身是成员关系的容器；频道（channel）是消息与成员可见性的细分。融云提供默认频道 RCDefault，所有成员可见且不可转私有；自建频道默认是私有频道，可切换为公有。本项目没有默认频道语义，频道完全由 API 显式创建。

私有频道​

私有频道（type=private，joinPolicy 推导为 invite）需要邀请或管理员身份才能加入；公有频道（public → open）对群成员开放。rev23 起频道消息按频道投递：私有频道发送者必须是频道成员（否则 1003），收件人仅频道成员；公有频道群成员可发送并自动加入频道。

用户组​

用户组用于批量管理频道成员：一个用户组可绑定多个频道，一个频道可绑定多个用户组。本项目提供用户组的创建/列表/按用户反查与“绑定到频道”（双向索引），单群 100 个频道、100 个用户组上限（超限 1015）；绑定用户组成员计入频道有效成员（并需仍是群成员）。

API 入口​

接入流程​

1. 确认服务开通

   创建 groupType=super 的群需要应用开通 supergroup 服务；未开通返回 1021。控制台/服务开通接口见「服务开通」模块。

2. 创建超级群

   调用 POST /group/create，传 groupId、name、owner、members、groupType: "super"。返回 Group，maxMembers 为 100000。

3. 设置加入策略

   默认 invite；需要公开加入时调用 supergroup.join.policy.set 设为 open。open 时用户可直接调用 group.join。

4. 创建频道与授权

   先创建频道（type=private 或 public），再按需切换；私有频道通过频道成员或用户组绑定授权。注意：当前授权关系不参与消息投递鉴权。

5. 收发消息

   rev22 起客户端按超级群会话发送（conversationType=SUPER_GROUP(10)、targetId=groupId）；rev23 起可在 options 带 channelId 发频道消息（仅频道成员接收，私有频道需成员、公有频道自动加入）。不带 channelId 是群级消息。详见「超级群频道级消息」。

配额与限制​

场景建议​

• 只需要大群：创建 super 群后只用一个群会话，不建频道；可直接复用群消息、历史与未读（rev22 起发送传 10）。
• 社区频道：用频道管理接口维护频道目录；rev23 起发送带 channelId 即按频道投递，rev24 起各端 IMKit 已带频道切换器（Web/Android/Flutter，Electron 复用 Web）。
• 私有频道权限：服务端强制私有频道发送需频道成员（1003），且 rev24 起列表对非成员隐藏 private 频道；建议业务层先校验再展示发送入口，避免无效请求。
• 默认免打扰：当前只能用会话级 conversation.settings 设置单个用户的免打扰，不能设置群/频道级默认值。

相关文档​

• 超级群会话类型：10 的语义、发送/历史/会话列表与限制
• 超级群频道级消息：channelId 路由、权限、历史过滤与限制
• 超级群频道消息迁移：群级 → 频道级迁移与回滚
• 超级群频道 UI 组件：各端组件/事件/主题/平台差异
• 私有频道列表可见性：rev24 过滤规则与 Open API userId
• C17 超级群能力收口
• 超级群类型迁移与兼容 FAQ：2+super 与 10 并存时的判断与回滚
• Web 用法 · Android 用法 · Flutter 用法 · Electron 用法
• Web 频道消息用法 · Android · Flutter · Electron

融云对应文档（证据）​

• 超级群概述
• 用户组概述
• 私有频道概述
• 设置群/频道默认免打扰