Workvisa.io

 

Workvisa.io is a powerful, easy-to-use system for companies hiring skilled foreign talent. Designed with simplicity and efficiency in mind, Workvisa.io allows HR and legal teams to manage immigration processes and compliance requirements for seamless recruiting and faster onboarding.

Greenhouse Recruiting's integration with Workvisa.io allows your recruiters to request pre-hire immigration assessments directly from Greenhouse Recruiting for faster onboarding and a better candidate experience. 

In this article, we will cover: 

 

Configure User Setup Permissions in Greenhouse Recruiting

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

  • Can manage ALL organization’s API Credentials
  • Can manage and configure web hooks

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 API credential management permission to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon  > Users > Your Name.

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 that 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.

 

Enable the Greenhouse Recruiting / Workvisa.io Integration

Contact your Workvisa.io representative to receive your API key. Once you have received your API key, click here to open a ticket with the Greenhouse Support team. 

Note: Do not send the API key in this initial email.

The Greenhouse Support Team will respond with a SendSafely link for you to enter your API key. A notification will be sent to the Greenhouse Support Team after you have entered your API key and they will email you to confirm that your API key has been set up in your account and your integration is enabled.

Note: To verify your identity, the Greenhouse Support Team might request you provide a Support Verification Code before adding the API key to your organization's account.

 

Add Workvisa.io Stage to Job's Interview Plan

Once the Greenhouse Recruiting / Workvisa.io integration is enabled for your organization, you will be able to add the Workvisa.io assessment as an Interview stage.

To do this for an existing job, navigate to a job (All Jobs > Job Name) and click Job Setup from the Job navigation bar.

Job_Setup_tab.png

From the Job Setup page, navigate to Interview Plan on the left-hand panel. Scroll down the page and click + Add a Stage.

mceclip2.png

From the Add Stage dialog box, select the Workvisa.io stage. When finished, click Add at the bottom of the dialog box to add the Pre-Hire Immigration Assessment (Workvisa.io) stage to the job's interview plan.

image-1.png

 

Configure Custom Candidate Field

From your Dashboard, click the Configure icon Configure.png in the upper right-hand corner and navigate to Custom Options on the left-hand panel. 

5.png

On the subsequent page, click Candidates under the Company Custom Fields section.

6.png

On the Custom Fields: Candidates page, click Add Field.

7.png

Enter in the following information below for the Field Name and Type.

Note: Be sure to enter the words exactly as shown below, including capitalization and spaces.

  • Field Name: Requires Immigration Sponsorship
  • Type: Yes/No

Click Save.

8.png

Your newly created field will now be part of your company’s library of candidate fields, and will be shown under the Details tab of a candidate’s profile.

9.png

 

Configure Web Hooks

Before enabling the Greenhouse Recruiting / Workvisa.io integration, Greenhouse Recruiting will need a few pieces of information: 

  • Workvisa.io's Secret Key
  • Username
  • Password

Please reach out to the Workvisa.io team to retrieve your Secret Key, Username, and Password. 

Once you have received your Secret Key from Workvisa.io, you are ready to enable the Workvisa.io 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.

Dev_Center_-_Web_Hooks.png

Click Web Hooks from the subsequent page.

Web_Hooks_-_Web_Hooks.png

You will create two web hooks for the integration. On the Create A New Web Hook page, provide the following details to create the first web hook: 

  • Name: create_candidate
  • When: Candidate has changed stage
  • Endpoint URL: https://app.immidee.com/webhook/create_candidate 
  • Secret Key: The Secret Key received from the Workvisa.io team
  • Error recipient email: support@workvisa.io 

Click Advanced Settings and enter the following details: 

  • Username: The Username received from the Workvisa.io team
  • Password: The Password received from the Workvisa.io team
  • Maximum Attempts: 3

When finished, click Create Web hook

mceclip0.png

Repeat the steps above to create a second web hook using the following details: 

  • Name: update_candidate
  • When: Candidate or Prospect updated
  • Endpoint URL: https://app.immidee.com/webhook/update_candidate
  • Secret Key: The Secret Key received from the Workvisa.io team
  • Error recipient email: support@workvisa.io 

Click Advanced Settings and enter the following details: 

  • Username: The Username received from the Workvisa.io team
  • Password: The Password received from the Workvisa.io team
  • Maximum Attempts: 3

Click Create Web hook when finished. 

 

Create Harvest API Key for the Greenhouse Recruiting / Workvisa.io 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.

Dev_Center_-_API_Credential_Management.png

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

Create_New_API_Key.png

From the Create new credential dialog box, give your API key a name and select Harvest from the Type dropdown menu. When finished, click Create.

mceclip7.png

On the Manage API Key Permissions page, grant your API key the following permissions:

Applications:

  • GET: Retrieve Application
  • GET: List Applications
mceclip1.png

Candidates:

  • GET: Retrieve Candidate
  • GET: List Candidates
mceclip2.png

Job Posts: 

  • GET: List Job Posts
  • GET: Retrieve Job Post for Job
  • GET: List Job Posts for Job
mceclip3.png

Offers:

  • GET: List Application’s Offers
  • GET: Retrieve Application’s Current Offer
  • GET: Retrieve Offer
  • GET: List Offers
mceclip4.png

Offices: 

  • GET: Retrieve Office
  • GET: List Offices
mceclip5.png

Tags: 

  • GET: List Tags Applied to Candidate
  • GET: List Candidate Tags
mceclip6.png

When finished, click Update.

Copy your Harvest API key and securely send it to the Workvisa.io team to complete the integration setup. 

 

Use Greenhouse Recruiting / Workvisa.io Integration

Now that you have set up the integration, you can move forward with requesting an assessment for any candidates who indicate they need immigration sponsorship.

Step 1: Confirm the Candidate Requires Immigration Sponsorship

When the candidate indicates that they now or will in the future require immigration sponsorship, make sure to indicate this under the Details tab in their candidate profile by selecting Yes in the custom candidate field Requires Immigration Sponsorship, as indicated below.

image-7.png

Note: If you select No or leave the custom field indicated above blank, you will receive an error message and email notification indicating that you will not be able to send the Pre-Hire Immigration Questionnaire to the candidate.

image-8.png

Step 2: Initiate the Immigration Assessment Request

When you are ready to request an immigration assessment, move the candidate to the Pre-Hire Immigration Assessment stage. Once the candidate is moved to the Pre-Hire Immigration Assessment stage, click Send Test to send the Workvisa.io questionnaire to the candidate.

image-10.png

The questionnaire will be emailed to the candidate, copying a primary contact and the assigned recruiter in Greenhouse.

Step 3: Receive the Immigration Assessment

The assessment will be issued based on the completed questionnaire, the candidate’s resume/CV, and the details of the offered position harvested from Greenhouse. The recruiter will then receive an email with the assessment.


Get Help

Questions? Contact support@workvisa.io for troubleshooting assistance regarding the integration.