跳到主要内容

免打扰功能概述

即时通讯业务支持多维度、多级别精细化的免打扰设置。

IM 的免打扰设置维度

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

提示
  • Android/iOS 客户端 SDK 从 5.2.2 开始提供对以下维度免打扰设置的完整支持。
  • Web 客户端 SDK 从 5.3.0 开始提供对以下维度免打扰设置的完整支持。
免打扰配置的维度适用场景说明服务端 API
App Key 级设置单聊、群聊、系统会话、超级群以 App Key 为单位,设置整个应用的默认免打扰级别。默认未设置,等同于全部消息都接收通知。该级别的配置暂未在控制台开放,如有需要,请提交工单。服务端不提供该 API。
超级群默认设置(全体群成员)仅限超级群业务可为指定的超级群的设置默认的免打扰级别,对全体群成员生效。详见「超级群管理」下的设置群/频道默认免打扰
超级群频道默认设置(全体群成员)仅限超级群业务可为指定的超级群频道设置默认的免打扰级别,对全体群成员生效。详见「超级群管理」下的设置群/频道默认免打扰
会话类型设置(用户级)单聊、群聊、系统会话、超级群允许用户设置指定类型会话的免打扰级别。详见设置会话类型免打扰
会话的设置(用户级)单聊、群聊、系统会话、超级群允许用户设置指定会话的免打扰级别。详见设置会话免打扰
超级群会话频道的设置(用户级)仅限超级群业务允许用户设置指定超级群频道的免打扰级别。详见设置会话免打扰
应用全局设置(用户级)单聊、群聊、系统会话、超级群允许用户设置指定时段内全局免打扰级别。服务端不提供该 API。

免打扰设置的优先级

  • 针对单聊、群聊、系统会话,即时通讯服务端会遵照以下顺序搜索免打扰配置。优先级从左至右依次降低,以优先级最高的配置为准判断是否需要触发推送:

    全局免打扰设置(用户级) > 指定会话的免打扰设置(用户级) > 指定会话类型的免打扰设置(用户级) > App 级的免打扰设置

  • 针对超级群会话,即时通讯服务端会遵照以下顺序搜索免打扰配置。优先级从左至右依次降低,以优先级最高的配置为准判断是否需要触发推送:

    全局免打扰设置(用户级)> 指定超级群频道的免打扰设置(用户级) > 指定会话的免打扰设置(用户级) > 指定会话类型的免打扰设置(用户级) > 指定超级群频道的默认免打扰设置(超级群全员) > 指定超级群的免打扰设置(超级群全员) > App 级的免打扰设置