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

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

操作说明

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

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

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

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

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



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

功能说明: 默认新注册的用户可以接收到注册前 7 天内的广播消息。您可以从控制台免费基础功能页面关闭该服务。

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

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

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



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

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

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

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



四、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 推送集成 的所有必要配置。

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

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



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

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

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

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

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



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

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

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

相关标签:服务端发送消息没有回调、有的消息没有回调、有些消息没有传给我们服务器



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

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

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

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

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

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

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

  • 1)、2)这两种方式的最大的区别:
    消息路由 时效性强,但如果传输过程中有什么异常我们就会重试三次之后就不再推送了。极端情况会出现丢失的情况。
    下载log日志方式 是全量的(消息保存 3 天)但时效性稍差一些,最快只能下载 1 小时前的全量消息,所以要看您的查询策略需求。
    相关知识库:【 IM 服务】是否支持保存聊天消息历史记录?融云保存消息时间是多久?

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



八、聊天室状态同步

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

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

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

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

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



九、加入聊天室获取指定消息设置

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

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

点击设置 ,在弹窗中填写消息类型的 Object Name。融云内置消息类型的 Object Name 可参见 消息类型概述

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



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

功能介绍:

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

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

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

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



十一、聊天室自动销毁等待时间的设置(针对整个APP)

功能说明: 聊天室具有自动销毁机制。如果聊天室在指定时间内(默认 1 个小时)没有人说话,且没有人加入聊天室时,融云服务端会把聊天室内所有成员踢出聊天室并销毁聊天室。您可以自助调整聊天室销毁等待时间必须是 [1-24] 之间的整数) ,最长 24 小时。

  1. 聊天室销毁时,会向聊天室成员发送聊天室销毁通知,以方便客户可以在聊天室销毁后,在终端自定义一些操作(依赖客户端 SDK 版本)。
  2. 聊天室具有 sessionid,在聊天室生存周期内保持不变,聊天室重建后重新生成。用于使用相同聊天室ID,多次开播时,客户端可以区分。

访问开发者后台 免费基础功能 页面,确认应用名称与环境(开发/生产)正确无误后,点击设置启用聊天室销毁等待时间服务。

相关知识点:
关于聊天室销毁时间,除了针对整个APP的设置以为,还提供了 针对指定聊天室的设置方法
1、可以设置“自动销毁类型” 分为:不活跃后销毁固定时间销毁(定时自动销毁) ,时间可以从默认的1小时延长最大至7天
相关文档:融云开发者文档
2、如果想永久保活聊天室,有两种方案

  • 方案一、开通聊天室保活功能 (最多设置 5 个聊天室,如需要多个请联系商务)
    相关文档:融云开发者文档
    相关知识库:【 IM 服务】开通聊天室保活服务
  • 方案二、定时往聊天室发消息,不要让聊天室处于不活跃状态(无保活数量限制)
    即:您可以每隔一段时间(要小于设定的不活跃的时间)向聊天室发送一条消息,如果客户端不想展示这条消息,可以发送自定义消息等,客户端收到后直接过滤。*

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



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

功能说明:设置单聊推送通知是否可使用服务端用户的 portraitUri 数据。注意:Android 端直接影响系统默认弹出的远程推送通知栏图片;iOS 端需要 App 自行解析 richMediaUri 并实现展示。

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



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

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

  • 发起注销后,服务端会在 15 分钟内通过回调通知注销结果。
  • 重新激活用户 ID、重复注销、重复激活的情况下,即时通讯服务端会实时发起回调通知。

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

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

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