Updated on 2024-03-11 GMT+08:00

Chinese Mainland SMS Application

Overview

SMS applications carry out functions for the Huawei Cloud Message & SMS service. After you added an application, the system automatically allocates a unique application key and application secret and provides you with an application access address. The application key and application secret uniquely identify a user. They are carried for authentication and authorization during SMS API calling.

Notes

  • You can create an application only after your account is bound to a credit card. No application can be added if your Huawei Cloud account balance is insufficient. In this case, top up your account by following instructions provided in Topping Up an Account. If you have topped up your account and the application cannot be added, log out and log in to the system again.
  • International SMS applications are different from Chinese mainland SMS applications. You need to add each type of applications separately. A maximum of two international SMS applications can be added. To add more applications, submit a service ticket.
  • A created application cannot be deleted. You can modify the application name, uplink SMS destination, SMS status report destination, and IP whitelist, and update application secrets as needed.
  • For details about the browsers supported by the Message & SMS console, see Which Browsers Are Supported?

Creating an Application

  1. Log in to the Message & SMS console. In the navigation pane, choose Chinese Mainland SMS > Application Management.
  2. Click Add Application in the upper right corner. For details about how to create an application, see Table 1.

    Table 1 Adding an application

    Parameter

    Description

    Application Name

    Customize a name. The value can contain a maximum of 30 characters, including letters, digits, and special characters (!@$%^-_=+[{}]:,./?~#*;|). The application name is used only for internal display and is irrelevant to the external API calls.

    Uplink SMS Destination

    Address used to receive SMS replies from recipients. Message & SMS uses this address to notify the platform user of SMS replies. If you want to receive and process SMS replies, configure a public network URL (domain name or IP address:Port number) that can receive HTTP requests. A domain name is recommended. If SMS replies are not required, you do not need to specify this parameter.

    SMS status reports Destination

    If the service party needs to receive status reports in batches, do not carry the callback field in the HTTP message delivery request, and configure a public network URL that can receive HTTP requests. The URL can be a domain name (recommended) or IP address:Port number. If this function is not required, you do not need to set this item.

    IP Whitelist

    Set this parameter based on the service requirements. You can configure up to 10 IP addresses for an application. Use commas (,) to separate IP addresses. It takes about 10 to 15 minutes for the IP whitelist to take effect. After the IP whitelist is successfully configured, the connection to the Message & SMS can be set up.

    Uplink SMS Send Time

    UTC time when the platform receives an uplink SMS from a recipient. This parameter is available only when Uplink SMS Destination is specified. If you select Required, add the createTime parameter when calling the uplink SMS receiving API. Message & SMS will notify the platform user of the time when a recipient replies to the SMS based on the address for receiving uplink SMSs.

    Test Signature and Template

    If you select Required, the system automatically creates an associated test signature and template for quick commissioning.

  3. Click OK.

Managing an Application

After an application is created, choose Chinese Mainland SMS > Application Management to view application information.

Table 2 Application information

Parameter

Description

Application Name

Corresponds to Application Name in Table 1.

Application Primary Key ID

It is unique and is used to obtain and modify the application.

Application Key

Uniquely identifies a user. It is carried for authentication and authorization during SMS API calling. For details, see Development Preparation (Chinese Mainland SMS).

Application Secret

Uniquely identifies a user. It is carried for authentication and authorization during SMS API calling. For details, see Development Preparation (Chinese Mainland SMS).

To view or update an application secret, enter the verification code and click OK.

CAUTION:

If you sent SMSs before updating an application secret, wait for 15 minutes for the new application secret to take effect. If you did not send SMSs before updating an application secret, the new application secret takes effect immediately.

Application Access Address

The application access address and access URI form an SMS API request address, which is used to call Message & SMS APIs.

Uplink SMS Destination

Corresponds to Uplink SMS Destination in Table 1.

Uplink SMS Send Time

Corresponds to Uplink SMS Send Time in Table 1.

Status

  • Normal: The application is successfully added and can be used properly.
  • Paused: Service requests cannot be initiated. If the SMS content sent violates service rules or you apply to unsubscribe from the Message & SMS service, the operation manager will suspend your SMS application.

Created

Specifies the time when the application was created.

Operation

  • Applications can be modified, paused, and resumed.
  • The reply time for receiving uplink SMS responses cannot be changed.
  • For a paused application, the following configuration items cannot be changed: Uplink SMS Destination, IP Whitelist, and Uplink SMS Send Time.
  • Currently, SMS applications cannot be deleted. For details, see Can I Delete an SMS Application.