Card message template requirements

更新时间:
复制 MD 格式

Multimedia messages are available as digital messages and card messages. This topic describes the specifications for card message templates.

Card message content specifications

Category

Specification

Template purpose

  • Pilot commercial use

  • Commercial use

Note

When using a test template, set the template purpose to pilot commercial use and add the word Test to the template name, text content, and body.

Entity information

The assets (images, text, or videos) of a card message must contain information about the sending entity, such as a brand logo, store name, brand name, or signature. If the original assets do not contain entity information, add an SMS signature enclosed in square brackets [] at the beginning of the message body.

Line breaks

Currently, image-text templates do not support line breaks. Only carousel templates support line breaks, with a maximum of 11 lines.

Note

If you submit an image-text template with line breaks, the content may not display completely, and the template will fail the review.

Images

When you upload assets to OSS, use unique names for them. Using the same name for different images under the same account can cause asset confusion in templates.

Note
  • Image template dimensions: 16:9 for image-text templates, and 1:1 for horizontal scroll and E-commerce templates.

  • Image size: The recommended size is 100 KB. The maximum size is 2 MB. The image must not be blurry or have unreadable text.

  • Image format: JPG, JPEG, or PNG.

  • Image content: The content must match the selected template scenario and copy. Do not use images from past holidays or events.

  • If you add a logo, it must match the entity information.

Text

A subject is required and does not support line breaks. Carousel templates support line breaks, with a maximum of 11 lines.

Note
  • Special characters, typos, and repeated punctuation are not supported.

  • The body and title must match the corresponding image or linked content.

Video

Upload a clear video and video thumbnail.

Note
  • File format: MP4.

  • The compressed bitrate must be at least 384 Kbps.

  • File size: A single video cannot exceed 10 MB.

  • The audio and video content must be related to the entity information. The video must have audio. Use videos with sound.

  • For video and image-text templates, the video thumbnail and the banner image at the bottom of the template cannot be the same.

  • The video content cannot contain watermarks or logos from other video platforms, TV stations, websites, or production companies.

Links

  • The allowed format is a combination of an official website link and a variable, such as https://www.aliyun.com/${url}. The specific URL can be used only after it is approved.

  • The sample redirect URL may differ from the one used by the actual sending enterprise. When creating the template, add a note: "Alibaba Cloud merchant template. The example short link will be updated when it goes online. Ensure the example can be opened."

  • Do not upload links arbitrarily. For example, the fallback URL field (floor url) is mandatory for OPPO. Otherwise, the request will fail directly.

  • The link content must match the redirected image and the corresponding title.

Note
  • If the content of the event page is inconsistent with the image and text assets, add a note when submitting the template: "The event has not started. The content will be updated after it goes online."

  • When using a redirect link to a PC page, the link cannot be a dead link, a malicious URL, or a URL that triggers a security risk warning.

Variables

You can add text variables, such as ${name}.

Note

A variable is limited to 1 to 20 characters. A maximum of three text variables can be added to a single text message.

Event type

  • Redirect to H5 page: The H5 endpoint is required. It cannot exceed 1,000 characters, must start with https://, and supports variables.

  • Redirect to app: The deep link cannot exceed 1,000 characters. The package name cannot exceed 50 characters. The fallback link cannot exceed 1,000 characters.

  • Redirect to browser: The endpoint is required. It cannot exceed 1,000 characters, must start with https://, and supports variables.

  • Open dial pad: The number cannot exceed 20 characters and supports variables.

Parameters

Parameter names can contain only letters and digits, must start with a letter, and cannot exceed 10 characters.

Example: name123

Price mismatch in E-commerce templates

If the price in the assets is inconsistent with the price on the event page, add a note when submitting the template: "The event has not started. The price will be updated after it goes online."

Content

Do not send text messages that involve the following content: social networking, education and training, micro-businesses, second-class E-commerce, medical aesthetics, medical care, drugs, hospitals, firearms, weapons, controlled knives, dangerous goods, pornography, gambling, drugs, party and government affairs, legal rights protection, crowdfunding, charitable fundraising, religion, superstition, stocks, study abroad and immigration, interviews and recruitment, lotteries, loans, debt collection, credit card limit increases, investment and wealth management, prize winnings, lucky draws, one-CNY prize grabs, one-CNY flash sales, one-CNY cloud purchases, counterfeit goods, tobacco and alcohol, dating, violence, intimidation, fur products, cash back or rebates, illegal cash-out services, game cheats, invoice issuance services, information prohibited by carriers, proxy registration, certificate handling services, invitations to join groups or add QQ or WeChat contacts, selling personal information, carrier services, traffic marketing, language that violates advertising laws, funeral services, brushing, task-based schemes, empty package websites, soliciting positive reviews, store transfers, user acquisition, crowdsourcing, POS machines, or points redemption.

References

Sample Card SMS templates