【 IM 服务 】免费基础功能汇总

以下功能,都可以在控制台直接免费开通。

操作说明

访问控制台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,找到 您需要的服务,点击启用 即可,功能会在 15 分钟后生效。

一、单群聊

1、单聊状态消息消息路由

  • 功能说明:单聊状态消息是否进行消息路由及消息历史日志存储,如开通后如客户使用了单聊 " 正在输入的状态 ” 功能,该正在输入的状态消息也会进行路由和消息日志存储,消息量较大请谨慎开通,默认为不路由。
  • 开通方式:访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 服务。

相关文档:全量消息路由 | 融云开发者文档

相关标签:状态消息、消息回调、状态消息回调、状态消息路由


2、单聊用户白名单

  • 功能说明:只有互为白名单的用户,可以相互发送消息,默认为关闭状态,开启后融云黑名单功能失效。
  • 开通方式:访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 服务。

相关文档:
用户白名单概述 | 融云开发者文档

单聊用户黑名单与白名单服务是什么?
相关标签:白名单、用户白名单


3、群定向消息云存储

  • 功能说明:默认群组发送定向消息,不支持存储到历史消息中,开通后定向消息将存储到单群聊历史消息中。
  • 开通方式:访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 服务。

相关文档:发送群定向消息 | 融云开发者文档
相关标签:定向消息、定向消息云存储、消息云存储、发送定向消息成功,但是调用获取历史消息方法获取不到该消息?


4、用户不在群组时是否可以拉取历史消息

  • 功能说明:默认用户不在群组中不能获取群组中的历史消息,开启后用户未在指定群组中时,也可以获取群组历史消息。
  • 开通方式:访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 服务。

相关文档:获取历史消息 | 融云开发者文档


5、新用户获取加入群组前历史消息

  • 功能介绍:默认用户只能查看他们加入群组后的群聊消息。开启服务后,新入群用户可以获取他们加入群组之前的群聊历史消息。
    注意: 此功能需要开通 单群聊消息云存储 功能后,才能使用。

  • 开通方式: 访问控制台 免费基础功能 页面,选择都允许,接着点击设置,以启用新用户获取加入群组前历史消息服务。

相关标签:新用户进群后怎么看之前的群消息?如何看到之前的群消息?


6、设置离线消息存储时长

  • 功能介绍:目标用户未在线时,该用户接收的消息会保存到离线消息中,默认存储 7 天,下次登录时会获取到离线消息,如果需要调整可在此进行设置,设置范围为 1 ~ 7 天。(仅针对单聊、群聊、系统消息会话类型有效)
  • 开通方式:访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,选择 存储天数 后,点击 设置 服务。

相关文档:管理离线消息存储配置 | 融云开发者文档


7、群组离线消息存储天数

  • 功能介绍:当目标用户未在线时,其接收的群组消息会存储到离线消息中,默认存储时长为 7 天,用户在下次登录时可获取这些消息。如未配置此项,则群组的离线消息存储时长由“设置离线消息存储时长”控制。如已配置此项,则群组消息的离线存储天数将依据该配置。
  • 开通方式:访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,选择 存储天数 后,点击 设置 服务。

相关文档:管理离线消息存储配置 | 融云开发者文档



二、聊天室

1、加入聊天室时获取指定消息

  • 功能说明:用户在客户端 加入聊天室 时,SDK 默认获取最新消息(最多 50 条),不区分消息类型。开启服务后,可配置允许获取的消息类型。新加入聊天室的客户会获取到指定类型的最新消息。该配置不影响加入聊天室后在线收取消息。

  • 操作说明: 访问开发后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,找到加入聊天室获取指定消息设置 服务,点击 设置 ,填入允许的消息类型,以启用服务。

相关标签:加入聊天室获取不到正常消息?、加入聊天室获取50条消息时可以指定消息类型吗?加入聊天室需要获取指定消息


2、单个用户加入多个聊天室

  • 功能说明:默认一个用户只能加入一个聊天室中,开启后一个用户可以同时加入到多个聊天室中。

  • 开通方式: 访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 服务。

相关标签:加入多个聊天室、同时进入多个聊天室


3、多端同时在线情况下,一端退出聊天室其他端也同步退出聊天室

  • 功能说明:用户当前多端同时在线,都加入了同一聊天室,一端退出聊天室后其他端不进行退出,开启后多端在线情况下如果需要一端退出后其他端也退出聊天室。
  • 开通方式:访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 服务。

相关文档: 多端同时在线 | 融云开发者文档
相关标签:一端退出聊天室另一个端还在聊天室里


4、聊天室成员变化监听

  • 功能说明:用户加入、退出聊天室后,向聊天室中的其他成员发送回调通知,通知使用的是消息方式,开通后会增加消息量,默认为关闭状态。SDK 版本 >= 5.1.4 支持此功能
  • 开通方式:访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 服务。

相关文档:监听聊天室事件 | 融云开发者文档
相关标签:用户加入、退出聊天室给其他成员发送回调通知;我能知道其他聊天室成员变化吗?聊天室成员进出通知


5、聊天室状态同步

  • 功能说明: 聊天室状态同步 是融云提供的服务端回调服务。开启同步后,应用下聊天室发生状态变化时,融云服务端会将状态实时同步到开发者的应用服务器。

目前支持同步以下状态:

不支持同一用户多端同时在线情况下的聊天室状态同步。

  • 开通方式: 访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,启用 聊天室状态同步 服务。 填写 聊天室状态同步回调地址 ,点击 设置 保存。

相关标签:状态回调、状态同步、如何知道聊天室创建销毁?

相关文档 : 接收服务端回调


6、聊天室属性自定义(KV)设置

功能介绍:

  • 启用设置 聊天室属性 自定义(KV)服务
    融云支持在指定聊天室中 设置自定义属性(KV),用于在指定聊天室中设置自定义属性。在语音直播聊天室场景中,可利用此功能记录聊天室中各麦位的属性;或在狼人杀等卡牌类游戏场景中记录用户的角色和牌局状态等。
    开通服务后,客户端与服务端均可以设置聊天室自定义属性(KV)。
    服务端设置聊天室KV文档
    客户端设置聊天室KV文档

  • 配置聊天室自定义属性回调
    融云支持将应用下的全部聊天室属性变化(设置,删除,全部删除等操作)同步到您指定的地址,方便 App 业务服务端了解聊天室属性变化。详见服务端文档 聊天室属性同步(KV)

开通方式:
访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发/生产)正确无误后,点击设置启用聊天室自定义属性设置服务。
如果需要融云服务端将应用下的全部聊天室属性变化(设置,删除,全部删除等操作)同步到您指定的地址,可填写回调 URL,点击设置保存。

相关标签:设置KV、麦位变化设置、聊天室KV


7、SDK 用户不在聊天室中不能发送消息

功能说明:用户未加入聊天室时可以向聊天室中发送消息。开启后,不在聊天室的用户不能发送消息。
开通方式:访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 服务。

相关文档:聊天室服务配置 | 融云开发者文档


8、聊天室销毁等待时间

  • 功能说明: 聊天室具有自动销毁机制。如果聊天室在指定时间内(默认 1 个小时)没有人说话,且没有人加入聊天室时,融云服务端会把聊天室内所有成员踢出聊天室并销毁聊天室。您可以自助调整聊天室销毁等待时间必须是 [1-24] 之间的整数) ,最长 24 小时 ,这是针对整个APP的设置。
  1. 聊天室销毁时,会向聊天室成员发送聊天室销毁通知,以方便客户可以在聊天室销毁后,在终端自定义一些操作(依赖客户端 SDK 版本)。
  2. 聊天室具有 sessionid,在聊天室生存周期内保持不变,聊天室重建后重新生成。用于使用相同聊天室ID,多次开播时,客户端可以区分。
  • 开通方式:访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发/生产)正确无误后,点击设置启用聊天室销毁等待时间服务。

相关知识点:
关于聊天室销毁时间,除了针对整个APP的设置以外,还提供了 针对指定聊天室的设置方法
1、可以设置“自动销毁类型” 分为:不活跃后销毁固定时间销毁(定时自动销毁) ,时间可以从默认的1小时延长最大至7天
相关文档:设置聊天室自动销毁类型 | 融云开发者文档
2、如果想永久保活聊天室 可以在 控制台 开通 聊天室保活服务(最多设置 5 个聊天室,如需要多个请联系商务)
相关文档:保活聊天室 | 融云开发者文档
相关知识库:【 IM 服务】开通聊天室保活服务
3、如果您同时使用了音视频服务,可以绑定音视频房间,聊天室与音视频房间绑定成功后,当聊天室达到预设的自动销毁条件时,服务端会先检测已绑定的音视频房间(RTCRoomId)是否仍存在。如果绑定的音视频房间仍存在,则则阻止聊天室自动销毁;如果绑定的音视频房间已销毁,则直接销毁聊天室。
相关文档:绑定音视频房间 | 融云开发者文档

相关标签:保活、聊天室保活、聊天室销毁、为什么聊天室会自动销毁?为什么被踢出聊天室?怎么样能让聊天室一直存在?



三、推送

1、单聊推送通知使用服务端用户头像

  • 功能说明:设置单聊推送通知是否可使用服务端用户的 portraitUri 数据。

注意:
Android 端直接影响系统默认弹出的远程推送通知栏图片;
Ios 端需要 App 自行解析 richMediaUri 并实现展示。

  • 开通方式:访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 服务。

相关文档:远程推送通知标题中用户名称、群组名称与会话页面、本地通知中显示的数据不一致

相关标签:推送头像、推送显示头像


2、Web/PC 在线手机端接收 Push

  • 功能说明:
    1)如果用户移动端设备不在线,但是 Web 端或 PC 端在线(“在线”是指 SDK 已与融云服务端建立 IM 连接),融云认为用户可在 Web 端或 PC 端正常接收实时消息,因此不会向用户的任何移动端设备推送新消息的通知。
    2)如果需要更改此默认行为,可为当前 App Key 开启 Web/PC 在线手机端接收 Push。开启后,即使用户已在 Web 或 PC 端在线,离线的移动端设备上也会收到 Push 通知。

  • 开通 Web/PC 在线手机端接收 Push 无任何前提条件。不过,如果需要正常接收推送,请确保已遵照文档完成了 Android 推送集成IOS APNs 推送集成 的所有必要配置。

  • 开通方式: 访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 服务。

相关标签:客户端同时收推送、为什么客户端收不到推送、无法收到推送


3、Push 语言设置,推送语言设置

  • 功能说明:内置图片、语音、小视频、文件、音视频通讯消息推送语言设置,默认为中文。
  • 开通方式:开通方式: 访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 下拉菜单 选择所需语言后,点击设置 服务。



四、安全

1、含敏感词消息开启路由

  • 功能说明 :默认消息中包含屏蔽敏感词时,不会同步到应用服务器,如果含有替换敏感词时,会将消息中的敏感词替换成设置的内容同步到应用服务器。开通此功能后,含有屏蔽敏感词的消息也会同步到应用服务器。
  • 开通方式 :访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 含敏感词消息开启路由 服务。

相关文档:
添加消息敏感词 | 融云开发者文档

相关标签:没有收到敏感词消息的回调 、敏感词消息需要路由


2、含敏感词消息屏蔽状态回调发送端

  • 功能说明:发送的消息中含有敏感词时(包括:融云敏感词、第三方审核、消息回调返回不下发的状态),向消息发送者进行回调通知,SDK >= 5.1.4 版本支持此功能
  • 开通方式:访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 含敏感词消息屏蔽状态回调发送端 服务。

相关文档:敏感信息拦截回调 | 融云开发者文档


3、单聊含敏感词消息不保存到发送者历史消息

  • 功能说明:默认单聊发送的消息,含有敏感词或审核不通过时,该条消息会进入发送者的服务端历史消息中存储,同时该用户在其他终端登录时,也会补偿收到该条消息,如不希望收到消息补偿及进入发送者的历史消息中,可开启此功能。
  • 开通方式:访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 服务。

相关文档:内容审核概述 | 融云开发者文档


4、Server API 发送消息过滤敏感词

  • 功能说明:默认 Server API 发送的消息不过审核,开启后,Server API 发送消息会过滤设置的敏感词、内容审核规则、以及消息回调服务设置的过滤规则。

  • 开通方式: 访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 服务。

相关文档:
消息回调服务
敏感词服务
内容审核服务

相关标签:服务端发送消息没有过审核、API消息没走回调、



五、其他

1、新用户接收注册前广播消息

  • 功能说明: 默认新注册的用户可以接收到注册前 7 天内的广播消息。您可以从控制台关闭该服务。
  • 关闭方式: 访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 关闭 服务。

新用户接收注册前广播消息开关影响以下接口发送的消息:

相关标签:新用户为什么收到很多以前的消息?新用户为什么刚注册就收到消息?


2、Server API 发送消息实时路由

  • 功能说明:默认 Server API 发送的消息不会通过消息路由到客户应用服务器,开启此功能后可通过 全量消息路由 功能把全量消息同步到客户应用服务器。
    前提条件: 需要先在 控制台 开启 全量消息路由 功能 。

  • 开通方式: 访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 服务。

相关文档:【 IM 服务】开通全量消息路由服务
相关标签:服务端发送消息没有回调、有的消息没有回调、有些消息没有传给我们服务器


3、Server API 历史消息日志下载

  • 功能介绍:开启后,可通过 Server API 获取 APP 内指定某天某小时内的所有会话消息记录。
    注意:从此功能开通生效起,产生的消息才能开始下载,之前的消息无法下载。

  • 开通方式: 访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 服务。

背景:
1、融云默认不保存您的历史消息记录

2、客户端 如果想要每个用户保存历史消息,可以在 控制台 开通“单群聊消息云存储”功能,能保存近六个月的历史消息;如果是 聊天室 的话,在 控制台 开通“聊天室消息云端存储”,可以保存近两个月的历史消息

3、服务端 想获取所有历史消息的话,有 两种 方式:
1)、您可以通过下载 log 日志的方式获取到全量消息,我们是 1 小时打一个 log 包,消息记录日志文件,我们为您在服务器端保存 3 天(无论是否下载过,3 天后都将从服务器删除)。

2)、您可以开通 全量消息路由 服务,我们会将全量消息数据实时同步到您的应用服务器

相关标签:保存历史消息、消息存储、下载消息、保存消息


4、用户注销或激活回调地址

  • 功能说明:在用户注销或激活完成时,会将处理结果同步到您的应用服务器,便于您知晓单个或批量注销与激活用户的处理进度与结果

  • 发起注销后,服务端会在 15 分钟内通过回调通知注销结果。

  • 重新激活用户 ID、重复注销、重复激活的情况下,即时通讯服务端会实时发起回调通知。

  • 开通方式:访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发/生产)正确无误后,输入正确的回调地址,点击 设置 服务。

相关文档:
用户激活
用户注销
用户注销与激活状态回调


5、小程序多端

  • 功能说明:默认融云小程序 SDK 支持一端同时在线,如需要支持多端同时在线可开通此功能。
  • 开通方式:访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 服务。

相关文档:多端同时在线 | 融云开发者文档


6、RTC 房间状态回调频率调整

  • 功能说明:音视频房间状态同步时的频率,默认为 120秒,可以在 15 秒到 600 秒范围内选择。
  • 开通前提:首先,需要开通 房间状态同步 功能, 您可以前往音视频通话页面,配置 房间状态同步 回调地址。注意回调地址必须是公网可访问的 URL。
  • 开通方式:访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,在 时间设置(秒) 框里,输入相应的时间,然后点击 设置 服务。

7、允许客户端 SDK 控制重连互踢策略

  • 功能说明:默认情况下,融云会使得同一用户新登录的设备在连接成功后自动踢出已登录的设备。启用该功能后,您可以通过客户端 SDK (包括所有移动端和 Electron) 来调整这一策略,使得已经正常登录的移动端设备不受影响。如果设备在尝试重连时发现其他设备已在线,将停止重连,并提示用户其他设备已登录。
  • 开通方式:访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发 /生产 )正确无误后,点击 开启 服务。


相关文档:重连机制与重连互踢 | 融云开发者文档
相关标签:重连机制、重连互踢


8、广播消息云存储

您对此页面功能有任何问题,可以随时提交 工单 咨询我们。