DocsICP FilingConsole
官方文档
首页

Test SMS sending

更新时间：
复制 MD 格式
产品详情
我的收藏

To test Short Message Service before your application goes live, send a testing message from the console or by calling the API.

Usage notes

  • You can only send test messages to recipients in the Chinese mainland.

  • Test messages can be sent only to authorized mobile numbers. Each Alibaba Cloud account can have a maximum of five authorized test mobile numbers, which you can bind in the console.

  • Test messages are subject to limits, such as the total number of messages and sending frequency. Be aware of these limits to avoid interruptions during testing.

  • If you use a custom message template with variables to send test messages, pass parameters as you would in a production environment. The message may be blocked if parameters do not match the variable specifications or differ significantly from your business scenario.

  • Sending test messages is a paid service. Before you send messages, ensure you have a sufficient message package balance or account balance. Charges are first deducted from your message package. If the package quota is exceeded, charges are billed on a pay-as-you-go basis and deducted from your account balance. For more information, see Billing overview.

Before you begin

Before sending test messages, you must submit your qualifications, signature, and template for approval. You can proceed only after they are approved. Additionally, the real-name registration for your signature must be complete.

Note

After your signature is approved, its status becomes Filed pending verification. You must send actual text messages to dynamically verify channel availability and trigger supplementary carrier filing. If you do not actively send messages, the filing process progresses slowly and some carrier channels may remain inactive.

  1. Apply for qualifications: Log on to the GoChina - Qualification Management page in the console and complete the application. Qualification descriptions | Instructions

  2. Apply for a signature: Log on to the GoChina - Signature Management page in the console. Review rules | Real-name registration for signatures | Instructions

  3. Apply for a template: Log on to the GoChina - Template Management page in the console. Review rules | Instructions

Procedure

  1. Sign up for an Alibaba Cloud account, complete real-name verification, and activate Short Message Service.

  2. Log on to the Quick Learning and Test page of the Short Message Service console.

  3. In the Send Test Message section, select API or Console.

  4. Authorize mobile numbers to receive test messages. Click Bind a mobile number for testing, and then enter the mobile number and the verification code you receive.

    Note

    • You can send test messages only to authorized (bound) mobile numbers.

    • Unbind a mobile phone number: Delete the mobile phone number in the console.

API

  1. Select a Custom signature and template, and then select an approved signature and template.

  1. Click Call API to Send SMS. You are redirected to the OpenAPI Portal. The parameters are automatically populated in the left-side panel. Verify that the parameters are correct.

    • Check the endpoint field to ensure a region in the Chinese mainland is selected, such as China (Hangzhou).

    • The value of the TemplateParam parameter must be in JSON format. For example: {"code":"1234"}.

  2. Click Initiate Call to send the test message.

  1. View the API call result on the Call Result tab on the right.

Common API parameter errors and troubleshooting

If your test messages fail to send, check the following common parameter issues:

Parameter

Requirement

Common errors

SignName

Enter the full exact name of an approved signature. No extra spaces or special characters. The value must match your code configuration exactly.

Extra spaces in the signature name; using a signature that has not been approved; mismatch between the code and the actual signature name.

TemplateParam

Must be in JSON format. Example: {"code":"1234"}. Variable values must comply with the template variable specifications (for example, a verification code template requires a 4-to-6-digit number).

Non-JSON format; variable values that violate type constraints (such as letters in a digits-only verification code field); incorrect variable key names.

TemplateCode

Enter the correct template code. Signatures and templates can be freely combined. You do not need to use the associated signature shown in the template details page.

Entering the wrong template code; assuming the template can only be used with its originally associated signature.

Console

  1. Enter the following information:

    • Product Type: Select Domestic.

    • Signature: Select an approved signature.

    • Template: Select an approved template.

    • To: Enter an authorized (bound) test mobile number.

  2. Click Send SMS.

Query sending details

You can check the sending details of sent messages in the following ways:

Next steps

After testing Short Message Service, follow these steps to use it in your production environment.

  • Send multiple small batches of test messages for carrier channel activation: After your signature and template are approved, send messages to mobile phone numbers of the three major carriers (China Mobile, China Unicom, and China Telecom). We recommend sending 10 to 20 or more messages per carrier per day for 5 to 7 business days to trigger supplementary carrier filing and activate channels. You can reuse the same set of phone numbers for repeated sends, but avoid triggering rate limits.

    Note

    You do not need to wait for the console filing status to change. Once your actual delivery success rate is stable and meets your business expectations, you can put the service into production.

  • Send messages by using Mass Messaging: Log on to the GoChina - Mass Messaging page in the console. For detailed instructions, see Send mass messages.

  • Send messages by calling an API: See the API reference for SendSms and SendBatchSms.

Previous：Message sending rulesNext：Send bulk messages