SMS server settings

    You can configure ADManager Plus to use your own global system for mobile communication (GSM) modem for sending SMS messages, or you can configure your own custom SMS gateway.

    GSM modem configuration

    1. Log in to ADManager Plus and select the Admin tab.
    2. Navigate to General Settings > Server Settings > Email Server/SMS Gateway.
    3. Click SMS Gateway to configure the SMS gateway settings.
    4. Select GSMModem from the SMS Provider drop-down.
    5. Specify the modem's port number in the Modem Port Number field. Refer to the "Configuring the modem port and modem port speed" section below for more details.
    6. Click Advanced to configure other fields, like the Modem Port Speed, Message Center Number, and SIM PIN.
    7. Click Save Changes.

    Configuring the modem port and modem port speed

    1. Connect your GSM modem to the serial port of your machine using a serial cable.
    2. In ADManager Plus, in the Modem Port Number field, enter the port number to which the modem is connected. The port number for Windows devices will be COMX (e.g., COM7 or COM8).

    Requirements for establishing the SMS server connection

    Fulfilling these criteria allows ADManager Plus to support your modem or mobile phone.

    • The modem or mobile phone must have GSM functionality with a provision to insert the SIM card.
    • The modem or mobile phone must support 7-bit (GSM default alphabet), 8-bit, and Unicode (UCS-2) encoding.

    Configuring a custom SMS provider

    You can configure your own custom SMS gateway if the gateway is HTTP- or SMTP-based.

    Steps to configure an HTTP-based SMS provider

    1. Navigate to the SMS Gateway tab.
    2. Select Custom from the SMS Provider drop-down.
    3. Select HTTP or HTTPS from the Send SMS via drop-down.
    4. Select the HTTP Method that you would like to use to send SMS messages: Get or Post.
    5. Enter the HTTP URL of your SMS gateway provider.
    6. Enter the HTTP Parameters specific to your SMS provider. Depending on the SMS provider, the formats (plaintext, JSON, or XML), the parameters needed, and their values can vary. Refer to the SMS provider's documentation and add the appropriate values and formats.
      Notes:
      • HTTP parameters can be added in plaintext, JSON, or XML format. Here are a few samples:
        • Plaintext format

          userName=xxx&password=yyy&mobileNumber=%mobNo%&message=%message%&date=%timestamp%&SignatureNonce=%nonce%.

        • JSON format

          {"apikey":"123456789","message":"%message%","mobile":"%mobNo%","SignatureNonce":"%nonce%"}

        • XML format
          <SMS>
              <authentication>
                  <username>test</username>
                  <password>test</password>
              </authentication>
              <message>
                  <sender>Testing</sender>
                  <text>%message%</text>
                  <recipients>
                      <mobile>%mobNo%</mobile>
                  </recipients>
              </message>
          </SMS>    
          															
        • Supported parameters
          Parameter Type Detail
          %mobNo% Macro The user's mobile number
          %message% Macro This prevents replay attacks
          %timestamp% Macro The request time
      • Custom parameters can be created as required.
        • Sample custom parameter 1

          "Content- MD5":"MD5({"ecName":"testing","apId":"abcd","mobiles":"%mobNo%","params":"%message%","sign":"123abc"})"

          In the above JSON format example, the MD5 algorithm is used for computing the hash value of the string {"ecName":"testing","apId":"abcd","mobiles":"%mobNo%","params":"%message%","sign":"123abc"}. The result is later assigned to the Content-MD5 parameter.

        • Sample custom parameter 2

          Signature=HMAC-SHA1(AccessKeyId=LTAI4G8x27gm&Action=SendSms&Message=%message%&PhoneNumbers=%mobNo%&RegionId=ap-southeast-1&SignatureMethod=HMAC-SHA1&SignatureNonce=%nonce%&Timestamp=%timestamp%&secretKeyForHash=YpyFfCrkpJtBJchdp59)

          In the above example, we use the HMAC-SHA1 algorithm to construct a hash value with the secret key YpyFfCrkpJtBJchdp59 for the string AccessKeyId=LTAI4G8x27gm&Action=SendSms&Message=%message%&PhoneNumbers=%mobNo%&RegionId=ap-southeast-1&SignatureMethod=HMAC-SHA1&SignatureNonce=%nonce%&Timestamp=%timestamp%.

    7. In the Response from Provider field, specify the response that you would like to receive from your provider to determine if the SMS message has been sent successfully or not.
    8. Click Advanced to configure the following:
      • Enter the HTTP Request Headers specific to your SMS provider.
      • Check Convert Message into Unicode to send SMS messages in Unicode format.
      • Check Encode message to encode the parameters.
      • Check Allow new lines in message to include line breaks in messages.
      • Select the appropriate encoding method, Url Encode or Base 64, from the Encode Method drop-down.
      • Select the Encode Type:
        • Message Only: Select this if you would like to encode only the message content.
        • Values Only: Select this if you would like to encode only the values mentioned in the URL parameters.
        • All: Select this if you would like to encode all the keys and values.
    9. Click Save Changes.

    Steps to configure an SMTP-based SMS provider

    1. On the SMS Gateway tab, select Custom from the SMS Provider drop-down.
    2. Select SMTP from the Send SMS via drop-down.
    3. In the From Address field, enter the email address from which you want to send the SMS message (e.g., noreply@admanagerplus.com).
    4. In the To Address field, enter the %mobNo% macro followed by the email address of your provider. Refer to your SMS provider to know the exact values (e.g., %mobNo%@clickatell.com).
    5. Enter the details required in the Subject field. Generally, it would be either a mobile number or a message, depending upon your SMS provider.
    6. Enter the details required in the Content field. This also depends on your SMS provider. Please refer to your SMS provider to know the exact values.
    7. Click SMTP Server Settings to configure your SMTP server:
      • SMTP Server: Enter the name or IP address of the server.
      • SMTP Port: Enter the port number of your SMTP server.
      • Username: Enter the username of the SMTP server.
      • Password: Enter the password of the SMTP server.
      • Connection Security: Select if you would like to make an SSL or TLS connection.
    8. Click Save Changes.
    Note: If you do not configure the SMTP server settings, then the email server configured under the Email Server tab will be used.

    Don't see what you're looking for?

    •  

      Visit our community

      Post your questions in the forum.

       
    •  

      Request additional resources

      Send us your requirements.

       
    •  

      Need implementation assistance?

      Try onboarding