私有频道概述
超级群服务支持创建私有频道,满足社区场景中只有指定用户可以在频道中沟通的业务需求。
已知限制
提示
私有频道功能目前有以下限制:
如果用户非私有频道成员,消息发送失败后会进入本地数据库。如果用户未在私有频道成员列表中,但仍往频道中发送消息,此时消息无法成功发送到服务端,但会进入本地数据库(不适用于 Web 端),并可生成会话。
建议解决方案:开发者在 App 业务侧维护一份私有频道成员列表数据,如果用户未在私有频道成员列表中 ,禁止用户往私有频道发送消息。
了解私有频道
超级群的频道按类型区分为公有频道与私有频道。公有频道对所有超级群成员开放(无需加入)。该超级群的所有成员都会接收公有频道下的消息。私有频道仅对该频道的成员列表开放,仅频道成员可在该频道中收发消息、接收频道状态变化的通知。私有频道可以随时切换为公有频道,公有频道也可以切换为私有频道。
例如,管理员在社区中新创建一个频道,并定义为私有频道。接着邀请社区中部分成员加入私有频道。只有加入频道的成员才可以浏览此频道,并在频道中接收、发送消息。
频道变更会影响该频道下服务端历史消息的拉取权限,具体如下:
- 公有频道转换为私有频道:仅当前私有频道成员列表中的用户可以拉取该频道下的历史消息(含原公有频道消息);
- 私有频道转换为公有频道:所有超级群用户均可拉取该频道下的历史消息(含原私有频道消息)。
您可以通过以下方式管理私有频道:
功能描述 | 客户端 API | 即时通讯服务端 API |
---|---|---|
创建私有频道 | 不提供该 API | 创建频道 |
删除私有频道 | 不提供该 API | 删除频道 |
查询频道列表 | 不提供该 API | 查询频道列表 |
变更频道类型 | 不提供该 API | 变更频道类型 |
了解私有频道成员列表
频道类型为私有频道时,只有该列表中用户可在频道中的收发消息、接收频道内状态通知。
私有频道转为公有频道时,频道变更为对所有超级群成员开放。但该列表数据不会被删除。假设频道类型再次变更为私有,则启用该成员列表。
您也可以为公有频道创建私有频道成员列表。一旦该公有频道变更类型为私有频道,该列表即生效。
提示
- 删除频道时,服务端会清除该频道的私有频道成员列表。
- 一旦超级群成员退群,服务端会自动将用户从私有频道成员列表移除。
您可以通过以下方式管理私有频道成员列表:
功能描述 | 客户端 API | 即时通讯服务端 API |
---|---|---|
加入私有频道成员列表 | 不提供该 API | 添加私有频道成员 |
移出私有频道成员列表 | 不提供该 API | 删除私有频道成员 |
查询私有频道成员列表 | 不提供该 API | 查询私有频道成员列表 |