Automation Use Cases

Textkernel's integration with the Bullhorn Platform supports Bullhorn Automation Auto-match which starts automatic matchflows based on a trigger event in Bullhorn Automation.

Textkernel's best-in-class matching engine is available to your recruiting team via this feature.

Info

In order to generate matches, the feature requires a Textkernel Search and Match index that is connected and synced to Bullhorn Platform.

Textkernel's support for Bullhorn Automation Auto-Match feature

Bullhorn Automation offers an Auto-match feature, which can be configured to use the Textkernel by Bullhorn matching engine.

Inside Bullhorn Automation flows, you can configure a Match Candidates step. This can be powered by Textkernel match. The Match Candidates step takes a Bullhorn Job ID and a list of Bullhorn Platform Candidate ID's, and gets the top matching Candidates within the provided Candidate list. This step can be tied into other steps of a Bullhorn Automation workflow.

Bullhorn Automation includes a default matching engine for Match Candidates, but if you are using Textkernel by Bullhorn for Search and Match, you can override the default engine and use Textkernel's match engine.

Important

The Enterprise Edition of Bullhorn Automation is required to use this feature. Please check with your Bullhorn account manager if you are unsure whether you have the necessary Bullhorn license.

Activating Textkernel's matching engine for Bullhorn Automation Auto-match

Your admin user should be logged into Bullhorn Automation (the one who maintains your organizations automations)

1 Go to Settings -> API -> Match Candidates Webhook

2 Click on the Edit button.

3 Fill out the dialog:

• Set the method as POST
• Enter the URL provided to you by Textkernel professional services; it might be different depending on which Textkernel data center you are using.
• Add an Authorization Headers. Click "Include Header".
  • Use the Authorization Header prefix, as shown. Textkernel professional services will provide the token for the Header content when they are helping you to activate this feature. The token lets Textkernel validate the match request is legitimate and coming from you, so be careful with it and treat it like a secure password.
  • Use the "response-type" Header prefix as shown, and set the "Header Content" to "object". This setting is the same for all integrations.
• Add the Merge Tags. These define how to map from Bullhorn ATS fields to Textkernel's supported parameters. Copy this text exactly into your setup:

{ "TKJobId": %JOBATSID%, "JobTitle": "%JOBTITLE%", "MaxCandidateCount": "%MAX_CANDIDATE_COUNT%", "MinScore": "%MIN_SCORE%", "MaxDistanceMiles": "%MAX_DISTANCE_MILES%", "CandidateIdsInList": %CANDIDATE_IDS_IN_LIST% }

• Select Array of object as the response style, and define the "Candidate IDs Field Name" and the "Match Scores Field Name" so that the Example Response looks similar to the image. This configures Bullhorn Automation so that it is ready to consume the match response.
  • Set "Candidate IDs Field Name to "candidateId"
  • Set "Match Scores Field Name" to "score"
• Choose your preference on how to handle a failed request to Textkernel

Testing your Bullhorn Automation Auto-match configuration

After the webhook has been configured, you'll want to test the connection

1. Go to Settings -> API -> Match Candidates Webhook

2. Click on Test Webhook

You will see the dialog which is used for testing the webhook:

1. Configure your test

2. Select a Job from your Bullhorn ATS

3. Select a desired number of top N candidates to be returned.
4. Don't worry about setting "Only match candidates with a score over X%" Textkernel does not support that parameter.
5. Don't worry about setting "Only match candidates within X Miles/KM if the job. Textkernel does not support that parameter.

6. Select the list of Candidates from which you want matches to be taken. Bullhorn Automation requires that you provide a Candidate list in order to get match results. In essence, we will be ranking candidates within that list, and picking the the top N that you have requested.

7. Click "Test Webhook". It shows you the data that will be sent, and the result.

If you don't see any errors, then your test worked.

Important

You might not have any matches if the Candidate list only contains poor matches for the Job you selected for testing

Using Auto-Match in your Bullhorn Automations

Please refer to your Bullhorn ATS documentation for details on how to best integrate the match steps into your Bullhorn Automation flows.

Note that these parameters from the Match Candidate controls are NOT supported by Textkernel's implementation:

• "Only match candidates with a score over X%"
• "Only match candidates within X Miles/KM of the job"

The behaviour with respect to these parameters is directly managed by the Textkernel platform's match template, which Textkernel services can customize.

Match template customization

When setting up Bullhorn Automation Auto-match, Textkernel can optionally support the configuration of a specialized match "template" that defines what information should be emphasized or de-emphasized when finding good automatic matches (eg job title match, location match, etc). Part of setting up this feature may be to work with Textkernel professional services to understand your needs and customize the match template used.

It is possible to define one distinct match template for use by all Bullhorn Automation Auto-match events that is different from the standard match template that is used for matching by interactive users, in case you want to tune them differently.