服务介绍
欢迎使用融云即时通讯。本页面简单介绍了融云即时通讯架构、体系和关键概念。
融云的架构设计特点：
- 无需改变现有 App 的架构，直接嵌入现有代码框架中；
- 无需改变现有 App Server 的架构，独立部署一份用于用户授权的 Service 即可；
- 专注于提供通讯能力，使用私有的二进制通信协议，消息轻量、有序、不丢消息；
- 安全的身份认证和授权方式，无需担心 SDK 能力滥用（盗用身份的垃圾消息、垃圾群发）问题。
融云即时通讯服务不要求在 App 之外建立并行的用户体系，不需要您同步 App 的用户资料到融云，不影响 App 现有的系统架构与帐号体系，与现有业务体系能够实现完美融合。
功能特性
融云目前已提供即时通讯产品单聊、群聊、超级群、聊天室，在融云业务中，这些产品对应不同的会话类型。
单聊（Private）业务即一对一聊天。群组（Group）业务类似微信群。超级群与聊天室业务均不设用户总数上限。超级群（UltraGroup） 类似 Discord，提供了一种新的群组业务形态，在超级群中提供公有/私有频道、用户组等功能，适用于构建超级社区。聊天室（Chatroom）只有在线用户可接收消息，广泛适用于直播、社区、游戏、广场交友、兴趣讨论等场景。
单聊、群组、超级群、聊天室的主要差异如下：
| 功能 | 单聊（Private） | 群组（Group） | 超级群（UltraGroup） | 聊天室（Chatroom） |
|---|---|---|---|---|
| 场景类比 | 类似微信私聊 | 类似微信群组 | 类似 Discord | 聊天室 |
| 特性/优势 | 支持离线消息推送和历史消息记录漫游 | 支持离线消息推送和历史消息记录漫游，可用于兴趣群、办公群、客服服务沟通等 | 不限成员数量；支持修改已发消息；提供公有/私有频道、用户组等社群功能 | 不限成员数量；只有在线用户可接收消息，退出时清除本地历史消息 |
| 计费套餐 | 所有 | 所有 | 仅限 IM 尊享版 | 所有 |
| 开通服务 | 不需要 | 不需要 | 需要 | 不需要 |
| UI 组件 | 提供 Android/iOS/Web 版 IMKit/Global IM UIKit | 提供 Android/iOS/Web 版 IMKit/Global IM UIKit | 不提供 | 不提供 |
| 创建方式 | 无需创建 | 服务端 API | 服务端 API | 服务端 API |
| 销毁/解散方式 | 不适用 | 服务端 API | 服务端 API | 服务端 API，或者通过自动销毁机制 |
| 成员数量限制 | 不适用 | 群成员数上限 3000 | 不限 | 不限 |
| 用户加入限制 | 不适用 | 不限 | 最多加入 100 个群，每个群中可加入 50 个频道 | 默认仅可加入 1 个聊天室，可自行关闭限制 |
| 获取加入前的消息 | 不适用 | 默认不允许，可自行关闭限制 | 默认不允许，可自行关闭限制 | 客户端加入聊天室即可获取最新消息，最多 50 条 |
| 客户端发送消息频率 | 每个客户端 5 条/秒 | 每个客户端 5 条/秒 | 每个客户端 5 条/秒 | 每个客户端 5 条/秒， |
| 服务端发送消息频率 | 默认限频见 API 接口列表，可付费上调。 | 默认限频见 API 接口列表，可付费上调。 | 默认限频见 API 接口列表，可付费上调。 | 默认限频见 API 接口列表，可付费上调。 |
| 扩展消息 | 支持 | 支持 | 支持 | 不支持 |
| 修改消息 | 不支持 | 不支持 | 支持 | 不支持 |
| 消息可靠度 | 100% 可靠 | 100% 可靠 | 100% 可靠 | 超出服务端消费上限的消息将被主动抛弃，可开通消息优先级服务、聊天室白名单服务。 |
| 消息本地存储 | 移动端、PC 端支持 | 移动端、PC 端支持 | 移动端、PC 端支持 | 不支持 |
| 消息云端存储 | 需开通，可存储 6 - 36 个月 | 需开通，可存储 6 - 36 个月 | 默认存储 7 天，提供 3 - 36 个月存储服务 | 需开通，可存储 2 - 36 个月 |
| 离线缓存消息 | 默认 7 天离线消息缓存 | 默认 7 天离线消息缓存 | 不支持 | 不支持 |
| 消息本地搜索 | 支持 | 支持 | 支持 | 不支持 |
| 离线消息推送* | 支持 | 支持 | 支持，可调整推送频率 | 不支持 |
* 离线消息推送服务是指使用融云 IM 云端推送服务，在用户离线时通过第三方推送服务将通知推送到用户手机上。融云负责对接厂商推送平台，已覆盖小米、华为、荣耀、OPPO（适用于一加、realme）、vivo、魅族、FCM、APNs 手机系统级推送通道。支持标签推送、多种推送场景、推送统计、全量用户通知等特性。
高级与扩展功能
IM 服务支持的高级与扩展功能，包括但不限于以下项目：
- 用户管理：例如用户封禁、用户黑名单（拉黑）、用户白名单，群组及聊天室禁言、聊天室成员封禁等。
- 在线状态订阅：将用户每一个终端在线、离线或登出后的状态，同步给应用开发者指定的服务器地址。
- 多设备在线消息同步：同时支持桌面端、移动端、以及多个 Web 端之间的消息在线同步。
- 全量消息路由：支持将单聊、群组、聊天室、超级群等的消息数据同步到应用开发者指定的服务器地址。
- 内容审核：支持设置敏感词列表，过滤或替换消息中的敏感词。利用消息回调服务，可将消息先转发到应用开发者指定的服务器地址，由应用服务器判定是否可发送给目标接收者。
- 服务端推送通知：支持标签推送、包名推送、推送统计、全量用户通知等特性。
部分功能需要在控制台开通服务后方可使用。部分为收费增值服务，详见即时通讯计费细则。
服务端
您的后端可利用融云服务端提供的 IM Server API 执行以下操作：
部分高级扩展特性仅在 IM Server API 中提供，例如 系统通知、在线用户广播、用户封禁等。详细描述，请参见 API 接口列表。
即时通讯业务提供服务端回调（Webhook），支持将业务的数据、状态通知同步到您设置的回调地址，例如用户在线状态变更、聊天室房间状态变更等。支持通过回调响应正文的参数控制消息是否发送给接收者。所有服务端回调均需要在控制台分别配置回调地址并启用。
客户端
您的应用程序可通过集成 IMLib SDK 和 UI 库来连接到融云服务、传输消息即时消息、以及构建其他功能。
- 即时通讯核心 SDK ：IMLib SDK 旨在提供一种整合即时通讯通信 (IM) 能力的简单方案。借助 IMLib SDK 封装的通信能力和会话、消息等对象，您可以从头开始构建自己的 UI。请参阅 IMLib SDK。
- 即时通讯 UI 库 ：IMKit 和 Global IM UIKit 是 UI 组件库，集成了会话与会话列表界面，并提供了丰富的自定义功能，可简化您的集成体验。请参阅 IMKit 以及 Global IM UIKit。
只要客户端（包括应用服务端）使用一致的 App Key，不同平台、不同版本 SDK 的客户端之间可以互通消息。
控制台
控制台作为一个综合服务平台，提供对 App Key、App Secret、计费操作和各种其他功能配置的一站式访问与管理能力。
您还可以使用控制台调试 IM Server API、查询消息状态、查询连接状态、添加 Webhook 等等。
数据与隐私
融云不会利用客户的数据。同时融云提供完善的数据隐私保护策略，欢迎了解 SDK 隐私政策。
如果需要存储、查看、获取与即时通讯相关的数据，请参考以下方式：
- 如需在云端长期存储单聊会话、群聊会话、聊天室会话的历史消息，您可以开通消息云存储服务。默认的长期存储时长与业务类型相关，可按需调整。该服务存储的数据仅供客户端获取历史消息时使用。
- 如需直接下载应用下全部用户的消息历史，请开通 Server API 历史消息日志下载。开通后可使用服务端 API 获取最多三天的消息日志。
- 除此之外，您还可以开通全量消息路由服务，实时将消息同步到您的业务服务器。
- 您可以前往融云控制台数据统计页面，查看即时通讯用户统计、业务统计、消息统计、业务健康检查等数据。开通相应服务后，还能获取如业务数据分析等数据。