Objective   

Prerequisites

1. Account SID: Your unique account identifier. Example: AC822c6980a322c745ac883f86617a6704
2. Auth token: Your secret API authentication token. Example: 754811b836e773ecba554ffcbf11cd72
3. Twilio phone number: A verified sender phone number that Twilio uses to dispatch SMS messages. This number must be purchased and configured within your Twilio account.

Note: If you are using a Twilio trial account, you can only send SMS messages to phone numbers that you have verified within your Twilio account. Licensed accounts can send messages to any valid mobile number globally, subject to Twilio's pricing and regulations. 

Important note for authentication:

To securely authenticate with Twilio, you need to combine your ACCOUNT SID and AUTH TOKEN into a single string and then encode it using Base64.

Format: ACCOUNT_SID:AUTH_TOKEN

Example input: AC822c6980a322c745ac883f86617a6704:754811b836e773ecba554ffcbf11cd72

You can use any standard Base64 encoding tool or command-line utility to perform this conversion. The resulting encoded string will be used in the Authorization HTTP header during the configuration process.

Steps to configure Twilio SMS in ADSelfService Plus 

1. Log in to the ADSelfService Plus admin console.
2. Navigate to Admin > Product Settings > Mail/SMS Settings > SMS Settings.
3. Fill in the following configuration details:
   
1. SMS Provider: Select Custom.
   
2. Send SMS Via: Select HTTP.
   
3. HTTP Method: Select POST.
   
4. HTTP URL: https://api.twilio.com/2010-04-01/Accounts/ACCOUNT_SID/Messages

• Replace ACCOUNT_SID with your actual Twilio Account SID. Example: https://api.twilio.com/2010-04-01/Accounts/AC822c6980a322c745ac883f86617a6704/Messages

• HTTP Parameters:
  Body=%message%&To=%mobNo%&From=+FromNumber

• Replace +FromNumber with the actual sender number in Twilio (e.g., +15017122661). Ensure you include the + prefix.

• %message% and %mobNo% are placeholders that ADSelfService Plus will dynamically replace with the message content and recipient's mobile number, respectively.

• Define the expected responses from the provider:

• Success Response: <sid> (Twilio returns a unique SID (message SID) upon successful message submission.)
• Failure Response: <Code> (Twilio typically includes an error code in its response if a message fails.)

• HTTP Request Headers:

• Authorization: Basic <Base64-encoded ACCOUNT SID:AUTH TOKEN>

• Replace <Base64-encoded ACCOUNT SID:AUTH TOKEN> with the Base64-encoded string you generated earlier.

• Content-Type: application/x-www-form-urlencoded

4. Click Save Settings to apply the configuration.
5. Use the Send Test SMS link within ADSelfService Plus to confirm successful SMS delivery.

How to reach support