【2025年1月2日】关于腾讯云小程序平台更名为腾讯云超级应用服务的公告
控制台更新动态
Android SDK 更新动态
iOS SDK 更新动态
Flutter 更新动态
IDE 更新动态
基础库更新动态
订阅消息
前言
Superapp 通过为小程序开发者提供订阅消息能力，以便实现小程序或小游戏内的服务闭环，通过消息订阅和通知的能力，可将小程序或小游戏内的业务状态变化及时推送给 superapp 用户。
角色和权限
功能 | 角色 | 应用团队管理员 | 应用高级开发者 | 应用开发者 | 应用运营人员 |
消息模板列表-查看 | ✓ | ✓ | ✓ | ✓ |
新建消息模板 | ✓ | ✓ | - | - |
消息模板灰度发布 | ✓ | ✓ | - | - |
删除消息模板 | ✓ | ✓ | - | - |
关键词列表-查看 | ✓ | ✓ | ✓ | ✓ |
功能说明
消息模板
1. 模板列表
说明
为了方便 Superapp 使用，SAS 提供了一次性订阅和长期订阅消息模板，每个小程序、小游戏都可以直接使用这些公共模板，您也可以为 Superapp 下的小程序、小游戏定制消息模板。
筛选条件
适用范围：小程序/小游戏，因小程序和小游戏的通知场景和频率不同，每个模板都在设计的时候要考虑适用于小程序或者是小游戏。
类型：
一次性订阅：一次性订阅消息用于解决用户使用小程序后，后续服务环节的通知问题，每次触发订阅事件后，只允许向用户推送 1 次订阅消息。
长期订阅：通常情况下，一次性订阅消息已经可满足小程序的大部分服务场景需求，但线下公共服务领域存在一次性订阅无法满足的场景，如航班延误，需根据航班实时动态来多次发送消息提醒。为便于服务，我们提供了长期性订阅消息，用户订阅一次后，开发者可长期下发多条消息。长期性订阅消息适用于政务、民生、医疗、交通、金融、教育等线下公共服务。
状态：
草稿：编辑时暂时保存内容。
灰度：指定小程序团队进行灰度发布。
发布：正式发布的模板。
说明：
使用长期订阅消息可以多次给用户发送消息，但是频繁发送消息可能会对用户造成困扰，因此，SAS 限制了每个长期订阅模板消息每日最多推送 5 次。
2. 自定义订阅消息模板
如果您觉得默认的模板不满足 Superapp 的业务需求，您可以选择自定义订阅消息模板。
2.1 创建模板
单击 创建模板。
填写内容：
基本信息
适用范围：选择小程序或小游戏
消息类型：一次性订阅/长期订阅，小游戏不支持长期订阅
支持语言：暂时仅支持英文
模板标题：支持64个以内的英文字母、数字、空格和部分特殊字符（, . - _）
关键词：关键词是消息模板中预定义的、可替换的变量。关键词1必填，单击新增关键词后，往下顺延添加关键词2，删除关键词时，可任意删除某一个关键词，删除后会重新排序（序号大的递补上去），剩下一个关键词时不能删除。其他必填信息如下
关键词名称：输入关键词名称，支持64个以内的英文、数字或空格
关键词类型：关键词的数据校验格式，此处选择 1 个关键词类型
预览数据：用于向开发者展示该参数应该填写的示例内容
填写完毕后，单击保存，将模板保存为草稿状态。
2.2 灰度发布
添加完模板之后，为了验证消息模板的业务效果，您可以选择将模板进行灰度发布，选择一个或多个小程序团队进行灰度发布，由该小程序团队来使用该消息模板完成验证。
2.3 发布
灰度发布之后，单击发布，即可将该模板正式发布出去，让 Superapp 下所有的小程序、小游戏都可以使用。
2.4 删除
处于草稿或灰度状态下的模板，可以再次编辑，也可以删除。
3. 订阅消息模板详情
单击详情可以查看订阅消息模板的详细内容。
关键词类型
关键词是消息模板中预定义的、可替换的变量。当小程序需要向用户发送一条具体的订阅消息时，会将具体的内容填充到这些关键词中，从而形成一条完整的、个性化的消息。
格式：
在模板中，关键词通常以 {{thing.DATA}}这样的形式出现，其中 thing是关键词的名称，.DATA是固定后缀。
示例：
假设你有一个订单发货的提醒模板，它可能包含以下几个关键词：
{{thing1.DATA}}-> 用于填充商品名称
{{character_string2.DATA}}-> 用于填充订单号
{{time3.DATA}}-> 用于填充发货时间
{{thing4.DATA}}-> 用于填充物流公司
关键词类型定义了对应关键词可以接受的内容格式、长度限制和展示方式，这是为了保证消息在不同设备上显示的一致性。
说明：
关键词类型暂不支持自定义。
文档反馈