SMS Server Settings

ADSelfService Plus can send SMS notifications using:

Configuring ADSelfService Plus to use a GSM Modem

GSM modem prerequisites:

Follow these steps :

  1. Connect the GSM modem to the serial communication port of the server.
  2. Go to Admin → Product Settings → Mail / SMS Settings.
  3. Click the SMS Settings tab. From the SMS Provider drop-down, select GSM modem.
  4. Enter the port number the modem is connected to in Modem Port Number.
  5. Click Advanced Settings.
  6. Provide the Modem Port Speed.
  7. Specify the Message Centre Number and SIM PIN Number.

gsmmodem

Note :If the content exceeds 160 characters, it will be sent as multiple messages. To find the modem port, go to My Computer →  Manage →  Device Manager →  Modems →  (select your modem) →  Properties →  Modem

Configuring ADSelfService Plus to use Clickatell

Prerequisites:

Follow these steps :

  1. Log in to ADSelfService Plus with admin credentials.
  2. Go to Admin →  Product Settings →  Mail / SMS Settings.
  3. Click the SMS Settings tab. From the SMS Provider drop-down, select Clickatell.
  4. Select the Please notify me when my credit balance reaches checkbox and specify the number of credits
  5. Enter the email address to which the notification alert must be sent. 
  6. Click Save.

clicktell

Buying SMS credits

View our pricing details and select a plan based on your requirements. If your organization needs more than 100,000 credits, we can offer you a personalized quote. To install the SMS add-on pack, follow the steps below.

Steps to install the Clickatell SMS add-on:

After the purchase is successful, our support team will send you two XML files: AdventNetLicense.xml and SMSGateway.xml.

  1. Click the License link at the top-right corner of the webpage
  2. In the window that opens, click Choose File and upload the AdventNetLicense.xml file, which contains details on the SMS credit limit.
  3. You will now be asked to provide the API settings. Upload the SMSGateway.xml file you received.
Note:
  • Make sure that users’ mobile numbers are in the international format, with the country code followed by the number. The entered mobile numbers should not start with a zero or include special characters such as "+" or spaces (e.g. “111234123456”). 
  • Users on the Do Not Disturb list will not receive SMS alerts.
  • A message of up to 70 characters uses one credit.

  • Configuring ADSelfService Plus to use a custom SMS gateway

    ADSelfService Plus can be integrated with custom SMS providers as well. 

    HTTP-based custom SMS gateway:

    Follow these steps for ADSelfService Plus to use an HTTP-based custom SMS gateway:

    1. Log in to ADSelfService Plus with admin credentials.
    2. Go to Admin → Product Settings → Mail / SMS Settings
    3. Click SMS Settings tab. From the SMS Provider drop-down, select Custom.
    4. Select HTTP from the Send SMS via drop down box.
    5. Select either of the available HTTP methods. That is, Post or Get.
    6. Enter the HTTTP URL of your SMS gateway provider.
    7. Specify the HTTP Parameters specific to your SMS provider, the user's mobile number, and the message to be sent.
    Note:
  • Separate the HTTP parameters with an ampersand (&) sign.

    Example format: username=xxx&password=yyy&mobileNumber=%mobNo%&message=%message%&messageId=%uniqueId%&timeStamp=%currentTime% &expiryTime=%expiryTime%.
    1. xxx = API authentication username.
    2. yyy = API authentication password.
    3. %mobNo% = this macro denotes the user's mobile number.
    4. %message% = this macro denotes the SMS message content.
    5. %uniqueId% = to send a random integer as a unique ID for each message request.
    6. %currentTime% = to send the current timestamp of the message request.
    7. %expiryTime% = to specify the time at which the message request expires.
  • More HTTP Parameters - If you SMS provider requires more parameters like unicode and apiID, include them as well using the '&' sign.

  • smsgateway

    1. Specify the Success and Failure response from the provider.
    2. Enter the HTTP Request Headers specific to your SMS provider.
    3. If the SMS provider expects unicoded or encoded messages, select Convert Message into Unicode or Encode message  respectively.
    4. Click Save Settings.

    SMTP-based custom SMS provider

    Follow these steps for ADSelfService Plus to use an SMTP-based custom SMS gateway:

    1. Log in to ADSelfService Plus with admin credentials.
    2. Go to Admin → Product Settings → Mail / SMS Settings
    3. Click SMS Settings tab. From the SMS Provider drop-down, select Custom.
    4. Select SMTP from the Send SMS via drop down box.

    smtpsetting

    1. Enter the email address the SMS will be sent in the From Address field.
    2. Specify the mobile number macro (%mobNo) followed by the email address of the SMS provider in the To Address field.
      For example, %mobNo%@clickatell.com. For more details, contact your SMS provider.
    3. Provide the required Subject. Generally, it is either the mobile number or the message, depending on your SMS provider.
    4. Specify the Content to be sent
    5. Click SMTP Server Settings.
    6. Enter the name or the IP address of the SMTP Server, and the SMTP Server port
    7. Provide the Username and Password with required permissions on the SMTP server.
    8. Select Connection Security from the drop-down, and click Save Settings
    Note: If the SMTP server is not configured, the mail server configured under the Mail Settings tab will be used.

    SMPP-based custom SMS provider

    Follow these steps for ADSelfService Plus to use an SMPP-based custom SMS gateway:

    1. Log in to ADSelfService Plus with admin credentials.
    2. Go to Admin → Product Settings → Mail / SMS Settings
    3. Click SMS Settings tab. From the SMS Provider drop-down, select Custom.
    4. Select SMPP from the Send SMS via drop down box.
    5. Enter the SMPP Server Name and SMPP Server Port number
    6. Specify the User Name and  Password with required permissions on the SMPP server. Click  Advanced Settings.

    smppsetting

    1. Enter the ESME System Type. From the ESME Bind Type drop-down, select Blind Transmitter or Transceiver.
    2. Specify the SMPP Time-Out  and  SMPP Source Address.  
    3. Select the Source Address’ TON,Source Address’ NPI, Destination Address’ TON, and  Destination Address’ NPI from the respective drop-downs.
    4. Click Save Settings.
    Note:
  • TON: Type of number
  • NPI: Numeric plan indicator
  • Copyright © 2023, ZOHO Corp. All Rights Reserved.