Jobvite Integration Guide

Updated by GSA Team

Setting Up the Integration  

  1. Contact your representatives at Jobvite and Criteria to request that an integration be created.
  2. Your Jobvite representative will provide you with an API Key and Secret.
  3. Jobvite will configure your Jobvite account. This will include:
    1. Adding the following workflow steps:
      1. Criteria Assessment
      2. Criteria Assessment Error
      3. Criteria Assessment Completed
    2. Creating the following fields:
      1. A requisition field for the Criteria Test Link
      2. Candidate custom fields for Criteria Assessment Status and Criteria Assessment Results.
  4. Optionally, you may choose to set up Custom Fields in Jobvite to hold Criteria scores of your choosing. 
  5. Provide the API Key and Secret to your Criteria Customer Success Manager.
  6. If you have selected to create custom fields, provide the Custom Field "Field Code" values to your Criteria Customer Success Manager, along with which scores you would like mapped to those fields 
  7. Criteria will configure the integration and notify you once the setup is complete. 

(Optional) Creating Custom Fields for Score Mappings 

This optional piece corresponds to #4 above from the Setting Up the Integration section. If you do not intend to have custom fields, you may skip to the next section below.

If you'd like to see Criteria scores directly from within Jobvite you just need to create Custom Fields for Jobvite Candidates for Criteria to populate with the scores.  

Work with your Criteria Customer Success Manager if you need help choosing which scores should be mapped to Jobvite. 

  1. To set up custom fields in Jobvite, go to Admin and click Configurations.
  1. Then into Custom Fields. 
  1. Then select the Candidate tab. The screen will list all the current custom fields for Candidates. 

Note: Be sure to leave the 2 existing 'Criteria' custom fields as-is as these are required for the integration to function and must not be renamed/removed. 

  • Criteria Assessment Status 
  • Criteria Assessment Results  
  1. Use the Add Custom Field button on the left to create a new custom field. 

Field Name - this is the name that will be displayed on the candidate card, choose an appropriate name that describes the Criteria score that will be shown in this field. 

Field Code - this will populate automatically when you enter the Field Name. Take a copy of this value as you will need to provide this to Criteria to configure your integration.  

Type -  

  • Number - choose this when the score field value is a number e.g. Talent Signal, Percentile or Raw Score.   
  • Drop-down list - choose this when the score field has pre-defined values e.g., Met All Score Ranges will either be 'Yes' or 'No'. You will need to add all the possible values into the 'Values' field.  
  • Text - use this if the above options aren't appropriate. 

There is no need to edit any other fields on this page. 

Click Save to create the custom field. 

Provide the Field Code value to Criteria and advise what Criteria score should be put into that field when the candidates complete testing.  

Associating Criteria Assessments with a Jobvite Requisition 

  1. To associate Criteria assessments with a job requisition in Jobvite, select Requisitions and click the name of the job requisition.   
  1. Select Details and click Edit. 
  1. Scroll down to the Criteria Test Link field and paste in the appropriate link (this will be the Job link URL from Criteria) and click Save.

Sending Assessments via Workflow Step / Reviewing Scores 

  1. Click on Candidates, then click on a candidate’s name to be taken to their candidate record. 
  2. Once in the candidate record, click the Workflow Step drop-down menu and select Criteria Assessment. 
  3. The candidate record will then reflect that the candidate is in the Criteria Assessment step and the assessment will be sent. (Note: Criteria queries workflow statuses every 30 minutes and sends the assessment invitations.)  
  4. The candidate will then receive an assessment invitation email from Criteria with a link to take the assessments.  
  5. Once the candidate completes the assessments, a link to their results will appear in the candidate record. You’ll also see their status change to Criteria Assessment Completed. Copy and paste the results link into a web browser to see a PDF of their score report.   

Viewing Custom Field Data 

Note: This section only applies if you choose the option to set up Custom Fields in Jobvite to hold Criteria scores of your choosing. 

The custom fields are shown in the Application Details section on the candidate card in Jobvite. This information will be populated when the candidate has completed testing and Criteria sends the results to Jobvite.  

Filtering Candidates by Custom Field values 

Note: This section only applies if you choose the option to set up Custom Fields in Jobvite to hold Criteria scores of your choosing. 

The candidate list for a Requisition allows you to filter the candidates based on their custom field data.

 

Custom fields configured with the Number type will allow you to enter a range of values to filter on. Use this to filter on candidates who have scored in a particular range. 

Custom fields configured with the Drop-down list type will allow you to select which pre-defined value/s to filter on. Use this to filter on candidates with the chosen results for that field. 

Sending Assessments via Workflow Step – In Bulk 

Note: In order to send the assessments in bulk, all candidates must be in the same job. 
  1. From the Candidates menu, check the boxes next to the candidates who you’d like to send the assessments to, then click the Actions button.
  2. Select Change Status. 
  3. Select Criteria Assessment from the drop-down menu and click Change Status. 
  4. Once their statuses are changed, this message will be displayed at the bottom of the page and the assessments will be sent. (Note: Criteria queries workflow statuses every 30 minutes and sends assessment invitations.) 

  

How did we do?