How do I enable and use the Cangrade integration?

Follow
Available for User roles Super Admins, Admins, Team Members
Packages Select Lever packages

The Cangrade Integration allows you to add a Cangrade assessment to any stage within your pipeline and send it to the candidate from within your Lever candidate dashboard.

There are 2 flows to choose from regarding adding a Cangrade assessment:

  • Cangrade assessment is requested when a new applicant or lead enters your pipeline; OR
  • Cangrade assessment is requested when a candidate is moved into a selected stage in your pipeline
    • You may use a current pipeline stage or add a new stage specific to the Cangrade assessment. If you would like to add a new stage, please submit a request to Lever support via: https://help.lever.co/hc/en-us/requests/new
  • Lever Tags are created for each associated Cangrade assessment (configured below via the Cangrade Integration Settings). In Lever, you can add one of these tags to a posting in order to assign a specific Cangrade assessment. The tags on the job level are inherited to the candidate's opportunity record.
  • Assessment progress will be tracked on the candidate’s respective opportunity through Lever tags. When the candidate enters the selected trigger stage, Lever will trigger Cangrade to invite the candidate via email to take an assessment. The respective opportunity will be tagged with Cangrade Requested. When the candidate completes the assessment, Cangrade will update the opportunity, replacing Cangrade Requested with Cangrade Completed and a new tag representing the result bucket from the assessment: Cangrade No Fit, Cangrade Low Fit, or Cangrade High Fit.
  • For more detailed assessment results, you can add a Lever Profile Form to your Cangrade Integration. Upon completion of an assessment, Cangrade will add a form to the respective opportunity with the numeric result score and a link to view a detailed report on Cangrade’s platform. If you would like to customize the details included in this form, please contact your Cangrade representative via: support@cangrade.com

Setup the integration:

Note: Access role must be Super Admin in order to set up the integration.

Step 1: Connecting the Integration

1. To start, in the Cangrade platform, login to your account and in the left side menu navigate to Company Admin -> Integrations

2. Select Lever from the list of ATS Providers

3. Click on the Authenticate Lever button to authenticate the Cangrade Integration via your Lever account. Log in with your Lever account and read and accept the permissions requested by Cangrade.

mceclip0.png

4. You will be redirected back to the Cangrade Integration Settings page with a blank form for configuring your integration details. View Step 2 below for instructions on correctly completing this form.

Step 2: Configuring the Integration

  • In your Lever Account, select your Profile Icon in the top navigation bar and select SETTINGS. On the left side navigation menu, select Integrations and API. Select the WEBHOOKS tab. Under the first header Webhook configuration, toggle the sliders ON for the following events:
    • APPLICATION CREATED
    • CANDIDATE STAGE CHANGE

mceclip1.png

This setting will allow the Cangrade Integration to create a Lever Webhook -- a communication route that will allow Lever to send Assessment requests to Cangrade!

  • In your Cangrade Integration Settings under the section Lever Configuration, you can select a Trigger Stage from the first drop down menu. The Stages in this drop down menu are imported from your connected Lever account. There are 2 flows to choose from regarding adding a Cangrade assessment to your Lever pipeline:
    • Cangrade assessment is requested when a new applicant or lead enters your pipeline
    • Cangrade assessment is requested when a candidate is moved into a selected stage in your pipeline
      • You may use a current pipeline stage or add a new stage specific to the Cangrade assessment. If you would like to add a new stage, please submit a request to Lever support via: https://help.lever.co/hc/en-us/requests/new

For flow (a.), no changes are required within your Lever account. In your Cangrade Integration Settings, select Application Created* from the Stage drop down menu. 

mceclip2.png

For flow (b.), select a current pipeline stage or create a new stage within Lever.  In your Cangrade Integration Settings, select the chosen stage from the Stage drop down menu. 

Note: If you recently created a new stage, you may have to refresh the Cangrade Integration Settings webpage. 

  • In your Lever Account you will need to create a Placeholder Opportunity that will allow your Cangrade Integration to automatically add Tags to your Lever account. In the top navigation bar, select +ADD CANDIDATE -> ADD MANUALLY to create a new Opportunity. In the browser’s URL bar, you will see an ID for the Opportunity formatted as follows:

https://hire.lever.co/candidates/{{opportunity-ID-here}}

Please copy and paste this ID into your Cangrade Integration Settings under the field Placeholder Opportunity ID. Make sure the ID does not include any / or ? from the URL, just the ID itself.

mceclip3.png

Back in your Lever Account, enter a name for the Opportunity such as “Cangrade Placeholder”. You may archive this Opportunity if desired, but do not delete.  

  • If you would like to enable detailed assessment results via a Form on the Lever Opportunity, you can do so in your Cangrade Integration Settings. Under the section Lever Configuration, select the checkbox to “Add Cangrade assessment results and link to a Lever Form.” While enabled, a new form field will appear to input a Profile Form Template ID. Please follow the instructions below to create and copy this Template ID:
    • In your Lever Account, select your Profile Icon in the top navigation bar and select SETTINGS. On the left side navigation menu, select Forms. Click the NEW FORM button to create a new Form.
    • Title your new Form Template as you’d like it to appear on the Opportunities with a relevant title such as “Cangrade Results.”

mceclip4.png

    • The Form Template will consist of 2 Questions as outlined below. Please make sure the name and type matches so the data will populate correctly. 
      1. Name: Cangrade Score Type: TEXT (SINGLE LINE)
      2. Name: Cangrade URL Type: TEXT (SINGLE LINE)
  • Save the Form Template.
  • Prior to closing the form, you will need to copy the Form Template’s ID in a similar fashion to the Placeholder Opportunity in (2.) above. In the browser’s URL bar, you will see an ID for the Form Template formatted as follows:

https://hire.lever.co/settings/forms/{{form-ID-here}}

Please copy and paste this ID into your Cangrade Integration Settings under the field Profile Form Template ID. Make sure the ID does not include any / or ? from the URL.

mceclip5.png

  • Save the Cangrade Integration Settings form! 

Step 3: Using the Lever Tag Manager

In your Cangrade Integration Settings, the Lever Tag Manager section allows you to provision Lever Tag names for each Assessment you have configured within Cangrade. If you need help configuring a Cangrade Assessment, please contact your Cangrade representative via: support@cangrade.com.

You should see all your active Cangrade Assessments as field names under the Lever Tag Manager section. 

  • Please assign a unique Tag name to each Cangrade Assessment. The name you enter here will be created as a Tag on the Placeholder Opportunity created in the instructions above. It will appear as follows:

"Cangrade: your_tag_name_here"

mceclip6.png

Configuring these Tag names in your Cangrade Integration Settings ...

mceclip7.png

... will create these Tags in your Lever account ecosystem

Once the Tag is created, it is immutable and cannot be changed. Please make sure your Tag name is correct and unique from all other Tags in your Cangrade Integration.

  • Save the Cangrade Integration Settings form! This will add the newly created Tags to your Lever account’s ecosystem.
  • In your Lever Account, open a Job in which you would like to include a Cangrade Assessment in its pipeline. On this Job, you will need to add the corresponding Tag you created in (1.) above linking the Cangrade Assessment to the Lever Job. Please refer to the screenshots below on completing this step.

mceclip8.png

Under a Lever Job, search and add the Tag name of the associated Cangrade Assessment ...

mceclip9.png

... the Tag should appear on the Lever Job posting

  • Repeat (2.) above as necessary until you have provisioned Cangrade Assessment connected Lever Tags to all desired Jobs within your Lever account. 

mceclip10.png

How to disable the integration:

1. Navigate to your Integrations & API Settings Page in Lever

2. Under the Authorized Apps tab locate the Cangrade app

3. Click Revoke Access to disable the integration

Was this article helpful?
0 out of 0 found this helpful