订阅消息功能

订阅消息消息能力是小程序能力中的重要组成,我们为开发者提供了订阅消息能力,以便实现服务的闭环和更优的体验。

功能介绍

一次性订阅消息

一次性订阅消息用于解决用户使用小程序/小游戏后,后续服务环节的通知问题。用户自主订阅后,开发者可不限时间地下发一条对应的服务消息;每条消息可单独订阅或退订。

今日头条一次性订阅示例抖音一次性订阅示例

长期性订阅消息

一次性订阅消息可满足小程序的大部分服务场景需求,但线下公共服务领域存在一次性订阅无法满足的场景,如航班延误,需根据航班实时动态来多次发送消息提醒。为便于服务,我们提供了长期性订阅消息,用户订阅一次后,开发者可长期下发多条消息。

目前长期性订阅消息仅向政务民生、医疗、交通、金融、教育等线下公共服务类小程序开放,后期将逐步支持到其他线下公共服务业务。

今日头条/抖音长期性订阅示例

订阅消息权限管理

以下几种情况的订阅消息权限可以在设置--订阅消息管理页面中进行管理,包括开启与拒绝接受

  • 一次性订阅消息选择“总是保持以上选择,不再询问”后
  • 长期性订阅消息选择“允许”后
  • 长期性订阅消息选择“拒绝,不再询问”后

推送说明

  • 订阅消息下发条件:用户自主订阅
  • 订阅消息卡片跳转能力:点击查看详情可跳转至该小程序的页面
  • 推送位置:

    • 抖音:

      • 消息 tab:小程序通过“第三方服务通知”发送,小游戏通过“游戏通知”发送
      • 抖音侧暂不支持 push
  • 头条:

    • 我的--消息通知
    • 气泡:只针对已关注小程序的授权用户生效,单日不超过 3 次
    • push:只针对已关注小程序的授权用户生效,单日不超过 3 次

使用说明

步骤一:获取消息 ID

登录字节开发者平台手动配置获取模板 ID

  • 不同的服务类目对应不同的模板,开发者仅能看到该小程序所属服务类目的模板
  • 当小程序所属服务类目被删除后,该类目对应的模板也会被删除,请谨慎操作
  • 部分服务类目对应的场景暂无模板,如有需求,可在开发者社区反馈,我们将定期评估
  • 各模板有适用的宿主,仅在可用宿主上可正常使用,例如模板 A 可用宿主仅为“今日头条”,那该模板在抖音上不可用

步骤二:获取下发权限

详见小程序端消息订阅接口tt.requestSubscribeMessage

步骤三:调用接口下发订阅消息

详见小助手消息推送/订阅消息 服务端接口

使用规范

(1)使用订阅消息能力进行诱导点击、下发与用户预期不符的内容被视为违规

(2)针对关注小程序的用户可以发送 push 与气泡,对恶意诱导关注的行为将视为违规

  • 第一次违规,封禁接口 7 天
  • 第二次违规,封禁接口 14 天
  • 第三次违规,封禁接口 30 天
  • 第四次违规,永久封禁接口

(3)开发者平台暂不支持新增模板、新增关键字的申请,后期将逐步开放,如对抖音模板库里不存在的模板有强烈诉求,请反馈

点击纠错
评价此篇文档