How can we help you?

Humantelligence

Humantelligence is the leading cloud-based recruiting and culture analytics solution that leverages AI to significantly streamline the interview process, eliminate hiring subjectivity, improve quality of hire, reduce turnover, drive engagement and ensuring diversity. Greenhouse Recruiting has three different types of integrations with Humantelligence that your organization can leverage.

  1. Data Synchronization Integration
  2. Self-Assessment Integration
  3. Web Hooks 

 

Data Synchronization Integration

Greenhouse Recruiting’s integration with Humantelligence allows to enable the flow of data between Humantelligence and Greenhouse. In the following sections we will cover all the details necessary to enable and run a data synchronization integration between Greenhouse Recruiting and Humantelligence.

 

Configure User Setup Permissions In Greenhouse Recruiting

In order to enable the Greenhouse/Humantelligence integration, you will need the developer permission Can manage ALL organization’s API Credentials.

Contact a Greenhouse user in your organization with Site Admin level permissions with the additional user-specific permission Can edit another user's advanced permissions to apply the API credential management permission to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon  > Users > Your Name)

The user with Site Admin level permissions should navigate to the Permissions panel on your user page and expand the Developer Permissions dropdown menu.

Select Can manage ALL organization’s API Credentials so that a check is in the checkbox. When finished, click Save.

Repeat as necessary for any other user that should have access to set up the data synchronization integration.

 

Create a Harvest API Key for Data Synchronization Integration

To create a Harvest API key for the data sync, click on the Configure icon Screen_Shot_2018-05-24_at_5.31.51_PM.png in the upper right-hand corner. Navigate to Dev Center on the left-hand panel.

From the Dev Center page, click API Credential Management.

From the API Credential Management page, click Create New API Key to generate the API key for Humantelligence.

From the Create new credential dialog box, give your API key a name and select Harvest from the Type dropdown menu. When finished, click Create.

On the Manage API Key Permissions page, enable ALL permissions. When finished, click Update.

Your Harvest API key for the data sync integration is created and configured. Copy the API key to enable the data sync integration.

 

Enable Data Synchronization Integration

In addition to your new Harvest API key, you will also need to retrieve your organization's Greenhouse subdomain. Your organization's Greenhouse subdomain is the alphanumeric information the precedes greenhouse.io in the URL.

With both data points, navigate to the Humantelligence Integration settings panel. Input the credentials in the appropriate fields and click Save Settings.

 

Run Data Synchronization

Humantelligence Connect Integrations will keep in sync Humantelligence with Greenhouse Recruiting.

The sync will run periodically and automatically import and update Greenhouse’s users, departments, jobs, applications, etc...

Humantelligence can also run the sync manually and decide which import they want to run.

 

Self-Assessment Integration

Humantelligence scientifically proven 12-minute self-assessment and analytics platform measures culture at every level, uncovering talent insights that can be leveraged for improving performance, engagement, and hiring. Greenhouse Recruiting's self-assessment integration with Humantelligence allows you to seamlessly add Humantelligence - Team Culture Fit’s assessment to a job's interview plan.

 

Enable the Greenhouse/Humantelligence Integration

To start, contact your Humantelligence representative to receive your API key. Once you have received your API key, email support@greenhouse.io or click here to open a ticket.

Note: Do not send the API key in this initial email.

The Greenhouse Support Team will respond with a SendSafely link for you to enter your API key. A notification will be sent to the Greenhouse Support Team after you have entered your API key and they will email you to confirm that your API key has been set up in your account and your self-assessment integration is enabled.

  

Add Humantelligence Stage to Job’s Interview Plan

Once the Greenhouse/Humantelligence integration is enabled for your organization, you will be able to add the Humantelligence assessment as an Interview stage.

To do this for an existing job, navigate to a job (All Jobs>Job Name) and click Job Setup from the Job navigation bar.

From the Job Setup page, navigate to Interview Plan on the left-hand panel. Scroll down the page and click + Add a Stage.

Screen%20Shot%202018-07-23%20at%209.10.09%20AM.png

From the Add Stage dialog box, select the Humantelligence stage. When finished, click Add to apply the stage to the job's interview plan.

 

Configure Humantelligence Stage

Once the stage has been added to the job's interview plan, click Edit Take Home Test. Use the provided drop-down menu to choose assessments that you have previously set up in Humantelligence.

Select the appropriate assessment and assign at least one Greenhouse user to grade/review submitted assessments. When finished, click Save.

Note: Keep in the mind that all configuration of the assessment itself, as well as the email template, will need to be done in Humantelligence. 

 

Send and Review the Test

When candidates are moved into the Humantelligence interview stage, Greenhouse will display a Send Test link.

Note: When you send a test from Greenhouse, the interview instructions are actually sent by Humantelligence.

The status of the assessment will be viewable in Greenhouse:

Once the candidate has submitted their test, the recruiter or admin responsible for grading the test will receive a notification with all the necessary information.

Then in Greenhouse the Interview Kit will contain a link to view the results of the submitted test on Humantelligence.

Humantelligence Talent Profile provides clear feedback and valuable insights instantly based on your results and can be used to develop and perform at each one’s best.

 

Web Hooks Integration

Greenhouse Recruiting’s integration with Humantelligence uses Web Hooks to keep the 2 platforms in sync. A web hook is a simple event notification system. When an event occurs in Greenhouse Recuiting, Humantelligence will get notified and your Humantelligence portal data will be updated accordingly. Below, we will review the steps necessary to enable a web hooks integration between Greenhouse Recruiting and Humantelligence and create two web hooks, one for when a new Job is created in Greenhouse and one for when a new Candidate applies for a job.

 

Retrieve Humantelligence’s Web Hooks Secret Key and API Key

Before enabling the Greenhouse/Humantelligence integration, Greenhouse Recruiting will need two pieces of information:

  • Humantelligence’s Web Hooks Secret Key
  • Humantelligence’s API Key

To retrieve this information please log in to your Humantelligence portal and go to the Integration Credentials panel.

  

Configure User Setup Permissions in Greenhouse Recruiting

After you have received your endpoint URL and Secret Key from Humantelligence, contact a Greenhouse user in your organization with Site Admin level permissions with the additional user-specific permission Can edit another user's advanced permissions.

Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon > Users > Your Name)

The user with Site Admin level permissions should navigate to the Permissions panel on your user page and expand the Developer Permissions dropdown menu.

Select Can manage and configure web hooks so that a check is in the checkbox. When finished, click Save.

Repeat as necessary for any other user that should have access to set up the integration.

 

Enable Greenhouse/Humantelligence Web Hooks Integration

With Humantelligence’s Secret Key copied, and your Greenhouse user permissions enabled, you are ready to enable the Greenhouse/Humantelligence web hooks integration. To enable the integration, click the Configure icon in the upper right-hand corner and navigate to Dev Center on the left-hand panel.

From the Dev Center page, click Web Hooks. Click Web Hooks from the subsequent page.

You will be directed to a new page where you Create a New Web Hook.

Web hooks have three main components: a Name, an Endpoint URL, and a Secret Key.

WebHook: New Job

  1. Enter the name for this web hook: New Job
  2. Select When: Job Created
  3. Enter this Endpoint URL: https://portal.humantelligence.com/api/v1/integrations/webhook/positions
  4. Enter the Secret Key that you retrieved earlier.
  5. The Error recipient email should be your main Humantelligence Portal administrator.
  6. Make sure the web hook is not disabled.
  7. Click on Advanced settings...
  8. Enter the Additional HTTP Headers.
    This is where you’ll enter the Humantelligence API Key that you retrieved earlier. It will look something like X-HT-ApiKey: 5a44164c69dfghb92k000703. 

When finished, click Create Web Hook.

 

Web Hook: New Application

You will repeat the same steps for the second web hook. 

  1. Enter the name for this web hook: New Application
  2. Select When: Candidate has Submitted Application
  3. Enter this Endpoint URL: https://portal.humantelligence.com/api/v1/integrations/webhook/applications
  4. Enter the same Secret Key that you retrieved earlier..
  5. Enter the same Error recipient email.
  6. Make sure the web hook is not disabled.
  7. Click on Advance settings. Add the same Additional HTTP Headers as the first web hook.
  8. Finally, click Create Web Hook.

  

Web Hook: Candidate Hired

Finally we will convert Hired candidates to an employee inside Humantelligence and set everything up for you. Once again, simply repeat the same steps as the second web hook.

  1. Enter the name for this web hook: Candidate Hired
  2. Select When: Candidate has been hired
  3. Enter this Endpoint URL: https://portal.humantelligence.com/api/v1/integrations/webhook/employees
  4. Enter the same Secret Key that you retrieved earlier.
  5. Enter the same Error recipient email.
  6. Make sure the web hook is not disabled.
  7. Click on Advance settings. Add the same Additional HTTP Headers as the other web hooks.
  8. Finally, click Create Web Hook.