Updated on 2024-06-12 GMT+08:00

Configuring the Outgoing SMS Gateway

SMS messages are mainly used to:

  • Receive the mobile phone verification code for login authentication.
  • Reset the password.
  • Receive alarm messages. For details about the alarm scope, see Alarm.

Currently, you can select Built-in or Third-party SMS gateways. If you select Third-party, general SMS Gateway and cloud SMS gateway are available.

  • If you do not need to push system alarms or send and receive SMS messages to mobile numbers outside the Chinese mainland, you can configure the SMS gateway by referring to Built-in SMS gateway.
  • If you need to receive system alarms or send and receive SMS messages to mobile numbers outside the Chinese mainland, configure the SMS gateway by referring to General Third-party SMS Gateway.

This topic describes how to configure an outgoing SMS gateway.

Prerequisites

You have the management permissions for the System module.

Built-in SMS gateway

  1. Log in to the CBH system.
  2. Choose System > Sysconfig > Outgoing.
  3. In the SMS API area, click Edit.
  4. Select Built-in and enter a mobile number to verify the connectivity of the built-in SMS gateway.
  5. Click OK. You can then view SMS gateway configuration on the Outgoing tab.

    • The built-in SMS gateway cannot push CBH system alarm notifications.
    • The built-in SMS gateway cannot send SMS messages to mobile numbers outside the Chinese mainland. If you need to receive SMS messages from mobile numbers outside the Chinese mainland, configure an SMS gateway outside the Chinese mainland.

General Third-party SMS Gateway

  1. Log in to the CBH system.
  2. Choose System > Sysconfig > Outgoing.
  3. In the SMS API area, click Edit.
  4. Select Third-party and then select SMS Gateway from the SMS Conf drop-down list.

    In the displayed parameter list, specify other parameters as prompted.

  5. Click OK. You can then view SMS gateway configuration on the Outgoing tab.

    Table 1 SMS API parameters

    Parameter

    Description

    Method

    Request method. The options are POST and GET.

    URL

    URL of SMS API. You can enter a universal URL or a URL containing parameters.

    Do not enter MD5-encrypted URLs.

    HTTP Header

    HTTP request header. Use colons (:) to separate the name and value of the HTTP request header.

    Only HTTP and HTTPS gateways are supported.

    API Params

    API parameters of the SMS gateway. Replace keywords $MOBILE and $TEXT with the phone number and SMS content.

    Encode

    Encode method. You can select UTF-8, Big5, or GB18030.

    Mobile

    Phone number for receiving the SMS messages. Enter an available phone number and verify the SMS message content.