---
title: 全量用户通知服务配置
---

即时通讯服务提供**全量用户通知服务**，允许 App 向应用中所有或指定用户发送消息或推送，实现将活动预告、内容动态精准及时的发送给目标用户的运营需求。

## 服务能力及相关 API 接口

在使用即时通讯服务端的以下能力及 API 接口前，必须启用**全量用户通知服务**。

| 名称| 接口|
|---|---|
| [发送全量用户落地通知] | `/message/broadcast.json` 接口用于 **App 用户**向全部用户发送系统通知消息的场景，本质上是指向 App 中所有用户广播一条系统会话消息，在客户端使用**定时拉取**机制接收。发送消息后，最长 3 分钟内可收到此条消息。属于落地通知<sup><a href="/guides/glossary/imglossary#message-notify">？</a></sup>。|
| [发送在线用户广播] | `/message/online/broadcast.json` 接口用于 **App 用户**向当前在线用户发送系统通知消息的场景，本质上是指向 App 中所有在线用户广播一条系统会话消息，在客户端使用**定时拉取**机制接收。发送消息后，最长 3 分钟内可收到此条消息。属于落地通知<sup><a href="/guides/glossary/imglossary#message-notify">？</a></sup>。|
| [发送全量用户不落地通知] | `/push.json` 用于 **App 业务端**向全部用户或指定用户发送「推送通知」，本质上是直接通过第三方或即时通讯服务自建的推送通道向 App 中所有用户推送一条通知。属于不落地通知<sup><a href="/guides/glossary/imglossary#push-notify">？</a></sup>。|
| [标签用户通知] | `/push.json` 用于 **App 业务端**向携带指定标签的用户发送「推送通知」及系统会话消息，本质上是直接通过第三方或即时通讯服务自建的推送通道向 App 中所有用户推送一条通知。发送的数据携带消息类型和消息内容，属于落地通知<sup><a href="/guides/glossary/imglossary#message-notify">？</a></sup>。 |
| [应用包名通知] | `/push.json` 用于 **App 业务端**向指定应用包名的用户发送「推送通知」及系统会话消息，本质上是直接通过第三方或即时通讯服务自建的推送通道向 App 中所有用户推送一条通知。发送的数据携带消息类型和消息内容，属于落地通知<sup><a href="/guides/glossary/imglossary#message-notify">？</a></sup>。 |

## 开通服务

- 在开发环境下，默认已开启**全量用户通知服务**开关，可免费使用。
- 在生产环境下，可以在控制台 [IM 服务管理](https://console.rongcloud.cn/agile/formwork/advance/index)页面的**普通服务**标签下开通**全量用户通知服务**。**IM 旗舰版**或**IM 尊享版**可开通该服务。具体功能与费用以[官方价格说明](https://www.rongcloud.cn/pricing)页面及[计费说明](https://help.rongcloud.cn/t/topic/123)文档为准。

![(height=500)](../assets/dev-console/broadcast-and-push.png)

## 开通云存储服务

如果需要即时通讯服务端长期存储系统会话消息，请开通对应的云存储服务。开通成功后，客户端可通过获取远端历史消息的 API 获取服务端存储的历史消息记录。

| 名称| 接口| 服务端消息存储服务 |
|---|---|---|
| [发送全量用户落地通知] | `/message/broadcast.json` | 默认不存入即时通讯服务端历史消息记录。如需存储，请[提交工单]申请开通**广播消息云存储**。 |
| [发送在线用户广播] | `/message/online/broadcast.json` | 不支持存入服务端历史消息记录。 |
| [发送全量用户不落地通知] | `/push.json` |  **仅产生推送通知，不产生消息**，不支持在服务端存储。 |
| [标签用户通知] | `/push.json` | 仅依赖开通**单群聊消息云存储**服务。您可以前往控制台 [IM 服务管理]页面，在**普通服务**标签下开通服务。 |
| [应用包名通知] | `/push.json` | 仅依赖开通**单群聊消息云存储**服务。您可以前往控制台 [IM 服务管理]页面，在**普通服务**标签下开通服务。 |

<!-- links -->
[发送全量用户落地通知]: ./send-message-broadcast-to-all.md
[发送在线用户广播]: ./send-message-broadcast-online.md
[发送全量用户不落地通知]: ./send-push-to-all.md
[标签用户通知]: ./send-push-by-tag.md
[应用包名通知]: ./send-push-by-package.md
[提交工单]: https://console.rongcloud.cn/agile/formwork/ticket/create
[IM 服务管理]: https://console.rongcloud.cn/agile/formwork/advance/index