Set Up Two-Way SMS Communications

You set up two-way SMS messaging so that recruiters and the hiring team can have conversations with candidates using SMS.

Before you start

Two-way communication with SMS currently works with Twilio and Syniverse providers only. Make sure that the proper provider setup is done before you enable two-way communication. For two-way SMS communication to work correctly, you need to have a long code number that supports accepting incoming messages.

Here's what to do

  1. Create an SMS Messaging Provider
  2. Enable Two-Way Communications on Active SMS Messaging Provider
  3. Configure the Profile Option to Read SMS from a Given Start Date

Create an SMS Messaging Provider

You need to create and activate a messaging provider that will be used for communicating with candidates using SMS.

Before you start

Two-way communication with SMS currently works with Twilio and Syniverse providers only. Make sure that the proper provider setup is done before you enable two-way communication.

Here's what to do

  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. On the Recruiting Messaging Configuration page, in the SMS Communications section, click Add.
  3. Enter a name and description.
  4. Select a provider.
  5. Based on the provider you selected, enter info in the Request Details, Authentication, Headers, and Body sections. For more information, see the document Examples of Adding an SMS Provider on My Oracle Support (ID 2657006.1).
    Note: For processing outbound messages, the SMS messaging provider's API is expected to return the response in JSON format. To ensure smooth processing of these messages, we recommend that you include the Accept header in the Headers section and specify its value as application/json.
  6. Click Test Outbound Message to send a test message and make sure that the configuration is properly done.
  7. Click Save and Close.
  8. On the SMS Messaging Providers list, set the provider you added to Active.

Enable Two-Way Communications on Active SMS Messaging Provider

You need to enable the two-way SMS communications feature.

Before you start

At least one SMS provider needs to be Active to have SMS Communications with the candidate. The phone number that you use for two-way communications must support incoming SMS messages.

Here's what to do

  1. On the Recruiting Messaging Configuration page, select the option Enable SMS Communications.
  2. Open the new provider you created, and select the option Enable Two-Way SMS Communications.
  3. Click Test Inbound Message to make sure that the configuration is properly done.
  4. Click Save and Close.

Configure the Profile Option to Read SMS from a Given Start Date

You can create a profile option called IRC_2_WAY_SMS_LAST_SYNC_TIME to read SMS messages from a given start date. It represents the last time the SMS messages are read. This set up step is optional.

  1. In the Setup and Maintenance work area, click the Tasks icon.
  2. Click Search.
  3. On the Search page, search for the task Manage Administrator Profile Values.
  4. Click the task name.
  5. On the Manage Administrator Profile Values page, search for the profile option code IRC_2_WAY_SMS_LAST_SYNC_TIME.
  6. Set the profile value using the UTC time in standard ISO 8601 format: YYYY-MM-DD HH:MM:SS.
  7. Click Save and Close.