首页

解决方案

经营案例

文档

学堂

社区

服务市场

支持与服务

合作平台

订阅消息

基于抖音通知渠道，为开发者提供了可高效触达用户的订阅消息能力，以便实现服务闭环

支持的应用类型：小程序

能力类型：IM

支持的调用方：自研、服务商代开发

是否可用于沙盒环境：否

能力介绍

能力介绍：基于抖音APP内外的双重交互，平台为小程序提供了通知消息强触达用户的能力，即订阅消息。通知消息不仅支持在侧边栏通知消息中展示，部分消息还支持进阶的push推送、feed提醒等能力，使用订阅消息能力可以大大提高消息触达效率，逐步培养用户复访意识。

能力价值：

触达用户的高效方式：订阅消息通过文字消息、图文消息等多种消息样式出现在用户不同的操作场景，让用户在必要时及时获取小程序内最新消息；配合消息的紧急程度该能力会适配不同的通知渠道：通知消息+实时提醒或信息流通知，消息渠道的有机结合可以让订阅消息做到合理高效的信息传达。
用户复访的稳定渠道：消息通知作为小程序开发者与抖音用户进行沟通交流的重要方式，可以快速将内容和变化传达给用户以便用户及时做出反应；当用户有流失去倾向时，订阅消息作为召回用户复访的稳定入口可以支持开发者灵活使用，通过优质内容、福利活动等形式吸引用户再次访问小程序。

使用场景	通知消息——普适触达	实时提醒——进阶触达	信息流通知——进阶触达
场景介绍	在抖音APP中侧边栏中，会聚合展示所有的通知消息，展示内容包含小程序头像+名称+订阅消息标题+订阅消息关键词和具体通知内容，用户在接收消息后可以点击消息概览查看具体消息内容，点击消息具体内容可以前往小程序通知页面。	端内横幅：当用户正在使用抖音APP，消息会在抖音APP当前使用页面顶部以横幅形式展示，展示内容包含小程序头像+名称+订阅消息标题，用户在接收消息后可在抖音APP中的任一使用场景中前往小程序通知页面。端外push：当用户未打开抖音APP，消息将推送至用户移动设备主页展示在APP通知栏处，展示内容包含小程序头像+订阅消息标题+固定的消息通知文案，用户在接收消息后可直接点击唤起APP前往小程序通知页面。	当用户正在使用抖音APP，消息会在抖音APP首页推荐信息流中以异形卡的形式展示，展示内容是图文版本的通知消息，当出现多个订阅异形卡时会聚合展示且自动轮播，用户在刷到订阅异形卡时可以直接点击前往小程序通知页面。
适用的消息类型	支持所有的一次性订阅消息+长期订阅消息	支持部分一次性订阅消息(选择的消息模板需符合规范)	支持部分长期订阅消息(选择的消息模板需符合规范)
场景示例

使用场景

订阅消息是由消息模板和消息内容组成，消息模板用固定文案来定义消息内容结构。消息模板分为模板标题和模板关键词，模板标题用来呈现消息结果状态，模板关键词用来呈现消息内容维度。

例如：

模板标题：订单支付成功通知
关键词：订单号、商品名称、支付金额、支付成功时间

以通知消息中展示的消息为例，用户可以看到以下内容：

1.小程序头像、名称

2.订阅消息管理入口：支持用户对消息进行退出订阅、删除消息、举报消息等管理行为

3.消息下发时间：需要通过接口下发消息

4.订阅消息模板标题：最多支持8个字符

5.订阅消息模板关键词：最少展示2个关键词，关键词内容最多支持8个字符

6.订阅消息内容：开发者根据通知场景提供对应内容，具体下发的消息内容需要审核通过方可下发

7.用户行动点：点击可进入开发者自定义的小程序通知页

小程序订阅消息模板按照使用场景划分为一次性订阅和长期订阅。

一次性订阅

基础介绍

一次性订阅更适配服务触达场景，即目的在于跟用户发生交互（如订单）后的服务通知，对应解决开发者当下即时性的服务触达诉求。

常见一次性消息模板为交易履约类通知：

订单通知
履约通知
航班动态

实时提醒

部分一次性订阅消息模板支持额外的触达能力——实时提醒能力(包含端内横幅以及端外push)。

在模板库内选择一次性订阅在额外触达能力中展示“实时提醒”则支持，展示未设置则不支持：

长期订阅消息模板不支持申请实时提醒。

符合以下规范的一次性订阅消息模板审核通过后支持实时提醒：

支持以下使用场景：适合用户错过消息会影响后续使用链路的通知场景

用户对资产变化主观感知较弱的通知消息，如：商品退款成功、订单取消通知等需要用户第一时间知晓的变化信息；
需要用户实时查看并作出反应的通知消息，如：信息资料上传、开放选座提醒等需要用户看完有后续动作的信息。

不支持以下使用场景：不适合会影响用户体验的消息下发

正常的订单消息通知，例如订单支付成功，用户在主动下单时有明确支付预期，即已知订单支付成功，无需通过实时提醒额外触达；
营销推广性质的消息，例如商品降价通知，该类消息往往对消息时效性无明确要求，即下发后会对用户造成打扰，影响其他更重要的消息下发。

频次控制

小程序对于同一用户发送订阅消息频率限制为 1 条/s。
一次性订阅消息下发频次：用户订阅后可向单个用户发送 2 条消息通知，有效期为1年。
对应模板的下发频次不满足实际使用需求可提交审核增加，审核时会以实际使用场景合理通知量级评估在不影响用户体验的情况下可以增加下发频次。
实时提醒能力频控：每个用户每个小程序每天仅展示2次。

长期订阅

基础介绍

长期订阅更适配推广运营，即目的更偏向长期的用户复访运营，对应解决开发者长期的推广运营诉求。

常见长期订阅消息模板为内容互动类通知：

内容更新通知
玩法升级
会员动态
福利发放

信息流通知

部分长期订阅消息模板支持额外的触达能力——信息流通知能力(即订阅异形卡)。

在模板库内选择长期订阅在额外触达能力中展示“信息流通知”则支持，展示未设置则不支持：

一次性订阅消息模板不支持申请信息流通知。

符合以下规范的长性订阅消息模板审核通过后支持信息流通知：

支持以下使用场景：适合用户看到消息提醒类内容后有访问小程序预期的通知场景

对时效要求较低的消息，信息流通知(即订阅异形卡)在遵循时效频控要求的情况下非实时下发，需要用户在抖音刷到对应内容时不会产生违和感；
对用户起到提醒的消息，用户通过订阅异形卡提醒进入小程序，可完成后续消费、互动、履约等动作如签到、观看内容等。

不支持以下使用场景：不适合会影响用户体验的消息下发

时效要求较高的消息，例如：订单正在配送，属于需要及时触达用户的内容，如果通过订阅异形卡展现在信息流内，等用户刷到时会存在消息内容过时的问题；
普通通知已满足用户获取需求的消息，例如：活动已提交报名，用户通过通知中心即可获取信息非必要进入小程序的内容不适合使用订阅异形卡。

频次控制

小程序对于同一用户发送订阅消息频率限制为 1 条/s。
长性订阅消息下发频次：用户订阅后每月最多可向单个用户发送 8 条消息通知。
对应模板的下发频次不满足实际使用需求可提交审核增加，审核时会以实际使用场景合理通知量级评估在不影响用户体验的情况下可以增加下发频次。
信息流通知频控：用户单天内针对同一小程序仅能收到一次订阅消息异形卡提醒（已授权状态下默认开发者给用户当日下发的第一条订阅消息触发）。

准入条件

订阅消息开放原则：面向在抖音开放平台经营的已上线小程序全量开放。
订阅消息模板使用及申请原则：小程序在申请订阅消息模板时需选择对应行业的消息模板，小程序在下发订阅消息时需遵循抖音开放平台规定的频次要求。

接入流程

申请位置：控制台-能力-互动能力-消息管理-订阅消息

申请流程：小程序订阅消息模板申请

接口列表

名称	类型	描述
新建订阅消息模板	OpenAPI	当模板库中的公共模板模板不满足开发者需求时，可以新建公共模板，待审核通过后模板生效
查询订阅消息模板库	OpenAPI	获取小程序所属类目下的公共模板列表
查询小程序新建的订阅消息模板列表	OpenAPI	查询小程序新建的公共模板列表
添加模板	OpenAPI	基于公共模板创建小程序模板
查询小程序的模板列表	OpenAPI	获取当前小程序已添加的小程序模板列表
删除已添加的模板	OpenAPI	删除已添加的小程序模板
tt.requestSubscribeMessage(主动拉起授权弹窗)	OpenAPI	调起客户端订阅消息界面，返回用户订阅消息的操作结果。询问过用户的模板消息会被添加到用户的小程序设置页，用户可以在设置页面进行管理
用户订阅动作推送事件	OpenAPI	用户订阅模板和拒绝订阅模板时，会推送用户订阅动作事件给开发者
查询用户模板订阅状态	OpenAPI	获取当前小程序下用户和小程序模板的订阅状态
用户授权订阅卡事件	OpenAPI	用户授权长期订阅消息成功且异形卡开关打开情况下，会推送订阅异形卡模板授权成功消息给开发者
给用户发送订阅消息	OpenAPI	用户产生了订阅模板消息的行为后，可以通过该接口发送模板消息给用户
抖音内横幅或抖音外实时提醒触达用户失败事件	OpenAPI	开发者调用发送订阅消息接口时选择下发抖音内横幅通知或抖音外实时提醒通知消息，当横幅或实时提醒消息触达用户失败时，会推送触达用户失败的事件给开发者

该文档是否对你的开发有所帮助？

有帮助

没帮助

名称	链接
小程序订阅消息能力	https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/open-capacity/operation/private-account/subscription-message/subscribe-message
小程序订阅消息模板申请	https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/open-capacity/operation/private-account/subscription-message/template-application
小程序订阅消息常见问题	https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/open-capacity/operation/private-account/subscription-message/mini-app-subscription-faq
接入订阅消息技术教程	https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/tutorial/open-capabilities/management/subscription-message