字节跳动小程序接入消息通知指南
能力概况
为便于开发者对用户进行服务消息触达,简化小程序模板消息下发流程,小程序提供统一的服务消息下发接口,以便实现服务的闭环并提供更佳的体验。
宿主支持
今日头条已上线,其他宿主陆续接入中。
入口位置
- 「我的-消息通知」入口
- 「头条内气泡」入口(只有部分消息通知会展示该入口,由平台审核)
接入流程
步骤一:获取模版 ID
前往开发者平台,在「消息通知」板块,点击添加模版;
添加模版有两种方式:
- 选择模版库中的模版 添加模版库中的模版,可直接添加使用,选中某个模版点击添加后,选择相关关键词配置,如果还想添加更多的关键词或者定义好的关键词不符合预期,可申请新的关键词(提交后需审核),右边为该消息模版的展示预览。
- 自定义模版 若模版库中的模版不符合预期,可申请自定义模版,点击右上角的申请新模版;
根据相应的提示文字进行自定义模版填写(该申请需要审核)。
步骤二:使用 formid 作为发送消息通知的凭证
-
获取途径
- 页面的 form 组件,属性 report-submit 为 true 时,可以声明为需要发送模板消息,此时点击按钮提交表单可以获取 formId,用于发送模板消息
- 点击一次随机生成一个 formid,类似 uuid(32 位),传给开发者
-
消耗途径
- 每发送一条消息,消耗一个 formid
- 调取 send 来发送消息(已支持、send 接口文档:https://www.w3cschool.cn/microapp/microapp-3l5g36b3.html )
下发条件说明
有效期及限制
1.每个 formid 从生成时间开始,7 天内有效
2.1 次提交表单可下发 1 条,多次提交下发条数独立,相互不影响
3.登录才能收集用户 formid
常见问题:
Q:如果后台添加的时候 是两个关键词,发送的时候小于两个会报错吗?
A:会的,需要填满数据。
Q:小气泡的入口可以点击进入小程序吗?可以进入指定页面吗?
A:可以点击进入小程序内配置的对应页面。
Q:有定向的用户限制吗?
A:面向使用过的用户,需要收集用户的 formID。