跳到主要内容

全量用户通知服务配置

即时通讯服务提供全量用户通知服务,允许 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 服务管理页面的普通服务标签下开通全量用户通知服务IM 旗舰版IM 尊享版可开通该服务。具体功能与费用以官方价格说明页面及计费说明文档为准。

(height=500)

开通云存储服务

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

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