跳到主要内容

版本:5.X

免打扰功能概述

即时通讯客户端 SDK 支持多维度、多级别精细化的免打扰设置。

IM 的免打扰设置维度

即时通讯业务支持对免打扰功能进行多维度地控制。开发者可从 App Key、指定细分业务(仅超级群)、用户级别进行免打扰功能配置。

融云服务端会遵照以下优先级搜索免打扰配置,判断当前消息是否需要触发推送:用户级别设置 > 指定超级群频道的默认配置 > 指定超级群会话的默认配置 > App Key 级设置。

注意

客户端 SDK 从 5.3.0 开始提供对以下维度免打扰设置的完整支持。

免打扰配置的维度适用场景说明客户端 API服务端 API
App Key 级设置单聊、群聊、超级群以 App Key 为单位,设置整个应用的默认免打扰级别。默认未设置,等同于全部消息都接收通知。该级别的配置暂未在控制台开放,如有需要,请提交工单。客户端 SDK 不提供 API。服务端不提供该 API。
指定超级群默认设置仅限超级群业务可为指定的超级群设置默认的免打扰级别。详见「超级群管理」下的设置群/频道默认免打扰详见「超级群管理」下的设置群/频道默认免打扰
指定超级群频道的默认设置仅限超级群业务可为指定的超级群设置默认的免打扰级别。详见「超级群管理」下的设置群/频道默认免打扰详见「超级群管理」下的设置群/频道默认免打扰
用户级设置单聊、群聊、超级群用户级别免打扰设置如下(优先级从高到低):
  1. 设置指定时段内,应用全局的免打扰级别。
  2. (仅超级群)设置指定频道的免打扰级别。
  3. 设置指定会话的免打扰级别。


在融云服务端判断是否需要推送通知时,如存在用户级别免打扰配置,则遵照以上优先级判断是否需要推送。
  1. Web 端不支持该配置。
  2. 详见按频道设置免打扰
  3. 详见设置免打扰
  1. 详见 设置用户免打扰时段
  2. 详见设置会话免打扰
  3. 详见设置会话免打扰