一、能力概况

为便于开发者对用户进行服务消息触达,简化小程序模板消息下发流程,小程序提供统一的服务消息下发接口,以便实现服务的闭环并提供更佳的体验。

二、宿主支持:

今日头条已上线,其他宿主陆续接入中。

三、入口位置:

  • 「我的-消息通知」入口



java 微信小程序推送服务通知 小程序服务通知接口_模版


  • 「头条内气泡」入口(只有部分消息通知会展示该入口,由平台审核)


java 微信小程序推送服务通知 小程序服务通知接口_模版_02


四、接入流程

步骤一:获取模版ID

前往开发者平台,在「消息通知」板块,点击添加模版;


java 微信小程序推送服务通知 小程序服务通知接口_java 微信小程序推送服务通知_03


添加模版有两种方式:

  • 选择模版库中的模版

添加模版库中的模版,可直接添加使用,选中某个模版点击添加后,选择相关关键词配置,如果还想添加更多的关键词或者定义好的关键词不符合预期,可申请新的关键词(提交后需审核),右边为该消息模版的展示预览。


java 微信小程序推送服务通知 小程序服务通知接口_开发者_04


  • 自定义模版

若模版库中的模版不符合预期,可申请自定义模版,点击右上角的申请新模版;


java 微信小程序推送服务通知 小程序服务通知接口_开发者_05


根据相应的提示文字进行自定义模版填写(该申请需要审核)。


java 微信小程序推送服务通知 小程序服务通知接口_小程序统一服务消息_06


步骤二:使用formid作为发送消息通知的凭证

  • 获取途径
  • 页面的form组件,属性 report-submit 为 true 时,可以声明为需要发送模板消息,此时点击按钮提交表单可以获取 formId,用于发送模板消息
  • 点击一次随机生成一个formid,类似uuid(32位),传给开发者
  • 消耗途径
  • 每发送一条消息,消耗一个formid
  • 调取send来发送消息(已支持、send接口文档

五、下发条件说明

有效期及限制

1、每个formid从生成时间开始,7天内有效

2、1次提交表单可下发1条,多次提交下发条数独立,相互不影响

3、登录才能收集用户formid

六、常见问题:

Q:如果后台添加的时候 是两个关键词,发送的时候小于两个会报错吗?

A:会的,需要填满数据。

Q:小气泡的入口可以点击进入小程序吗?可以进入指定页面吗?

A:可以点击进入小程序内配置的对应页面。

Q:有定向的用户限制吗?

A:面向使用过的用户,需要收集用户的formID。