Dice integration

Greenhouse Recruiting's integration with Dice.com allows recruiters to effortlessly prospect relevant candidates for their tech-focused jobs. The integration automatically determines the best candidate matches based on your job description and adds them as a prospect to your job order and Greenhouse CRM. Recruiters can tailor the prospect results by adjusting the employment type and required skills fields in their job details. Maximize your sourcing activities and breakthrough to proactive sourcing with Dice IntelliSearch for Greenhouse Recruiting.

Create a Harvest API key for the Dice integration

To configure the Greenhouse Recruiting / Dice integration, you'll need to create a Harvest API key.

Follow the steps in this article to create the key, and verify that the credentials and permissions below are selected when configuring the Dice integration.

Credentials

In the Create New Credential box, make the following selections:

• API type: Harvest
• Partner: Dice
• Description: Dice Harvest API key

Permissions

Verify that the following permissions are selected for the Dice integration:

Applications

• GET: Retrieve applications
• GET: List applications
• PATCH: Update applications

Candidates

• GET: List candidates
• POST: Add candidate
• PATCH: Edit candidate
• POST: Add note
• POST: Add attachment
• POST: Add application
• POST: Add employment
• POST: Add prospect

Jobs

• GET: Retrieve job
• PATCH: Update job

Job posts

• GET: List jobs posts
• GET: Retrieve job posts for job
• GET: List job posts for job

Sources

• GET: List sources

Prospect pool

• GET: List prospect pools

When finished, click Save.

Copy your Harvest API key in a secure location so you can provide it to your Dice customer success representative.

Create custom fields for the Dice integration

The Dice integration utilizes the following custom job fields on your job in order to intelligently source prospective candidates:

• Dice IntelliSearch

• Dice IntelliSearch: Required Skills & Keywords

• Employment Type

To enable these fields, click the Configure icon on your navigation bar, then click Custom Options on the left.

Click Jobs under the Company Custom Fields Section.

Click Add Field to create a new custom job field.

The following custom job fields will need to be configured in Greenhouse Recruiting:

1. Dice IntelliSearch

Create a custom job field for Dice IntelliSearch. Enter the following to create the field:

• Field name: Dice IntelliSearch
• Description: Allows Dice IntelliSearch to automatically prospect the most relevant candidates from Dice.com directly to your Greenhouse Recruiting job.
• Field type: Yes / No

When finished, click Save.

Greenhouse Recruiting will generate an Immutable Field Key at the bottom of the page for for the custom field. Copy the immutable field key to provide to your Dice Customer Success Manager in a later step.

2. Dice IntelliSearch Required Skills & Keywords

Create a custom job field for Dice IntelliSearch Required Skills & Keywords. Enter the following to create the field:

• Field Name: Dice IntelliSearch: Required Skills & Keywords
• Description: A comma-separated list of required keywords for the Dice IntelliSearch. This filters out prospects who don't have all the listed keywords in their profile resume. When specifying variations of skills and keywords, add brackets around them with an "OR" between each word.
• Field type: Short textbox

When finished, click Save.

Greenhouse Recruiting will generate an Immutable Field Key at the bottom of the page for for the custom field. Copy the immutable field key to provide to your Dice Customer Success Manager in a later step.

3. Employment Type (if applicable)

Your organization might already leverage a custom job field called Employment Type in Greenhouse Recruiting that designates the level of employment for your jobs, like full-time or part-time. Your Dice CSM can work with you to map these employment type field values to Dice's employment type filters. You must map your Greenhouse Recruiting employment type field values to Dice employment values and provide the following table to your Dice CSM.

You'll also need to provide the Immutable Field Key for your employment type field to your Dice CSM.

4. Salary (if applicable)

Your organization might already leverage a custom job field called Salary in Greenhouse Recruiting that designates a max salary or salary range. If you'd like the Dice integration to filter out candidates based on a job's salary, provide the Immutable Field Key for this field to your Dice CSM.

Create a custom source for the Dice integration

Prospect applications imported to Greenhouse Recruiting by the Dice integration will need to be attributed to a new custom source.

To create a new custom source, click the Configure icon on your navigation bar, then click Custom Options on the left.

Click Sources.

Click Create New Source, and enter the following details:

• Sourcing strategy: Prospecting
• Name of source: Dice IntelliSearch

Click Create source.

Enable the integration on Dice

Once you've set up the Harvest API keys and custom fields, you'll need to inform your Dice Custom Success Manager. Provide the following information to your Dice CSM:

• Harvest API Key: Please send in a secure manner to your CSM.
• "On-Behalf-Of" user id: The user ID that will be used for the Dice integration. You can create an integration system user (ISU) or use an existing Greenhouse Recruiting user's ID. To find user IDs, click Configure > Users > then click Export to Excel to download the list of your Greenhouse Recruiting users and their IDs.
• Dice IntelliSearch: Immutable field key created in previous step
• Dice IntelliSearch: Required Skills & Keywords: Immutable field key created in previous step
• Employment Type: Immutable field key created in previous step
• Salary: Immutable field key created in previous step
• Greenhouse Employment Type Mapping: Mapping created in previous step
• Source Name: Custom source name created in previous step
• Prospect Pool Name: If you intend to import prospects, the prospect pool.
• Prospect Pool Stage: If you intend to import prospects, the prospect pool stage.

You'll need to create an email distribution list or an email alias for the Dice API User. The email will need to route to an actual person and will be utilized to set and reset the password for your Dice API User. The user email must follow the naming convention below:

• {companyName}.gh.api@{companyDomain}.com

Inform your Dice CSM once you have set up the Dice API user email alias for your organization.

Dice will provide an additional link once the Dice API User is set up. This link allows you to register your newly set Dice API User with the IntelliSearch for the Greenhouse Recruiting integration.

Additional integration configurations

You can enable the following additional integration configurations in Dice:

• Days last active setting:
  • Value: number – Filters out any prospects that haven't been active in Dice.com within the specified days
  • Example: If Days last active is set to 90, then the integration will only find persons that have been active on Dice in the past 90 days
• Exclude third party filter:
  • Value: true/false – When set to true filters out any prospects that are being represented by a third-party agency
• Require phone number setting:
  • Value: true/false – When set to true will filter out any profiles that do not have a phone number
• Maximum prospects per job:
  • Value: number – Determines how many profiles are sourced per job order
  • Once you email your Dice customer success manager with the setup information above, Dice will send you a Dice API user registration email so that you can connect your Dice API user to the IntelliSearch for Greenhouse integration

Create webhooks for the Dice integration

Next, create webhooks for the Dice integration. Dice requires four (4) unique webhooks. Follow the steps in this article to create your webhooks. Use the values listed below to configure the webhook:

Webhook 1

• Name: diceApplicationUpdated
• When: Application updated
• Endpoint URL: The Endpoint URL provided by by your Dice CSM
• Secret Key: The Secret Key provided by your Dice CSM

Webhook 2

• Name: diceJobUpdated
• When: Job updated
• Endpoint URL: The Endpoint URL provided by by your Dice CSM
• Secret Key: The Secret Key provided by your Dice CSM

Webhook 3

• Name: diceJobPostCreated
• When: Job post updated
• Endpoint URL: The Endpoint URL provided by by your Dice CSM
• Secret Key: The Secret Key provided by your Dice CSM

Webhook 4

• Name: diceProspectRejected
• When: Candidate or prospect rejected
• Endpoint URL: The Endpoint URL provided by by your Dice CSM
• Secret Key: The Secret Key provided by your Dice CSM

That's it! The Dice integration is ready to use with Greenhouse Recruiting.

Use the Dice integration with Greenhouse Recruiting

Once enabled, the Dice integration is simple to use. Set the Dice IntelliSearch custom job field to Yes on any open job (under Job Setup > Job Info) in Greenhouse Recruiting, and Dice will match and import relevant prospects to your job.

The integration uses the following job information to match prospects to your job:

Job post fields

• Job name: Ensure that your job name is indicative of the job need
• Location: IntelliSearch will find persons within a 50-mile radius of the location specified
• Post description: Well-written job post descriptions are critical to good results. IntelliSearch will read from the text to determine the needed skillsets to look for in its database

Job custom fields

• Dice IntelliSearch: Required Skills & Keywords: List the required skills and / or keywords for this job ensures that the prospects returned have all the needed criteria. The product by default will convert any comma-separated values to an AND statement. Recruiters may indicate variations of skills and keywords by placing them in brackets and typing an OR between each.
  • Example: The following input would require prospects to have Java or C++ experience and AWS or Azure experience and DBA experience.
  • (Java OR C++), (AWS OR Azure), DBA
• Employment type: The employment type is critical to filter out any prospects not suited for the type of work being completed.
  • Example: If you are looking for a Contract position, setting the Employment Type to Contract would filter out prospects that are looking for contract engagements

Interacting with prospect results

Greenhouse Recruiting enables you to interact with prospects in a few different ways. You can search for prospects within the All Candidates search, see prospects from your job dashboard, or interact with them through Greenhouse CRM.

All candidates search

You can search for prospects by setting the Application Type filter on the Candidates page to Prospects only.

Candidate tags

Dice also enriches each Greenhouse Recruiting candidate profile with an extensive list of candidate tags defining their skills. Candidate tags allow you to easily narrow your search for Greenhouse Recruiting prospects by filtering by tag. Just use the Candidate Tags under the Profile Details filter on the Candidates page.

Greenhouse CRM (optional)

Dice IntelliSearch for Greenhouse Recruiting also works with Greenhouse CRM functionality by automatically adding auto-sourced profiles into a prospect pool of your choice.

If you'd like to enable this feature, please supply your Dice CSM with the name of the prospect pool and prospect pool stage to be used for the integration.

Backfill additional prospects

When a recruiter makes an action in Greenhouse Recruiting to Convert a prospect to a candidate or Stop considering as prospect, Dice will automatically search for the next most relevant prospect in the database and backfill them to the job.

Additional resources

For additional information or troubleshooting not covered here, reach out to integrationsupport@dhigroupinc.com.