IM 服务
为方便用户集成测试 IM 能力,开发环境可免费使用融云 IM 服务,最多可注册 100 用户,生产环境没有注册用户数限制,如需要使用生产环境请切换到生产环境后购买 IM 服务。
IM 服务分为旗舰版和尊享版,注意:数据中心不同对应的价格也不同,具体可参考截图位置查看。
服务购买
一、增值服务
1、客户端用户在线状态订阅
- 服务描述:通过客户端 SDK 订阅指定用户的在线、离线状态,仅 Android、iOS SDK v5.8.1、Web 端 v5.9.8 及以上版本支持。开发文档
2、聊天室全局禁言服务
- 服务描述: 提供用户在所有聊天室中禁言功能,被禁言用户可接收查看聊天室中其他用户发送的消息,但不能发送消息。开发文档
3、聊天室消息优先级服务
- 服务描述: 提供设置指定消息类型为低级别的消息,当服务器负载高时低级别的消息优先被丢弃,这样可以确保重要的消息不被丢弃,默认情况下全部为高级别消息。开发文档
4、聊天室消息白名单服务
- 服务描述: 提供设置消息类型或用户名单,确保在服务器负载高时聊天室中重要类型的消息或用户消息不被丢弃。开发文档
5、聊天室保活服务
- 服务描述: 当聊天室中1小时无人说话,同时没有人加入聊天室时,融云服务端会自动把聊天室内所有成员踢出聊天室并销毁聊天室。保活的聊天室不会被自动销毁,可以调用 API接口销毁聊天室。开发文档
6、聊天室广播消息
- 服务描述: 提供向应用中的所有聊天室发送一条消息。开发文档
7、消息回调
- 服务描述: 根据发送用户 ID、接收用户 ID、消息类型、会话类型等多重维度进行设置,将满足条件的消息同步到指定客户服务器。开发文档
8、语音转文字
- 服务描述:提供语音消息内容转文本服务,功能开通费用 500 元/月,每月赠送 5 万条语音消息转换,超量后 10 元/千条。
9、推送 Plus 服务
- 服务描述: 推送 Puls 服务购买后默认支持 1万推送并发量,如需要更多并发请联系融云。开发文档
10、桌面版服务
- 服务描述:购买桌面版 IM SDK 后,支持集成融云 Electron IM SDK,可在 Windows、Mac、Linux 系统使用融云 IM 能力。
11、单群聊消息云端存储
- 服务描述:将单聊、群聊消息保存在云端,客户端可以获取云端历史消息,历史消息默认保存 6 个月。
12、单群聊消息云端存储时长
- 服务描述:单群聊消息云存储,历史消息默认保存 6 个月。每增加 1 个月会产生额外费用。
13、聊天室消息云端存储
- 服务描述:聊天室消息保存在云端,用户进入聊天室后,可获取到聊天室中的历史消息,默认保存 2 个月。
14、聊天室消息云端存储时长
- 服务描述:聊天室消息云存储服务,购买后默认聊天室消息保存 2 个月。每增加 1 个月会产生额外费用。
15、超级群历史消息存储
- 服务描述:购买 IM 尊享版本后,可以调整超级群消息云存储时长,默认免费存储 7 天,每存储 1 个月会产生额外费用,最大为 36 个月
16、Server API 查询历史消息
- 服务描述:购买后每月可免费获取 100 万条消息,超过 100 万条后,每万条 20元/月
17、用户黑名单数量上限
- 服务描述:单个用户黑名单数量上限,频率调整:每增加 1000 个用户会产生额外费用。
18、用户白名单数量上限
- 服务描述:单个用户白名单数量上限,频率调整:每增加 1000 个用户会产生额外费用。
19、敏感词上限数
- 服务描述:默认最多设置 50 个敏感词
20、IM 审核
- 服务描述: 预充服务费到子账本,购买后前 7 天可免费体验,超过体验期后按实际用量扣费,详细查看计费说明
二、调频服务
请参考 调整频率限制文档。
功能配置
以下功能,都可以在控制台直接免费开通。确认应用名称与环境(开发 /生产)正确无误后,找到 您需要的服务,点击 启用 即可,功能会在 15 分钟后生效。
一、用户
1、新用户收注册前全量用户落地通知
- 功能说明:默认新用户可以接收到注册之前 7 天内的广播消息,关闭后新用户不会接收到之前的全量用户落地通知。
2、用注销或激活回调地址
- 功能说明:用户注销或激活完成时,会将处理结果同步到您的应用服务器,便于您知晓单个或批量注销与激活用户的处理进度与结果
3、用户资料变更回调
- 功能说明: 当用户资料发生变更时,实时同步到您的应用服务器,功能开通后 15 分钟生效,查看开发文档。
4、客户端用户资料变更订阅
- 功能说明:通过客户端 SDK 订阅指定用户的资料变更信息,当用户资料发生变更时,实时向订阅用户同步,变更通知计入单聊分发、下行消息统计中,SDK 从移动端 5.10.0、Web 端 5.10.1 版本开始支持 ,功能开通后 15 分钟生效。
5、用户资料默认权限
- 功能说明:设置应用下用户资料的可见权限,默认为都不可见,仅支持获取到用户的名称和头像信息,SDK 从移动端 5.10.0、Web 端 5.10.1 版本开始支持 ,功能开通后 15 分钟生效。
6、服务端订阅用户在线状态
- 功能说明: 将应用中用户在线状态实时同步到您的应用服务器,实现对用户状态(在线、离线、登出)的逻辑处理。功能文档
7、用户自定义属性
- 功能说明:使用融云的用户信息托管功能后,支持设置自定义的用户属性信息
二、离线推送
1、应用标识及推送证书管理
- 功能说明:融云推送服务已对接小米、华为、鸿蒙、荣耀、魅族、OPPO、vivo、FCM、APNs 推送平台
2、推送自定义铃声
- 功能说明:提供按消息类型(ObjectName)设置第三方推送铃声,目前支持设置 APNs、小米、华为推送通道,每个推送通道最多设置 5 个,设置 15 分钟后生效。
3、多语言推送模板
- 功能说明:支持发送消息时携带创建的模板 ID,当目标用户离线时,使用模板中对应的配置内容进行推送,最多设置 100 个自定义推送模板。
4、Web/PC 在线手机端接收 Push
- 功能说明:默认 Web 端或 PC 端在线,移动端未在线状态下,有新消息时移动端不会收到 Push,开启后移动端会收到 Push。
5、Push 语言:
- 功能说明:内置图片、语音、小视频、文件、音视频通讯消息推送语言设置,默认为中文。
三、好友
1、 仅好友可以相互发送单聊消息
- 功能说明:通过客户端 SDK 发送单聊消息时,是否进行好友身份验证,默认不判断好友关系,开启后只有在目标用户的好友列表中才能发送单聊消息。通过 Server API 发送单聊消息没有限制,用户黑名单、白用单限制优先级大于好友关系。
2、好友关系状态回调
- 功能说明: 应用中有申请添加好友、同意&拒绝好友请求、添加好友成功、移除好友成功等好友相关的操作行为时,实时同步到您的应用服务器,功能开通后 15 分钟生效,查看开发文档。
3、添加好友权限
- 功能说明:设置应用默认的添加好友权限,在用户未修改自己的加好友权限时,以应用默认设置为准,默认为"需要目标用户同意"才能添加为好友。
4、客户端好友资料变更通知
- 功能说明:用户资料发生变更时,实时同步给该用户的所有好友,好友资料变更通知计入单聊分发、下行消息统计中,功能开通后 15 分钟生效。
5、客户端好友在线状态变更通知
- 功能说明:用户在线状态发生变更时,实时同步给用户的所有好友,好友在线状态变更通知计入单聊分发、下行消息数据统计中,SDK 从移动端 5.12.0、Web 端 5.12.0 版本开始支持,功能开启后 15 分钟生效。
6、好友自定义属性
- 功能说明:使用融云的用户信息托管功能后,支持设置自定义的好友属性信息
四、多端
1、 允许客户端 SDK 控制重连互踢策略
- 功能说明:默认情况下,融云会使得同一用户新登录的设备在连接成功后自动踢出已登录的设备。启用该功能后,您可以通过客户端 SDK (包括所有移动端和 Electron) 来调整这一策略,使得已经正常登录的移动端设备不受影响。如果设备在尝试重连时发现其他设备已在线,将停止重连,并提示用户其他设备已登录。
2、小程序多端
- 功能说明:默认融云小程序 SDK 仅支持一个端连接 IM 服务,如需要支持多端同时连接可开通此功能。
3、多设备消息同步
- 功能说明:开启后可以支持 Web 端、桌面端、Android、iOS 之间的消息同步。
五、全局消息
1、 全量用户通知服务
- 功能说明:向应用中所有或指定用户发送消息或推送,实现将活动预告、内容动态精准及时的发送给目标用户,满足您的运营需求
2、全量消息路由
- 功能说明: 将消息数据实时同步到您的应用服务器,实现对用户之间的消息处理、新老系统的消息对接、聊天机器人等功能。功能文档
3、Server API 发送消息实时路由
- 功能说明:默认 Server API 发送的消息不会路由到客户应用服务器,开启后可通过全量消息路由功能同步到客户应用服务器。需要先开启全量消息路由。
4、Server API 历史消息日志下载
- 功能说明:通过 Server API 获取 APP 内指定某天某小时内的所有会话消息记录。
5、离线消息存储时长
- 功能说明:目标用户未在线时,该用户接收的消息会保存到离线消息中,默认存储 7 天,下次登录时会获取到离线消息,如果需要调整可设置范围为 1 ~ 7 天。(仅针对单聊、群聊、系统消息会话类型有效)
6、消息回调服务
- 功能说明:根据发送用户 ID、接收用户 ID、消息类型、会话类型等多重维度进行设置,将满足条件的消息同步到指定客户服务器,由客户服务端决定消息是否正常发送。
7、广播消息云存储
- 功能说明:开通单群聊消息云存储功能后,默认全量广播消息不会存储到历史消息中,如需要存储可开通此功能。
8、群定向消息云存储
- 功能说明:默认群组发送定向消息,不支持存储到历史消息中,开通后定向消息将存储到单群聊历史消息中。
9、操作事件回调
- 功能说明:针对会话中消息的操作行为实时同步到您设置的应用服务器地址,目前仅支持单聊、群聊、系统会话类型。
六、单群聊
1、单聊状态消息消息路由
- 功能说明:单聊状态消息是否进行消息路由及消息历史日志存储,如开通后如客户使用了单聊 " 正在输入的状态 ” 功能,该正在输入的状态消息也会进行路由和消息日志存储,消息量较大请谨慎开通,默认为不路由。
2、单聊用户白名单
- 功能说明:只有互为白名单的用户,可以相互发送消息,默认为关闭状态,开启后融云黑名单功能失效。
3、用户不在群组时是否可以拉取历史消息
- 功能说明:默认用户不在群组中不能获取群组中的历史消息,开启后用户未在指定群组中时,也可以获取群组历史消息。
4、新用户获取加入群组前历史消息
- 功能说明:默认用户只能查看他们加入群组后的群聊消息。开启服务后,新入群用户可以获取他们加入群组之前的群聊历史消息。
注意: 此功能需要开通 单群聊消息云存储 功能后,才能使用。
5、群组资料变更回调
- 功能说明: 当群组资料发生变更时,实时同步到您的应用服务器,功能开通后 15 分钟生效,查看开发文档。
6、群组操作状态回调
- 功能说明: 当应用中有创建、加入、踢出、退出、解散、添加管理员、移除管理员、转移群主等群操作行为时,实时同步到您的应用服务器,功能开通后 15 分钟生效,查看开发文档。
7、允许通过客户端 SDK 进行群组操作
- 功能说明:默认允许通过 SDK 进行群组操作,可根据业务需要设置操作权限,SDK 从移动端 5.12.0、Web 端 5.12.0 版本开始支持 ,设置后 15 分钟生效。
8、群组自定义属性
- 功能说明:使用融云的用户信息托管功能后,支持设置自定义的群组属性信息
七、聊天室
1、加入聊天室时获取指定消息
-
功能说明:用户在客户端 加入聊天室 时,SDK 默认获取最新消息(最多 50 条),不区分消息类型。开启服务后,可配置允许获取的消息类型。新加入聊天室的客户会获取到指定类型的最新消息。该配置不影响加入聊天室后在线收取消息。
-
点击设置 ,在弹窗中填写消息类型的 Object Name。融云内置消息类型的 Object Name 可参见 消息类型概述 。
2、单个用户加入多个聊天室
- 功能说明:默认一个用户只能加入一个聊天室中,开启后一个用户可以同时加入到多个聊天室中。
3、多端同时在线情况下,一端退出聊天室其他端也同步退出聊天室
- 功能说明:用户当前多端同时在线,都加入了同一聊天室,一端退出聊天室后其他端不进行退出,开启后多端在线情况下如果需要一端退出后其他端也退出聊天室。
4、聊天室成员变化监听
- 功能说明:用户加入、退出聊天室后,向聊天室中的其他成员发送回调通知,通知使用的是消息方式,开通后会增加消息量,默认为关闭状态。SDK 版本 >= 5.1.4 支持此功能。
5、聊天室状态同步
- 功能说明: 聊天室状态同步 是融云提供的服务端回调服务。开启同步后,应用下聊天室发生状态变化时,融云服务端会将状态实时同步到开发者的应用服务器。
注意:不支持同一用户多端同时在线情况下的聊天室状态同步。
6、聊天室属性自定义(KV)设置
- 功能说明 :
启用设置 聊天室属性 自定义(KV)服务
融云支持在指定聊天室中 设置自定义属性(KV),用于在指定聊天室中设置自定义属性。在语音直播聊天室场景中,可利用此功能记录聊天室中各麦位的属性;或在狼人杀等卡牌类游戏场景中记录用户的角色和牌局状态等。
开通服务后,客户端与服务端均可以设置聊天室自定义属性(KV)。
服务端设置聊天室KV文档
客户端设置聊天室KV文档
7、SDK 用户不在聊天室中不能发送消息
- 功能说明:用户未加入聊天室时可以向聊天室中发送消息。开启后,不在聊天室的用户不能发送消息。
八、超级群
1、用户未加入超级群是否能获取历史消息
- 功能说明:开启后用户未加入群组时,也可以获取群组的历史消息。
2、新用户加入群后是否拉取加入群之前的消息
- 功能说明:开启后新用户加入群组后,也可以获取群组之前的历史消息,包括普通群和超级群。
3、超级群默认推送频率
- 功能说明:默认用户每分钟在每个群、群频道中的可接收一条推送,每分钟可设置上限不超过 60 条。
4、会话列表支持超级群默认频道
- 功能说明:是否需要在会话列表中获取到超级群的默认频道(RCDefault)
九、安全&审核
1、IM 消息审核
- 功能说明 :即时通讯支持对 IM 内容进行审核,提供基础审核能力、专业审核服务,以及自行对接审核服务的能力。
2、IM 信息托管审核
- 功能说明 :支持设置用户、好友、群组、群成员的资料审核。
3、安全域名设置
- 功能说明 :设置 Web 安全域名后,生产环境下仅可在该域名下通过 JavaScript SDK 调用服务器资源 ,开发环境没有限制。
4、单聊含敏感词消息不保存到发送者历史消息
- 功能说明:默认单聊发送的消息,含有敏感词或审核不通过时,该条消息会进入发送者的服务端历史消息中存储,同时该用户在其他终端登录时,也会补偿收到该条消息,如不希望收到消息补偿及进入发送者的历史消息中,可开启此功能。
5、Server API 发送消息过滤敏感词
- 功能说明:默认 Server API 发送的消息不过审核,开启后,Server API 发送消息会过滤设置的敏感词、内容审核规则、以及消息回调服务设置的过滤规则。
6、含敏感词消息开启路由
- 功能说明 :默认消息中包含屏蔽敏感词时,不会同步到应用服务器,如果含有替换敏感词时,会将消息中的敏感词替换成设置的内容同步到应用服务器。开通此功能后,含有屏蔽敏感词的消息也会同步到应用服务器。
7、含敏感词消息屏蔽状态回调发送端
- 功能说明:发送的消息中含有敏感词时(包括:融云敏感词、第三方审核、消息回调返回不下发的状态),向消息发送者进行回调通知,SDK >= 5.1.4 版本支持此功能。
全量用户通知
该页面提供了测试全量落地通知 和不落地通知能力。
全量用户通知历史
注意,只有在全量用户通知页面创建的记录才会在这里展示,且数据是次日生成。















