Microsoft Graph API Integration for Two-Way Email Communication

You can now read candidate emails sent to a vanity mailbox set up on Office 365 using Microsoft Graph API integration. This support is provided through open authentication using a client secret or client certificate-based credential.

This is an upgrade over the previous releases where email support was provided only using IMAP with either open authentication or basic authentication using a client secret or application password.

To be able to read candidate emails using Microsoft Graph API integration, you first need to set up and configure Microsoft Azure Cloud and a vanity mailbox, as explained in the Steps to Enable section. 

Next, you need to set up Microsoft Graph API in Oracle Recruiting using these two tasks:

  • Enterprise Recruiting and Candidate Experience Information – here, you’ll configure Microsoft Graph API. This adds Graph API as an email provider in Recruiting.
  • Recruiting Messaging Configuration – here, you’ll set Microsoft Graph API as the active email messaging provider.

NOTE: With this release, the vanity email configuration has been moved from the Enterprise Recruiting and Candidate Experience Information task to the Recruiting Messaging Configuration task.

This enhancement provides a unified approach for scheduling interviews and candidate communications, while also providing administrators with a simple and robust solution to integrate Microsoft 365 with Oracle Recruiting Cloud.

Steps to Enable

To use this feature, you must complete these prerequisite steps on Microsoft Azure Cloud and Oracle Recruiting.

Microsoft Azure Cloud

  1. Set up a Microsoft Azure application.
  2. Set up a vanity email with a mailbox on Microsoft Azure.
  3. Set up SPF or DKIM or DMARC on the vanity email domain.
  4. Register the vanity email domain on Google Postmaster and Yahoo CFL (Consumer Feedback Loop).
  5. Configure Graph API in the Microsoft Azure application and update its access policy to prevent the application from accessing all mailboxes or user profiles

For detailed instructions on configuring these prerequisites, see the technical brief Set Up Microsoft 365 Integration for Interview Scheduling and Emails (Doc ID 2664168.1) on My Oracle Support.

Oracle Recruiting

  1. Enable two-way email communications.
  2. Configure the vanity email.
  3. Enable the profile option ORA_IRC_2_WAY_SMS_LAST_SYNC_TIME. With this upgrade, if you haven’t set a value for this profile option, it’ll be set to a default value of 7 days before the current date.
  4. Configure Microsoft Graph API integration and set it as the active email messaging provider.

Configure Microsoft Graph API Integration

  1. In the Setup and Maintenance work area, go to:
  • Offering: Recruiting and Candidate Experience
  • Functional Area: Recruiting and Candidate Experience Management
  • Task: Enterprise Recruiting and Candidate Experience Information
  1. Expand the Microsoft Graph Integration section and click Edit.
  2. Select Enable Email Integration.
  3. If you want to use the same configuration information as Calendar integration, select the check box for it and click Save.
  4. If you want to use a different configuration, complete these fields:
  • Default User Identifier or Email: This must be the same as the vanity email. If you enter the default user identifier, it should be associated with the vanity email.
  • Application ID: Enter the client ID used in Azure.
  • Tenant ID: Enter the unique identifier used for the Azure Active Directory instance in your organization.
  • Application Authentication Type: If you select Client Secret, provide the application password. If you select Certificate, upload the certificate file and provide the certificate password.

Configuring Microsoft Graph API

Configuring Microsoft Graph API

  1. Select the Delete read emails check box if you want the read emails to be automatically deleted. This ensures that the inbox isn’t full and all incoming emails are received.
  2. Click Validate Integration to ensure Graph API is configured correctly.
  3. Click Save.

Activate Microsoft Graph API as the Email Messaging Provider

  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
  1. Expand the Email Communications section.
  2. You’ll see Microsoft Graph Integration added in the Email Messaging Providers section. From the Actions menu (shown as three dots) next to it, select Activate.

Activate the Microsoft Graph Integration Email Provider

Activate the Microsoft Graph Integration Email Provider

Note that you can’t add any other email provider with the same name as Microsoft Graph Integration.

Key Resources

For more information, see these resources: