Skip to main content

Set up Universal Workflow in SmartRecruiters

How to set up SmartRecruiters so your recruiters choose the Sapia workflow set for each job in Talent Hub.

A
Written by Adrian Panaga

With Universal Workflow, you connect SmartRecruiters to Sapia once. After that, your recruiters choose the Sapia workflow set for each job in Talent Hub, so you no longer need to change SmartRecruiters every time a new interview template is created.

What this article covers

The steps you complete in SmartRecruiters, and what Sapia does on its side. Jobs that already use a workflow set chosen in SmartRecruiters continue to work as they do today.


Before you start

Setup is a one-hour session between your SmartRecruiters administrator and the Sapia integration team. Your Sapia contact will arrange it.

How it works with SmartRecruiters

In SmartRecruiters, an assessment is attached to a hiring process, not to an individual job. Which hiring process a job uses is decided by criteria that you set in SmartRecruiters. Sapia cannot see these criteria, so each job carries a custom job field that tells Sapia the job is for Sapia.


Set it up

  1. Sapia turns on Universal Workflow for your account. You do not need to do anything for this step. Once it is on, Sapia.ai Universal Assessment can be selected in SmartRecruiters.

  2. Create a custom job field. In SmartRecruiters, add a custom job field. You choose the field name and the value. Do not make the field required. If it is blank, Sapia ignores the job, which is what you want for jobs that do not use Sapia.

  3. Tell your Sapia contact the field name and value. They must match your SmartRecruiters field exactly, including spelling and capital letters. If you have more than one Sapia account, use a different value for each. The value decides which account the job belongs to.

  4. Add the Sapia.ai Universal Assessment to a hiring process. Then set that hiring process's criteria to match the value of your custom job field. Jobs with that value will use this hiring process.

  5. Sapia connects job notifications. Your Sapia contact does this on their side. You do not need to do anything for this step.

  6. Test it. Create a test job with your field value and get it published. It should appear in Talent Hub as Unassigned. Assign an interview template, publish the job, then place a test application and confirm the candidate is invited.


Using it day to day

  1. Create the job in SmartRecruiters, set your custom job field to the agreed value, and make sure it uses the hiring process that includes the Sapia.ai Universal Assessment.

  2. Get the job published. Once it is published, it appears in Talent Hub.

  3. In Talent Hub, go to Job requisitions. The job shows as Unassigned. Under Actions, choose Assign, select the interview template, choose a job family (this is required at the moment), and save. The job then shows as Assigned.

  4. Publish the job in SmartRecruiters.

Assign the template before you publish the job. Candidates who apply while a job is still Unassigned may not be invited.


If something is not working

  • The job does not appear in Talent Hub. Check that the job has been published, and that the field value matches exactly what Sapia has on file.

  • Candidates are not being invited. The job is probably still Unassigned. Assign a template in Talent Hub and save.

  • You see a change workflow set error. The job may be using a hiring process that does not include the Universal Assessment Package. Check that the hiring process criteria match your field value.

If you are still stuck, contact your Sapia representative.

Did this answer your question?