On the Template Management page of the Short Message Service console, you can view your submitted domestic SMS message templates and manage them based on their status.
Prerequisites
You have activated Alibaba Cloud Short Message Service.
You have created at least one approved SMS signature.
You want to send domestic SMS messages. SMS templates for domestic messages are managed on this page.
Overview
On the Template Management page, you can create, view, edit, and manage SMS templates used for domestic message sending. Each template must pass Alibaba Cloud's review before it can be used. Templates are categorized by type (OTP, Notification, or Promotional) and reviewed according to their intended use.
View and Filter Templates
The Template Management page lists all domestic SMS message templates under your account. You can use the filter bar to narrow results.
Available filters:
Filter | Description |
Signature Name | Filter by the SMS signature associated with the template. |
Template Type | Filter by template type: OTP, Notification, or Promotional. |
Review Status | Filter by review status. |
Template Status | Filter by operational status. |
Template Name/Code | Search by template name or template code. |
Tag | Filter by tag. |
Template list columns:
Column | Description |
Template Name | The name of the SMS template. Click to open the template details page. |
Signature Name | The SMS signature associated with the template. |
Tag | User-defined classification tags. |
Work Order Number | The work order number generated when the template was submitted for review. |
Template Code | The unique code assigned to the approved template. Used to reference the template in API calls. |
Template Type | The type of the template: OTP, Notification, or Promotional. |
Created Time | The time when the template was created. |
Review Status | The current review status of the template. |
Template Status | The operational status of the template. For status definitions, see the Template status section below. |
Operations | Available operations for the template. For details, see the Template operations section below. |
Create a Template
On the Template Management page, click Add Template.
Configure the following parameters:
Parameter
Required
Description
Template Type
Yes
The type of SMS template: OTP, Notification, or Promotional.
Template Name
Yes
A name to identify the template.
Signature Name
Yes
The SMS signature to use with this template.
SMS Content
Yes
The body text of the SMS message. Use
${variable}for dynamic content fields.Template Rules
No
A description of the applicable scenarios and usage conditions for the template.
Traffic Driving
No
Indicate whether this template drives traffic to an external link.
Remarks
No
Additional notes for reviewers.
Click Submit to submit the template for review.
Edit a Template
On the Template Management page, find the template you want to edit.
In the Operations column, click Edit.
Modify the template parameters as needed, then click Submit.
View Template Details
Click a template name to open the details page. The details page contains the following sections:
Basic Information
Displays the core attributes of the template: template name, type, code, content, review status, rejection reason (if applicable), and remarks.
Associated Signatures
Lists the SMS signatures associated with this template. Each row represents one signature-template combination.
Column | Description |
Signature Name | The associated SMS signature. |
Signature-Template Association Reason | The reason this signature is associated with the template. |
Template list
On the Template Management page in the Short Message Service console, you can view a list of your domestic SMS message templates. The list displays key information such as the Template Code and Template Status. You can click a Template Name to view the template details.
Clicking a template name opens the Details dialog box, which displays fields such as template type, template name, template code, template content, diversion information, Tag, variable attributes, associated signature, Use Case Description, and Creation Time.
Diversion information
Content in a message template, such as links and contact numbers, is considered diversion information.
To ensure SMS content security, messages with diversion information such as links or contact numbers have a higher risk of being blocked by carriers, which can cause delivery failures. We recommend avoiding this information in your message templates to minimize the risk.
Hover over the Template Code field in the template list to quickly view the content, variables, and diversion information of the current template. In the pop-up, the diversion information section categorizes and displays the diversion content detected in the template, including phone numbers (labeled as "numbers starting with 1") and domain-type links. | The following rules apply to diversion information:
|
Template status
The Template Status is determined by Alibaba Cloud based on a comprehensive assessment of factors such as the template approval status and template content. If a template's status is Unavailable, you cannot use it to send SMS messages. We recommend that you monitor the template status and keep it in the
Normal state.
You can view the template list on the Template Management page and perform relevant actions based on the Template Status field:
Template status | Description |
| The template is complete, approved, and has all required signatures and diversion information. If the template does not contain diversion content, this information is not required. |
|
|
|
|
| The current template is missing associated signature information. Click the Supplement button next to the template status and associate a signature in the dialog box that appears. You can only associate approved signatures. Each template supports a maximum of 100 associated signatures. You can still use a template without an associated signature to send messages. This association is only for pre-collecting diversion information. |
| The feature to add variable attributes is not yet available and does not affect the approval process. |
| If a message template is not approved, its status is Unavailable. |
Template operations
Depending on the template's approval status, you can perform the following operations on the Template Management page:
Approval status | Actions and description |
Pending approval | Templates that are pending approval cannot be modified or deleted. You can Remove the application to proceed.
|
Withdrawn |
|
Rejected |
|
Approved | Approved templates cannot be modified. Note Templates and signatures do not require a mandatory association for sending messages. After your templates and signatures are approved, you can mix and match them as needed. For more information, see Will an associated signature affect message sending? Different templates can be associated with the same signature. The relationship between signatures and templates is many-to-many.
|
Associated signatures
On a template's details page, the associated signature area lists all signatures associated with it, including their name and status. To disassociate a signature, click Disassociate in its Actions column. This removes the signature from the template's association list but does not affect the signature itself, which can still be associated with other templates. Each template can be associated with a maximum of 100 signatures.
Template export
The Template Management page allows you to export template data to your local machine. Click the Export button in the upper-right corner of the template list to submit an export request. After the request is successful, click Export Records to download the exported content.
The exported file includes the following fields: Template Code, Template Name, Template Type, Template Content, Review Status, and Create Time.
The exported file does not include the signature field. Signatures are not bound to templates, and you can freely combine signatures and templates when sending messages. To obtain signature information, export the signature list separately on the SMS signature management page.