Know how to integrate iMocha and Lever and evaluate candidates in a single workflow
Integration Flow Summary
- The candidate applies to a job posting.
- Job application (aka Opportunities in Lever) will get the iMocha assessment tag attached through the Lever Automation feature.
- The recruiter will move the candidate to the “Assessment” stage in Lever.
- Lever will trigger notification to iMocha endpoint for candidate stage change event.
- If iMocha tag is present on a given job application (opportunities), iMocha will do the following –
- Initiate assessment as per tag.
- Send out an email to candidates with assessment information.
- Upon completion of assessment by candidate, the report will be synced back to candidate form along with report pdf as an attachment in the files section.
- The job application will be moved to the “Assessment Complete” stage.
All completed assessment applications can be found in the “Assessment Complete” stage, while all applications initiated for assessment are present in the “Assessment” stage in Lever.
The recruiter can move candidate applications back and forth in the “Assessment” stage.
Note, that this will trigger the following behavior
- If the candidate already received an assessment invite, and not appeared for the test yet,
- Invitation settings will be updated which include test access time, proctoring, and other settings available in the “Default” test link for the given test at that time.
- An email will be sent to the candidate again
- No new invite will be created in this context, rather test invitation settings are updated as mentioned above.
- If candidate assessment status is either InProgress or Complete then
- No new invite be will be created.
- No email will be sent.
- In short, it will safely ignore the event
How to setup Integration
Step 1 - Lever setup
- Go to Settings in Lever (You would require access to Integration & APIs /super admin permission)
2. Generating API key
- Click on generate API key & give API key descriptive name
- Select permission, and click done below.
Note: The API key will only be visible once, so make sure to copy it someplace.
3. Permission required. Please select all.
Read endpoints permission
- Read stage
- Read user
- Read posting
- Read opportunity
- Read opportunity application
- Read opportunity form
- Read form template
- List users
- List stages
- List tags
- List postings
- List opportunities
- List form templates
- List opportunity application
- List opportunity forms
- List opportunity notes
Write endpoints permission
- Upload opportunities file
- Update opportunities stage
- Update form template
- Remove opportunities tag
- Create opportunity note
- Create opportunity form
- Create form template
- Add opportunity tag
4. Webhook notification setup
Go to Webhooks tab in same windows
Add below URL to Candidate stage change
Step 2 - iMocha Setup
1. Go to Settings -> Integration -> Lever -> Configure
2. Add key Lever API key your generated in Step 3 and click save
3. Once you entered the API key, click save
4. Select the stage where you want to trigger sending out the assessment.
5. Select the “Assessment” stage here from the dropdown.
6. Select the stage where you want the candidate to be moved to after test completion. Select the “Assessment Completed” stage from the dropdown.
7. Select the profile form template from the dropdown. Choose “iMocha Assessment” in the dropdown. If you don’t have it created already click plus sign and create it. To sync and create tags in Lever, select job posting and select candidate in that job posting from the respective dropdown.
8. To sync and create tags in Lever, select job posting
9. Once all fields are selected click on save. Wait few seconds.
10. You will see Activate Integration button, click on it.
11. The Final screen should look like below.
And you are done with Integration. Congrats!
Step 3-How to send an invite from Lever
- Move candidate to “Assessment” stage.
- The candidate will receive an email from iMocha.
- Once the test is completed, you will find the candidate in the “Assessment Complete” stage.
- View Assessment Report in forms.
5. Report is attached in the file as well
In case of any queries, please write to us at firstname.lastname@example.org