1. Greenhouse Support
  2. Recruiting
  3. Candidate testing

Scoutible

Important: The highlighted text throughout this document indicates an instance where a mistake in entering the exact wording / spelling / capitalized letters can result in an incomplete integration. Please pay attention to all highlighted text. 

Note: Watch this short video to understand the Scoutible features that will be in your Greenhouse environment after you complete these instructions.

For Help: Need help? Have questions? Contact us at support@scoutible.com

 

API Instructions

Step 1: Harvest API Setup

What is it? You need to set up Greenhouse’s Harvest API so that Scoutible can receive data about your candidates and jobs.

Why do this? This will enable candidates to play Scoutible games, and it will enable Scoutible to provide you with insight about your candidates.

How do I do this? It’s easy - here are the steps: 

  1. First, click on the Configure tab

scout1.png 

  1. Then, click Dev Center

 scout_2.png

  1. From this list, click API Credential Management

 scout_3.png

  1. Click Create New API Key to generate the API key for Scoutible

 scout_5.png

  1. Name the API Key “Scoutible”
  2. For Type, choose Harvest

 

When complete, it should look like this:

scout_6.png 

  1. Click Create
  2. Select the following options: Activity Feed, Applications, Candidates, EEOC, Job Posts, Jobs, Rejection Reasons, Tags, Users. When complete, it should look like this:

scout_7.png 

  1. Copy the API Key in the green highlighted section:

scout_8.png

  1. Paste the API Key into the body of an email it to support@scoutible.com with your company name as the subject line.
  2. Lastly, click Update.

 

Note: Scoutible Harvest API Endpoint URLs (for internal use only):

  • Adding a note: https://harvest.greenhouse.io/v1/candidates/{candidate_id}/activity_feed/notes
  • Finding the tag id for Played Scoutible: https://harvest.greenhouse.io/v1/tags/candidate
  • Applying a Played Scoutible tag: https://harvest.greenhouse.io/v1/candidates/{candidate_id}/tags/{tag_id}
  • Getting candidate info for email update as well as updating candidate with top soft skills: https://harvest.greenhouse.io/v1/candidates/{candidate_id}
  • Getting EEOC data: https://harvest.greenhouse.io/v1/applications/{application_id}/eeoc
  • Getting all candidates in a job: https://harvest.greenhouse.io/v1/candidates?job_id={job_id}

Step 2: Web Hooks Setup

What is it? You need to set up Greenhouse’s Web Hooks API so that Scoutible can detect when you receive applicants to your jobs.

Why do this? This will enable the auto-invite feature where Scoutilbe automatically invites all candidates to your job without you having to manually invite anyone.

How do I do this? It’s easy - here are the steps:

 

  1. First, click on the Configure tab

scout_10.png 

  1. Then, click Dev Center

 scout_11.png

  1. Then, click Web Hooks

scout_12.png 

  1. From this list, click Web Hooks

 scout_13.png

  1. Click the Create Web Hook button

 scout_14.png

  1. You’ll use this Create Web Hook option to create a new Web Hook for each of the following:

Scoutible Invite

  • Name: Scoutible Invite
  • When: ‘Candidate has submitted application’
  • Export to: https://api-dot-scoutible-app.appspot.com/api/v1/integrations/greenhouse
  • Secret Key: [enter the secret key given to you by Scoutible]
  • Error recipient email: support@scoutible.com
  • Advanced Settings > Additional HTTP Headers: [enter the org key given to you by Scoutible]

Job Updated

  • Name: Job Updated
  • When: ‘Job Updated’
  • Export to: https://api-dot-scoutible-app.appspot.com/api/v1/integrations/greenhouse/job
  • Secret Key: [enter the secret key given to you by Scoutible]
  • Error recipient email: support@scoutible.com
  • Advanced Settings > Additional HTTP Headers: [enter the org key given to you by Scoutible]

Rejected

  • Name: Rejected
  • When: ‘Candidate or Prospect rejected’
  • Export to: https://api-dot-scoutible-app.appspot.com/api/v1/integrations/greenhouse/rejected
  • Secret Key: [enter the secret key given to you by Scoutible]
  • Error recipient email: support@scoutible.com

Hired

  • Name: Hired
  • When: ‘Candidate has been hired’
  • Export to: https://api-dot-scoutible-app.appspot.com/api/v1/integrations/greenhouse/hired
  • Secret Key: [enter the secret key given to you by Scoutible]
  • Error recipient email: support@scoutible.com

Email Updated

  • Name: Email Updated
  • When: ‘Application Updated’
  • Export to: https://api-dot-scoutible-app.appspot.com/api/v1/integrations/greenhouse/update-candidate
  • Secret Key: [enter the secret key given to you by Scoutible]
  • Error recipient email: support@scoutible.com
  • Advanced Settings > Additional HTTP Headers: [enter the org key given to you by Scoutible] 

Here’s a partial screenshot of what the auto-invite email looks like when the candidate receives it:

scout_16.png

Configuration Instructions

Step 3: Create Scoutible User

What is it? You need to set up a “fake” user called Scoutible System, so that automated updates in candidates’ Activity Feeds come from this “user”. 

Why do this? A user entity is required to automatically send Notes to Activity Feeds. 

How do I do this? It’s easy - here are the steps:

  1. First, click on the Configure tab

scout_17.png 

  1. Then, click Users

 scout_18.png

  1. Next, click the + New Users button

 scout_19.png

  1. In the Enter user emails text field, enter support@scoutible.com

 scout_20.png

  1. Under Set permissions, select Site Admin

 scout_21.png

  1. Lastly, click Save.

Step 3 is complete! Move on to Step 4.

Step 4: Create the “Played Scoutible” Candidate Tag

What is it? You need to set up a new Candidate Tag called “Played Scoutible”. 

Why do this? This will allow you to filter between candidates who have played the Scoutible games and those who have not. This is important because the Performance Predictor results and Top Soft Skills are only available on candidates who have played Scoutible.

How do I do this? It’s easy - here are the steps: 

  1. First, click on the Configure tab

 scout_22.png

  1. Then, click Custom Options

scout_23.png 

  1. Under the Company Metadata list, click Candidate Tags

scout_24.png 

  1. Click the Create New Candidate Tag button

scout_26.png 

  1. Enter the name of the Candidate Tag exactly like this: Played Scoutible

Make sure to spell this correctly and capitalize the first letter of both words!

  1. Lastly, click the Create Candidate Tag button.

 scout_27.png

Step 4 is complete! Next we’ll set up an email template you can use to invite applicants.

Step 5: Create Invite Email Template

Note: This step assumes that Scoutible has created an invite microsite for you. This URL will be used in place of the highlighted URL found in the template body text below. If you do not have this URL, please contact Scoutible Support (support@scoutible.com) before completing Step 5. Otherwise, you may skip this step and move to Step 6.

What is it? You need to set up an Organization-Wide Email Template. 

Why do this? This enables you and other recruiters to manually invite applicants to play Scoutible games in case the auto-invite emails did not reach the candidate (spam filters sometimes filter out these emails).

How do I do this? It's easy - here are the steps:

 

  1. First, click on the Configure tab

 scout_28.png

  1. Next, click Email Templates

 scout_29.png

  1. Click the + New button on the Organization-Wide Templates section to create a new template

scout_30.png 

  1. In the following fields, enter the following information:

 

Template Name: Scoutible Invite

Type: Candidate Email

Description: Invitation reminder for applicants who haven’t finished playing Scoutible.

From Address: {{MY_EMAIL_ADDRESS}}

CC: [none]

Email Subject: You’ve been invited by {{COMPANY}}

Attachments: [none]

Body:

Hi {{CANDIDATE_FIRST_NAME}},

 

I’d like to invite you to play Scoutible mobile games as part of your application for {{JOB_NAME}}.

 

We’ve partnered with Scoutible to provide a unique job application experience using mobile games, which detect the hidden strengths of applicants and highlight them for employers.

 

Follow the instructions here to get started: app.scoutible.com/[COMPANY] (MAKE SURE TO use the same email that you applied with: {{CANDIDATE_EMAIL_ADDRESS}} to register).

 

If you encounter problems, email Scoutible Support (support@scoutible.com).

 

{{MY_SIGNATURE}}

 

When complete, it should look like this:

 scout_31.pngscout_32.png

  1. Click Save. You can now manually invite candidates to play Scoutible if you need to.

Here’s an example of what the email looks like when the candidate receives it:

scout_33.png

Step 6: Set Up Custom Fields

What is it? You need to set up three Custom Fields; one at the job level and two at the candidate level.

Why do this? This will allow you to select a Performance Predictor model when creating a job as well as use the numerical Performance Prediction result and the Top Soft Skills to filter your candidates. These are the primary features in the Scoutible integration that allow you to optimize your recruiting efforts by focusing on only the best candidates. 

How do I do this? Follow these 19 steps to finish your integration (it sounds like a lot, but it goes really fast).

Job Field - Performance Predictor

  1. First, click on the Configure tab

scout_34.png 

  1. Then, click Custom Options

scout_35.png 

  1. Under the Company Custom Fields list, click Jobs

scout_36.png 

  1. On the Manage Job Fields page, click the + Add Field button

scout_37.png 

  1. In the Field text box, enter Performance Predictor

Make sure to spell this correctly and capitalize the first letter of both words!

  1. From the Type dropdown, select Multi select
  2. In the Options text box that appears, copy and paste the following 2 company functions: 

Sales

Customer Service

Make sure to spell these correctly and that each word is on its own line!

When complete, it should look like this:

scout_38.png 

  1. Click Save. That’s one down.

Candidate Field - Performance Prediction

  1. Click Custom Options again 
  1. Under the Company Custom Fields list, click Candidates

 scout_40.png

  1. On the Manage Candidate Fields page, click the + Add Field button

 scout_41.png

  1. In the Field text box, enter Performance Prediction

Make sure to spell this correctly and capitalize the first letter of both words!

  1. From the Type dropdown, select Number

When complete, it should look like this:

 scout_42.png

  1. Click Save. That’s two down.

Candidate Field - Top Soft Skills

  1. While still on the Manage Candidate Fields page, click the +Add Field button again

 scout_43.png

  1. In the Field text box, enter Top Soft Skills

Make sure to spell this correctly and capitalize the first letter of both words!

  1. From the Type dropdown, select Multi select
  2. In the Options text box that appears, copy and paste the following 10 soft skills:

 

Analytical

Communicator

Creative

Diligent

Flexible

Hardworking

Leader

Perfectionist

Team-Player

Visionary

 

Make sure to spell these correctly and that each word is on its own line!

When complete, it should look like this:

scout_44.png 

  1. Click Save. That’s it! Your integration is now complete and you’re ready to

If at any point you have questions, do not hesitate to contact us at support@scoutible.com

Thank you for using Scoutible!