Updated on 2024-04-23 GMT+08:00

SMS

The SMS connector is used to interconnect with Huawei Cloud SMS service to send SMS messages.

Prerequisites

SMS is enabled.

Creating an SMS Connection

  1. Log in to the new ROMA Connect console.
  2. In the navigation pane on the left, choose Connector. On the page displayed, click New Connection.
  3. Select the SMS connector.
  4. In the dialog box displayed, configure the connector and click OK.

    Parameter

    Description

    Name

    Enter the connector instance name.

    App Key

    Access key. When you create a Message&SMS application, the platform automatically generates the APP_Key and APP_Secret, which are used for authentication when the SMS APIs are called.

    App Secret

    Access key. When you create a Message&SMS application, the platform automatically generates the APP_Key and APP_Secret, which are used for authentication when the SMS APIs are called.

    Description

    Enter the description of the connector to identify it.

Action

Sending SMSs

Configuration Parameters

Parameter

Description

Region

Region where the SMS service resides.

Project

Project to which the SMS service belongs.

Channel ID

Enter the channel number for sending SMSs.

  • For Chinese mainland SMSs, set this parameter to the channel number allocated by the platform to the SMS signature, which you get when applying for the SMS signature. Example channel number: csms100000001. The signature type corresponding to the channel number must match the template type corresponding to the template ID.
  • For international SMSs, set this parameter to the channel number allocated when the SMS application is created. Example: isms100000001. View the signature channel ID on the Message & SMS console by choosing Chinese Mainland SMS > Signature Management. The signature corresponds to the template. You can view the template's signature at Chinese Mainland SMS > Template Management.

Send With

Select the SMS sending mode. You can select Custom content or Template.

Message Content

Required when Send With is set to Custom content.

Enter the SMS content of maximum 2000 bytes. Chinese mainland SMSs must contain an SMS signature. Example: [SMS notification] Welcome to the SMS service.

Template ID

Required when Send With is set to Template.

Enter the unique ID obtained when applying for an SMS template. Template ID must be used together with Template Variable Values.

Template Variable Values

Required when Send With is set to Template.

Enter the variable value in the SMS template. The number and length of variables must be consistent with those defined in the template specified by Template ID.

For example, if the template specified by Template ID contains two variables with lengths of 5 and 6, set two variables with lengths not exceeding 5 and 6, respectively. For template content You have ${1} parcel to be claimed at ${2}, this parameter can be set to '["3", "Park Main Entrance"]'.

Recipient Number

Enter the number of the SMS message recipient.

  • Chinese mainland SMSs: If the recipient number is a Chinese mainland mobile number, +86 is default but optional. Other numbers must have the standard format of +{country code}{region code}{recipient number}. Examples: +861234***5555, +86123****6666.
  • International SMSs: Recipient numbers must be in the standard format of +{country code}{region code}{recipient number}. Examples: +2412****00 (Gabon), +3366****212 (France). Separate multiple recipient numbers with commas (,). Maximum number length: 21 digits. Maximum number quantity: 500 numbers.

Callback URL

Enter the callback address for receiving the SMS status report, for example, http://xx.com/receiveSMSReport.

Extended Parameter

Enter the extended parameter to be returned in the status report. Braces ({}) are not allowed.

Signature Name

The signature name must be approved and consistent with the template type.

This parameter is valid and required when a general template is specified. This is the signature before the SMS content in the general template. This parameter is not required for international SMSs.