Example of Adding an SMS Provider

This example describes how you can add Twilio as an SMS provider to let candidates receive SMS
communication.

1. In the Setup and Maintenance work area, go to:

Offering: Recruiting and Candidate Experience
Functional Area: Recruiting and Candidate Experience Management
Task: Recruiting Messaging Configuration
2. In the Recruiting Messaging Configuration page, click Add.
3. Enter a name and description.
4. Select SMS as a channel type and Twilio as the provider.
5. Set the message length limit. The Body parameter includes the full text of the message you want to send. It's
limited to 1600 characters. Based on your business needs, you can set the message length limit to 1600
characters or less. If the body of your message is more than 160 GSM-7 characters (or 70 UCS-2 characters),
Twilio will send the message as a segmented SMS.
6. Enter info under the Request Details, Authentication, Headers, and Body sections.
7. Click Send Test Message to send a test message and make sure that the configuration is properly done.
8. Activate the messaging provider.
9. Select the Enable SMS Communications option. Candidates will be able to login using a phone number.
10. Click Save and Close.

Request Details
Section

URL
https://api.twilio.com/2010-04-
01/Accounts/<AccountSID>/Messages.json

Method
Post

HTTP requests to the REST API are protected with HTTP basic authentication. You will use your
Twilio Account SID as the user name and your Auth Token as the password for HTTP basic
authentication with Twilio.

Authentication Section

Authentication Type
Basic Auth
User Name <AccountSID>

Password
<AuthToken>

Headers Section

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

Body Section

Body Type
x-www-form-urlencoded

To: The destination phone number for your SMS message. This will
be parameterized and resolved when the message is being sent. ${RECIPIENT_PHONE_NUMBER}

From: The Twilio phone number, short code, or Messaging Service

that sends this message. This must be a Twilio phone number that 1234567890
you own.

Body: The full text of the message you want to send, limited to
1600 characters. If the body of your message is more than 160 ${MESSAGE_CONTENT}
GSM-7 characters (or 70 UCS-2 characters), Twilio will send the
message as a segmented SMS.

Index Entries This Topic Will Generate

languages