Template management

Updated at:

The Template Management page of the Short Message Service console shows all Domestic SMS templates that you have submitted and the operations available for each template status.

Template list

On the Template Management page of the Short Message Service console, you can view the list of SMS templates that you have submitted. The list displays key information such as the SMS Template Code and Template Status. You can click a Template Name to view the template details.

The search box filters the template list by template code. When the search box contains a value, the list displays only the matching templates; clear the search box to view all templates. If you cannot find a template, including the complimentary OTP template provided by the system, the search box may still retain a recently added template code and filter out other templates.

Diversion information

Links, contact numbers, and similar content in an SMS template are classified as diversion information.

Important

SMS messages that contain diversion information such as links or contact numbers are more likely to be blocked by carriers, which causes delivery failures. Avoid such information in SMS templates whenever possible to reduce the risk of delivery failure.

Hover over the Template Code field in the template list to quickly view the content, variables, and diversion information of the current template.

The following rules apply to diversion information:

  • Each template can contain a maximum of two contact numbers. The numbers must all come from variables or all come from the static text content.

  • Each template can contain a maximum of one variable with the phone number attribute.

  • Each template can contain a maximum of one diversion link. The link must come from the static text content and cannot come from a variable.

Template status

The Template Status is the result of a comprehensive assessment that Alibaba Cloud performs on factors such as the template review status and the template content. When the template status is Unavailable, the template cannot be used to send SMS messages. (Recommended) Keep the template status in the Normal state.

On the Template Management page, you can view the template list and check the Template Status of each template. The following table describes the template statuses:

Template status

Description

Normal

The template information is complete and the template has passed review. No signature information, diversion information, or diversion materials are missing. If the template itself does not involve diversion, you do not need to provide diversion-related information.

Diversion information missing

  • Diversion information refers to phone numbers, links, and diversion materials (credential documents).

  • When the system detects that the current template may involve diversion, you must provide the specific diversion information, such as the actual phone number or link. For the content rules, see Diversion information.

Diversion materials missing

  • Diversion materials are the credential documents for a phone number or link, such as business or organization information or an ICP filing screenshot.

  • The system has detected that the current template content is missing diversion materials (additional fields for phone numbers and links). You must provide the diversion materials. For the content rules, see Diversion information.

Signature information missing

The current template is missing associated signature information. A template that is not associated with a signature can still be used to send SMS messages. Signature association is used only to collect diversion information in advance. To associate a signature, see Associated signature management.

Variable attributes missing

The variables in the current template content are missing variable attribute information.

The capability to add variable attributes is not yet available, and variable attributes do not involve review or filing.

Unavailable

When an SMS template has not passed review, the template status is Unavailable.

Template operations

Based on the review status of a template, you can perform the following operations on the Template Management page:

Review status

Supported operations and description

Under review

Templates under review cannot be modified or deleted. You can Remove the application to proceed.

  • Remove: Withdraws a template application that is under review. After the removal, the review status changes to Withdrawn.

  • Expedite: If the review status does not change within 20 minutes after you submit the application, you can use the review expediting feature.

Withdrawn

  • Edit: Edit the template information. After you finish the modification, click AI Validate to resubmit the template for review.

  • Delete: Delete the template. A deleted SMS template cannot be recovered. Proceed with caution.

Rejected

  • View reason and modify: View the review comments and refer to Troubleshoot message template rejection to modify the template information.

    • After you finish the modification, resubmit the template for review.

    • Alternatively, call the UpdateSmsTemplate operation to modify a template that failed the review.

  • Delete: Delete the template. A deleted SMS template cannot be recovered. Proceed with caution.

Approved

Approved templates cannot be modified.

Note

SMS templates and SMS signatures are not strongly associated in actual use. After the templates and signatures that you create pass review, you can combine them freely based on your actual needs to send SMS messages. For more information, see Will an associated signature affect message sending?.

Different templates can be associated with the same signature. Signatures and templates have a many-to-many relationship.

  • Send in batches: Click Mass Messaging to go to the New Messaging Task page of the batch sending feature.

  • Clone: Clone an approved template. The system automatically populates the template type information. You can modify the existing information and submit the template for review.

  • Delete: Delete the template. A deleted SMS template cannot be recovered and can no longer be used to send SMS messages. Proceed with caution.

Associated signature management

Click a template name to go to the template details page. In the Associated Signature section, you can view all signatures associated with the current template, including the signature name and the signature status.

  • Associate a signature: Click Associated Signature and select the signature that you want to associate in the dialog box. When the template status is Signature information missing, you can also click the Supplement button after the template status and associate a signature in the dialog box that appears. You can associate only approved signatures. Each template can be associated with a maximum of 100 signatures.

  • Disassociate a signature: In the Actions column of the target signature row, click Remove. After the association is removed, the signature no longer appears in the association list of this template. The signature itself is not affected and can still be associated with other templates.

Export

You can export template data from the Template Management page to your computer. Click the Export button in the upper-right corner of the template list to submit an export request. After the request succeeds, click Export Records to download the exported content.