免打扰功能概述
即时通讯业务支持多维度、多级别精细化的免打扰设置。
IM 的免打扰设置维度
即时通讯业务支持对免打扰功能进行多维度地控制。开发者可从 App Key、特定的 IM 细分业务（目前仅超级群）、用户级别进行免打扰功能配置。
提示
- Android/iOS 客户端 SDK 从 5.2.2 开始提供对以下维度免打扰设置的完整支持。
- Web 客户端 SDK 从 5.3.0 开始提供对以下维度免打扰设置的完整支持。
| 免打扰配置的维度 | 适用场景 | 说明 | 服务端 API |
|---|---|---|---|
| App Key 级设置 | 单聊、群聊、系统会话、超级群 | 以 App Key 为单位，设置整个应用的默认免打扰级别。默认未设置，等同于全部消息都接收通知。该级别的配置暂未在控制台开放，如有需要，请提交工单。 | 服务端不提供该 API。 |
| 超级群默认设置（全体群成员） | 仅限超级群业务 | 可为指定的超级群的设置默认的免打扰级别，对全体群成员生效。 | 详见「超级群管理」下的设置群/频道默认免打扰 |
| 超级群频道默认设置（全体群成员） | 仅限超级群业务 | 可为指定的超级群频道设置默认的免打扰级别，对全体群成员生效。 | 详见「超级群管理」下的设置群/频道默认免打扰 |
| 会话类型设置（用户级） | 单聊、群聊、系统会话、超级群 | 允许用户设置指定类型会话的免打扰级别。 | 详见设置会话类型免打扰。 |
| 会话的设置（用户级） | 单聊、群聊、系统会话、超级群 | 允许用户设置指定会话的免打扰级别。 | 详见设置会话免打扰。 |
| 超级群会话频道的设置（用户级） | 仅限超级群业务 | 允许用户设置指定超级群频道的免打扰级别。 | 详见设置会话免打扰。 |
| 应用全局设置（用户级） | 单聊、群聊、系统会话、超级群 | 允许用户设置指定时段内全局免打扰级别。 | 服务端不提供该 API。 |
免打扰设置的优先级
-
针对单聊、群聊、系统会话，即时通讯服务端会遵照以下顺序搜索免打扰配置。优先级从左至右依次降低，以优先级最高的配置为准判断是否需要触发推送：
全局免打扰设置（用户级） > 指定会话的免打扰设置（用户级） > 指定会话类型的免打扰设置（用户级） > App 级的免打扰设置
-
针对超级群会话，即时通讯服务端会遵照以下顺序搜索免打扰配置。优先级从左至右依次降低，以优先级最高的配置为准判断是否需要触发推送：
全局免打扰设置（用户级）> 指定超级群频道的免打扰设置（用户级） > 指定会话的免打扰设置（用户级） > 指定会话类型的免打扰设置（用户级） > 指定超级群频道的默认免打扰设置（超级群全员） > 指定超级群的免打扰设置（超级群全员） > App 级的免打扰设置