tencent cloud

This document helps you quickly get started with the Global SMS service by show you how an organization user sends the following message “Your verification code is 1234 (valid for 5 minutes). For account safety, don't forward the code to others.” to mobile numbers outside the Chinese mainland. For more SMS concepts, see Glossary.

Note：

The new version of console is displayed to users who activate the SMS service after September 18, 2019 by default.

Step 1. Activate the SMS service

Signing up for Tencent Cloud account

• If you don't have a Tencent Cloud account yet, you need to sign up for a Tencent Cloud account and verify your organizational identity.
• If you already have a Tencent Cloud account and have verified your identity, go directly to the next step.

Applying for activation of SMS

Note：

When logging in to the SMS console for the first time, you need to apply to activate the SMS service.

1. Log in to the SMS console, click I've read and agree to Tencent Cloud SMS Terms of Service, and click Access to activate the service.
2. Select Getting Started on the left sidebar, select I want to send Global SMS, and click Start to enter the SMS sending guide page.

Step 2. Configure SMS content

A complete SMS message consists of SMS signature and SMS body. You can set different body templates as needed and then combine a signature and a body into the final SMS content: [SMS signature] SMS body. After an SMS signature or template is submitted, it will be reviewed within two hours generally. You can set your mobile number and email address to receive review result notifications.
Signature is optional for Global SMS. This document uses no signature as an example.

Selecting a region

1. On the Getting Started page, select a region in the top-left corner.
   Tencent Cloud International provides services for multiple regions, where product features and prices are the same. However, data cannot be stored across regions but in the local region. Please select a region according to your data storage requirements.
   

Creating a body template

1. On the Getting Started page, click Start creating.
2. Set the following parameters according to your business needs and the body template review standards:
   • Template Name: enter Verification Code.
   • SMS Type: select Regular SMS.
   • SMS Content: enter Your verification code is {1}(valid for {2} minutes). For account safety, don't forward the code to others..
3. Click OK.
   Please wait for the body template review. The body template will be available only after its status changes to Approved.

Step 3. Wait for approval

After an SMS signature or body template is submitted, it will be reviewed within two hours generally. You can set your mobile number and email address to receive review result notifications.
On the [Getting Started] page, you can click** View** to quickly view the review status. The signature or body template will be available only after its status changes to Approved.

Step 4. Send SMS messages

Note：

1. SMS signatures and templates for each region need to be separately created, but they can be copied across regions. Before sending an SMS message, make sure the region selected for the SMS application is the same as that selected for signature and template creation.
2. Before sending an SMS message, make sure the SMS signature and body template have been approved.

You can send SMS messages through the console or API. This document uses the console as an example.

1. On the Getting Started page, click Send SMS.

2. Configure the following parameters as needed:

   • Signature Name: signature is optional for Global SMS.
   • Template Name: select the template Verification Code created in the Creating a body template step.
   • Sending Time: select Send now.
   • Recipient: select Upload mobile numbers, click Download Standard Template, enter the recipient's mobile number and custom SMS content in the form, and click Click here to upload it. The maximum form size supported is 30 MB.

     Template Description	Recipient's Mobile Number	SMS Content Variable 1	SMS Content Variable 2
     Sample	9xxxxxxx	1234	5
     Instructions	Please enter the mobile numbers of recipients. All the mobile numbers in one single SMS sending task must be registered outside the Chinese mainland. The cells need to be in a regular format, i.e., without any specific number formats.	Please enter the first custom variable content according to the body template, i.e., replacing {1} in the template.	Please enter the first custom variable content according to the body template, i.e., replacing {2} in the template.

     There are three types of recipients as follows:

     Recipient	Description	Variable Template
     Upload mobile numbers	You can upload up to 1 million mobile numbers in a CSV or XLSX file of up to 30 MB in size for each bulk SMS sending task. In an SMS body template created by an individual user, each variable can contain up to 12 characters. There is no limit on the length of variable values for organizational users.	Supported
     Select a customer group	Click **Customer Group** and select a number group that has been created in Customer Group. For more information, please see Customer Management. Note: you cannot select a template with variables for Template Name.	Not supported
     Enter mobile numbers	Enter up to 100 mobile numbers and separate them by pressing the Enter key (one number per line). For mobile numbers outside the Chinese mainland, please enter the country/region code + mobile number. For example, when the country/region code is 852 and the mobile number is 6666XXXX, enter 8526666XXXX. Note: you cannot select a template with variables for Template Name.	Not supported

   • Application: select the application that needs to send the SMS. For more information, please see Creating Application.

3. Click OK.

4. Check the number of recipients, indicate your consent to the prompt about fees, and click Send.
   You can view the task status in the “Sending Records” list. The status Sent indicates the task has been completed.

Step 5. View SMS delivery result

You can view the SMS delivery result in the following ways:

• On the Global SMS > Bulk SMS page, click Details & Receipt Analytics on the line of the target task to view its detailed record and receipt analysis.
• Select Business Statistics > Global SMS and you can filter and view the statistics and relevant analysis of Global SMS by application, signature, body template, and time.