tencent cloud

Message Subscription
Last updated:2026-01-16 20:57:33
Message Subscription
Last updated: 2026-01-16 20:57:33

Introduction

Superapp allows mini program or mini game developers to send subscription messages, creating a closed-loop service. This lets developers quickly push business updates within mini programs or mini games to superapp users.

Roles and permissions

Feature | Role
Superapp team admin
Senior superapp developer
Superapp developer
Superapp operator
Message template list - View
Create a message template
-
-
Message template canary release
-
-
Delete a message template
-
-
Keyword list - View

Feature description

Message template

1. Template list

Description
SAS provides one-time subscription and long-term subscription message templates, which can be used directly for mini programs and mini games. You can also customize message templates.
Filters
Applies to: Mini program or mini game. As the notification scenarios and frequencies differ between mini programs and mini games, each template is designed specifically for either mini programs or mini games.
Type:
One-time subscription: One-time subscription messages address notification needs for follow-up service steps after users engage with a mini program. After each subscription event is triggered, only one subscription message can be sent to the user.
Long-term subscription: While one-time subscription meets most service needs within mini programs, there are scenarios, especially in public services, where one-time subscriptions are insufficient. For example, flight delays require multiple real-time updates. To address this, we offer long-term subscription. After a user subscribes once, developers can send multiple messages over time. Long-term subscription is suitable for public services such as government, civil services, healthcare, transportation, finance, and education.
Status:
Draft: Content saved temporarily during editing.
Canary release: Released to a designated mini program team for testing.
Released: Officially released template.
Note:
Note that while long-term subscription allows multiple messages to be sent, frequent messaging can be disruptive to users. Therefore, SAS limits each long-term subscription template to a maximum of 5 messages per day.


2. Customize the subscription message template

If the default templates don't meet your superapp’s business needs, you can customize the subscription message template.
2.1 Create a template
Click Create template.

Fill in the following:
Basic information
Applies to: Select mini program or mini game.
Message type: One-time subscription or long-term subscription. The latter does not apply to mini games.
Language: Only English is supported.
Template title: Supports up to 64 characters, including letters, numbers, spaces, and certain special characters (, . - _).
Keywords: They are predefined, replaceable variables in the message template. Keyword 1 is required. Click Add keyword to add keyword 2, and so on. Keywords can be deleted individually. When a keyword is deleted, the sequence is reordered (higher numbers shift down). If only one keyword remains, it cannot be deleted. Other required information:
Keyword name: Enter the keyword name, which supports up to 64 characters, including letters, numbers, and spaces.
Keyword type: Select one keyword data validation format.
Preview data: Used to show developers an example of the content expected for this parameter.

Click Save to save the template as a draft.
2.2 Canary release
After adding a template, you can choose to perform a canary release by selecting one or more mini program teams. These teams will use the message template for validation.


2.3 Release
After the canary release, click Release to officially release the template, making it available for all mini programs and mini games within the superapp.

2.4 Delete
Templates in draft or canary release status can be edited or deleted.

3. Subscription message template details

Click Details to view the details of the subscription message template.


Keyword type

Keywords are predefined, replaceable variables in a message template. When a mini program or mini game sends a specific subscription message to a user, the system automatically fills these keywords with the corresponding content to generate a complete, personalized message.
Format:
In templates, keywords typically appear in the form {{thing.DATA}}, where "thing" is the keyword’s name and ".DATA" is a fixed suffix.
Example:
Suppose you have a delivery notification template for an order, which may include the following keywords:
{{thing1. DATA}} for the product name.
{{character_string2. DATA}} for the order number.
{{time3. DATA}} for the delivery time.
{{thing4. DATA}} for the logistics company name.
Keyword types define the acceptable content format, length limits, and display method for each keyword. This ensures consistent message presentation across different devices.
Note:
Keyword types are currently not customizable.

Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback