Entelo

Entelo is the world’s first all-in-one, source-to-hire recruitment automation platform that’s changing the way companies hire. Entelo's mission is to deliver remarkably intelligent end-to-end experiences for Talent Acquisition. Entelo provides your organization with technology that leverages data science, machine learning, predictive analytics, candidate engagement, and recruitment marketing best practices to help your teams find the right talent and hire faster. All while delivering an exceptional candidate experience.

Greenhouse Recruiting's integration with Entelo ensures you have all the information you need to confidently take action on a candidate, whether you are viewing their profile within Entelo or Greenhouse. As an integrated Greenhouse Recruiting user, you can:

  • Discover which candidates have already been added to Greenhouse Recruiting, and what actions have been taken on them, without leaving the Entelo Search results page
  • Prioritize candidate rediscovery or new pipeline development by including or excluding Greenhouse Recruiting candidates respectively from searches run on Entelo
  • View all Entelo Track activity within a candidate’s Greenhouse Recruiting profile to get a better understanding of their past engagement history

To find out more about the two-way integration, or request setup for your team, contact us Entelo at info@entelo.com

In this article, we will cover: 

 

Configure user setup permissions in Greenhouse Recruiting

In order to enable the Greenhouse Recruiting / Entelo integration, you will need the following developer permissions:

  • Can manage ALL organization’s API Credentials
  • Can manage and configure webhooks

Contact a Greenhouse Recruiting 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 developer permissions to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon Configure.png > Users > Your Name.

1._Configure_-_Users.png

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

Select Can manage ALL organization’s API Credentials and Can manage and configure web hooks so a check is in each checkbox. When finished, click Save.

ALL_API___Web_hooks.png

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

 

Create Harvest API key for the Greenhouse Recruiting / Entelo integration

To create a Harvest API key for the integration, click the Configure icon Configure.png in the upper right-hand corner, and navigate to Dev Center on the left-hand panel. From the Dev Center page, click API Credential Management.

1._Dev_Center_-_API_Credential_Management.png

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

2._Create_new_API_key.png

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

  • API Type: Harvest
  • Partner: Entelo
  • Description: Entelo Harvest API Key

When finished, click Manage Permissions to generate the Harvest API key and automatically assign it the appropriate permissions required by Entelo.

mceclip0.png

In the subsequent dialog box, click Copy to save your API key to your clipboard. Store the API key in a secure location to provide to Entelo in the next step. Click I have stored the API Key once you have copied and saved the key.

Note: You cannot access the full API key again after clicking I have stored the API Key. If you lose your API key and need to access it later, you must create a new API key, provide it to the integration partner, and then revoke access to the original key.

3._API_key_created.png

On the subsequent page, confirm the following permissions are assigned to your new API key:

  • Candidates
    • GET: List Candidates — Enable san additional Entelo Search filter to allow you to include or exclude your Greenhouse candidates
    • GET: Retrieve Candidate — Allows Greenhouse-specific data to appear alongside Entelo profiles and displays a link directly to that candidate’s Greenhouse page
    • POST: Add Email — Allows emails sent as part of an Entelo Track conversation to appear in the candidate’s Greenhouse Activity Feed.

If any of the permissions above are not checked, place a check in the box next to the appropriate permission. Click Save when finished. 

Your Harvest API key for the Greenhouse Recruiting / Entelo integration is created and configured. 

 

Add Harvest API key to Entelo

In Entelo, navigate to your organization’s Integration page. If you do not already have a Greenhouse integration, create one. 

Once your integration is created, navigate to the Credentials page to add your Harvest API key from Greenhouse Recruiting. 

image-2.png

This page will provide you with the webhook username and password that you’ll need when you create webhooks in Greenhouse Recruiting in the next step.

 

Create Entelo web hooks in Greenhouse Recruiting

Web hooks allow Greenhouse to send a secure message directly to Entelo whenever changes occur with your Greenhouse Recruiting candidates. 

To create the web hooks, click the Configure icon Configure.png in the upper right-hand corner and navigate to Dev Center on the left-hand panel. From the Dev Center page, click Web Hooks

1._Dev_Center_-_Web_Hooks.png

Click Web Hooks from the subsequent page.

2._Web_Hooks_-_Web_Hooks.png

On the Create A New Web Hook page, provide the details below to create your first web hook. This web hook enables the following feature: When I create new Greenhouse candidates I want to automatically attempt to link them to Entelo profiles

  • Name: new_prospect_application
  • When: Prospect created
  • Endpoint URL: https://greenhouse-webhooks.entelo.com/gh
  • Secret Key: <Organization name>
  • Error recipient email: <leave empty>
  • Advanced settings: 
    • Username: <web hook username from the Greenhouse integration page on Entelo>
    • Password: <web hook password from the Greenhouse integration page on Entelo>
    • Additional Settings: <leave blank>
    • Maximum Attempts: 25
    • Disabled?: No

When finished, click Create Web hook.

mceclip0.png

Repeat the steps above to create two additional webhooks. 

Web hook for the following feature: When I delete a candidate from Greenhouse I no longer want that candidate to appear in my “show only Greenhouse candidate” searches.

  • Name: delete_candidate
  • When: Delete Candidate
  • Endpoint URL: https://greenhouse-webhooks.entelo.com/gh
  • Secret Key: <Organization name>
  • Error recipient email: <leave empty>
  • Advanced settings
    • Username: <web hook username from the Greenhouse integration page on Entelo>
    • Password: <web hook password from the Greenhouse integration page on Entelo>
    • Additional Settings: <leave blank>
    • Maximum AttemptsM: 25
    • Disabled?: No

Web hook for the following feature: When I modify the name or email address of a candidate in Greenhouse I want to make another attempt to match the candidate with an Entelo profile:

  • Name: update_candidate
  • When: Candidate or Prospect updated
  • Endpoint URL: https://greenhouse-webhooks.entelo.com/gh
  • Secret Key: <Organization name>
  • Error recipient email: <leave empty>
  • Advanced settings:
    • Username: <web hook username from the Greenhouse integration page on Entelo>
    • Password: <web hook password from the Greenhouse integration page on Entelo>
    • Additional Settings: <leave blank>
    • Maximum Attempts: 25
    • Disabled?: No

That's it! Your Greenhouse account and Entelo account can now talk to each other. These settings dictate execution of the Entelo web hooks once the end user transitions the candidate into an appropriate application stage for a given job.