1. Using and Administering Recruiting Booster
  2. Set Up Two-Way Email Communications

Set Up Two-Way Email Communications

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

Before you start

Enable Vanity Email

  • Vanity Email is a pre-requisite for enabling two-way communication. Along with Vanity Email, you must also set up the No Reply Email, which will be used to send Job Alerts, Campaign Emails, and Candidate Verification Emails (with PIN).
  • We use a dedicated vanity email box to route all the messages from and to candidates. This email box will increase in size over time. If you want to delete emails after they're read, use the Delete read email messages option in the Email Messaging Provider setting.

Here's what to do

  1. Create an Email Messaging Provider
  2. Enable Two-Way Communication for Email
  3. Create the Profile Option to Read Email Messages from a Given Start Date

Create an Email Messaging Provider

You need to create an email messaging provider and activate it.

  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 Email Communications section, click Add.
  3. Enter a name and description.
    The user name of the active email messaging provider must be the same as the vanity email.
  4. If you want to delete emails after they're read, select the Delete read email messages option.
  5. Select an authentication type:
    • Basic Authentication
    • OAuth
  6. Based on the authentication type you selected, enter the required info:
    • Basic Authentication: Capture the details from your email service provider: IMAP Server, IMAP Port, User Name, Password. Note: If you're an Office 365 user, use OAuth authentication. Basic authentication for Office 365 is deprecated.
    • OAuth: Email Provider, IMAP Server, IMAP Port, Grant Type, Scope, Tenant ID, Authentication URL, Client ID, Client Secret, User Name. To use the two-way email messaging capabilities with an Office 365 mailbox, you need to register an application in Azure AD and set up a service principal in Exchange to enable the application to access Exchange mailboxes via client credentials flow with the IMAP protocol. For details, refer to the technical brief Set Up OAuth for Office 365 Users (ID 2936718.1) available on My Oracle Support.
  7. Click Check Connection to make sure that the configuration is properly done.
  8. Click Save and Close.
  9. On the Recruiting Messaging Configuration page, in the Email Messaging Providers list, locate the provider you added and set it to Active.
    Only one email messaging provider can be Active at a time.

Related Topics

Enable Two-Way Communication for Email

You enable two-way communication for email and decide if you want to enable it for external candidates, internal candidates, or both.

  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, select these options:
    • Enable Two-Way Email Communications with External Candidates if you want to enable two-way messaging with external candidates.
    • Enable Two-Way Email Communications with Internal Candidates if you want to enable two-way messaging with internal candidates.

Create the Profile Option to Read Email Messages from a Given Start Date

You need to create a profile option called IRC_2_WAY_EMAIL_LAST_SYNC_TIME to read email messages from a given start date. It represents the last time the email messages are read.

  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 Profile Options.
  4. Click the task name.
  5. On the Manage Profile Options page, click the Create icon.
  6. On the Create Profile Option page, create the profile option by entering these values:
    • Profile Option Code: IRC_2_WAY_EMAIL_LAST_SYNC_TIME
    • Profile Display Name: 2 way Email Last Sync Time
    • Application: Recruiting
    • Module: Recruiting Common
    • Description: Define last sync time for two-way email communication feature.
    • Start Date: Today's date
  7. Click Save and Close.
  8. You're back on the Manage Profile Options page and the profile option IRC_2_WAY_EMAIL_LAST_SYNC_TIME is displayed. You need to enable the profile option at the Site level.
  9. On the Manage Profile Options page, go to the Profile Option Levels section.
  10. Set the profile option to be enabled and updatable at the Site level.
  11. Click Save and Close.
  12. You need to set profile value for the profile option IRC_2_WAY_EMAIL_LAST_SYNC_TIME to define from when the email messages are to be read.
  13. In the Setup and Maintenance work area, click the Tasks icon.
  14. Click Search.
  15. Click the Search icon.
  16. On the Search page, search for the task Manage Administrator Profile Values.
  17. Click the task name.
  18. On the Manage Administrator Profile Values page, search for the profile option code IRC_2_WAY_EMAIL_LAST_SYNC_TIME.
  19. Set the profile value to Current date - 1 using the UTC time in standard ISO 8601 format: YYYY-MM-DD HH:MM:SS.
  20. Click Save and Close.