小程序接入消息通知指南

能力概况

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

宿主支持

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

入口位置

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

图片名称

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

图片名称

接入流程

步骤一:获取模版 ID

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

图片名称

添加模版有两种方式:

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

图片名称

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

图片名称

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

图片名称

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

  • 获取途径

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

下发条件说明

有效期及限制

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

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

3.登录才能收集用户 formid

常见问题:

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

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

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

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

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

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

点击纠错