总览

消息推送支持通过 API 接口调用的方式实现极简推送、模板推送、批量推送、群发推送、消息撤回、使用分析、定时推送功能。消息推送支持即时推送、定时推送、循环推送三种不同推送策略,以满足您在不同场景下的推送需求,减少重复工作量。同时,提供短信补充服务,即通过短信通道进行消息补充,以提升消息触达率。

重要
  • 目前,仅杭州非金融区提供短信补充服务。

  • 使用短信业务,会产生额外的运营商费用。有关短信服务的计费方式和定价信息,请参考 短信服务计费方式什么是短信服务

厂商通道的参数特殊限制,请参考:

厂商通道

规则限制

华为

受限说明

接口文档

荣耀

推送数量管理细则

接口文档

鸿蒙

使用约束

接口文档

小米

推送消息规则

接口文档

OPPO

推送服务受限说明

接口文档

vivo

推送消息限制说明

接口文档

消息推送提供以下服务端 API,具体描述见下表。

API

描述

极简推送

对一个目标 ID 推送一条消息。

模板推送

对一个目标 ID 推送一条消息,消息通过模板创建。

批量推送

对多个目标 ID 推送不同消息。基于模板,为各推送 ID 配置不同的模板占位符内容,从而实现消息的个性化推送。

群发推送

对全网设备推送相同消息,消息通过模板进行创建。

消息撤回

对已推送的消息进行撤回。通过极简推送或模板推送方式推送的消息可通过消息 ID 撤回;通过批量推送和群发推送方式推送的消息可通过任务 ID 撤回。

使用分析

查询消息推送统计数据,包括总推送条数、推送成功数、推送到达数、消息打开数、消息忽略数等,通过控制台创建或通过调用 API 触发的批量推送任务和群发推送任务列表以及任务详情。

定时推送任务

支持查询定时推送任务列表、取消定时推送任务。定时推送任务分为定时推送和循环推送两种:

  • 定时推送:在指定时间推送消息。例如,指定在 6 月 19 日早上 8:00 推送消息。

  • 循环推送:在指定时间范围内重复推送,例如指定在 6 月 1 日 ~ 9 月 30 日期间,每周五早上 8:00 推送。一个循环推送任务可能生成一个或多个定时推送任务。