全量用户通知服务配置
即时通讯服务提供全量用户通知服务，允许 App 向应用中所有或指定用户发送消息或推送，实现将活动预告、内容动态精准及时的发送给目标用户的运营需求。
服务能力及相关 API 接口
在使用即时通讯服务端的以下能力及 API 接口前，必须启用全量用户通知服务。
| 名称 | 接口 |
|---|---|
| 发送全量用户落地通知 | /message/broadcast.json 接口用于 App 用户向全部用户发送系统通知消息的场景，本质上是指向 App 中所有用户广播一条系统会话消息，在客户端使用定时拉取机制接收。发送消息后，最长 3 分钟内可收到此条消息。属于落地通知？。 |
| 发送在线用户广播 | /message/online/broadcast.json 接口用于 App 用户向当前在线用户发送系统通知消息的场景，本质上是指向 App 中所有在线用户广播一条系统会话消息，在客户端使用 定时拉取机制接收。发送消息后，最长 3 分钟内可收到此条消息。属于落地通知？。 |
| 发送全量用户不落地通知 | /push.json 用于 App 业务端向全部用户或指定用户发送「推送通知」，本质上是直接通过第三方或即时通讯服务自建的推送通道向 App 中所有用户推送一条通知。属于不落地通知？。 |
| 标签用户通知 | /push.json 用于 App 业务端向携带指定标签的用户发送「推送通知」及系统会话消息，本质上是直接通过第三方或即时通讯服务自建的推送通道向 App 中所有用户推送一条通知。发送的数据携带消息类型和消息内容，属于落地通知？。 |
| 应用包名通知 | /push.json 用于 App 业务端向指定应用包名的用户发送「推送通知」及系统会话消息，本质上是直接通过第三方或即时通讯服务自建的推送通道向 App 中所有用户推送一条通知。发送的数据携带消息类型和消息内容，属于落地通知？。 |
使用服务
- 在开发环境下，全量用户通知服务可免费使用。
- 在生产环境下，需要在需先按控制台内嵌指南嵌入到管理后台的 IM 服务功能配置页面（page_code: im_service_config）中，进入 全局消息 > 全量用户通知服务，开通此服务。IM 旗舰版或IM 尊享版可使用该服务。具体功能与费用以官方价格说明页面及计费说明文档为准。
配置云存储服务
如果需要即时通讯服务端长期存储系统会话消息，请配置对应的云存储服务。配置成功后，客户端可通过获取远端历史消息的 API 获取服务端存储的历史消息记录。
| 名称 | 接口 | 服务端消息存储服务 |
|---|---|---|
| 发送全量用户落地通知 | /message/broadcast.json | 默认不存入即时通讯服务端历史消息记录。如需存储，您可以在需先按控制台内嵌指南嵌入到管理后台的 IM 服务功能配置页面（page_code: im_service_config）中，进入 全局消息 > 广播消息云存储，开启该功能。 |
| 发送在线用户广播 | /message/online/broadcast.json | 不支持存入服务端历史消息记录。 |
| 发送全量用户不落地通知 | /push.json | 仅产生推送通知，不产生消息，不支持在服务端存储。 |
| 标签用户通知 | /push.json | 需使用单群聊消息云端存储服务。您可以前往控制台 IM 服务的服务购买页面开通服务。 |
| 应用包名通知 | /push.json | 需使用单群聊消息云端存储服务。您可以前往控制台 IM 服务的服务购买页面开通服务。 |
提示
广播消息云存储（控制台配置项，路径：IM 服务 > 全局消息）仅保存 发送全量用户落地通知 接口（/message/broadcast.json）发送的消息进云端存储，不保存 发送在线用户广播、标签用户通知、应用包名通知、发送全量用户不落地通知 等接口发送的消息。