订阅消息功能

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

功能介绍

一次性订阅消息

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

查看原图	查看原图
今日头条一次性订阅示例	抖音一次性订阅示例

长期性订阅消息

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

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

查看原图

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

订阅消息权限管理

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

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

查看原图 查看原图

推送说明

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

• 推送位置：

  • 抖音：

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

查看原图

• 头条：

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

使用说明

步骤一：获取消息 ID

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

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

步骤二：获取下发权限

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

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

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

使用规范

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

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

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

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