小程序统一服务消息_「能力更新」小程序接入消息通知指南

一、能力概况

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

二、宿主支持：

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

三、入口位置：

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

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

四、接入流程

步骤一：获取模版ID

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

添加模版有两种方式：

• 选择模版库中的模版

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

• 自定义模版

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

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

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

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

五、下发条件说明

有效期及限制

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

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

3、登录才能收集用户formid

六、常见问题：

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

A：会的，需要填满数据。

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

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

Q：有定向的用户限制吗？

A：面向使用过的用户，需要收集用户的formID。