How to use BrainCompass with Tellent Recruitee

What does the integration do?

The BrainCompass integration with Tellent Recruitee allows recruiters to send BrainCompass assessments directly from a candidate profile and receive relevant assessment results back in Tellent Recruitee.

Recruiters can stay within their normal Tellent Recruitee workflow. BrainCompass manages the candidate invitation, assessment experience and result processing.

The candidate completes the assessment in BrainCompass. Once completed, relevant result information is returned to the candidate profile in Tellent Recruitee.

Before you start

To use the integration, you need:

an active BrainCompass subscription or trial;
a BrainCompass integration token;
your Tellent Recruitee Company ID;
permission to manage Marketplace integrations in Tellent Recruitee.
Individual recruiters do not need a BrainCompass recruiter or administrator account to send assessments or view the returned results in Tellent Recruitee.

If you are not yet a BrainCompass customer, contact [email protected] to discuss access or request a trial.


 
Setting up the integration
1. Find your Tellent Recruitee Company ID
BrainCompass uses your Tellent Recruitee Company ID to configure the connection for your organisation.

In Tellent Recruitee:

Go to Settings.
Open Company settings.
Select General.
Find and copy your Company ID.
You can also find the Company ID under Settings > Apps and plugins > Personal API tokens.

Send your Company ID to BrainCompass when requesting activation of the integration.


2. Get your BrainCompass integration token
Contact BrainCompass at [email protected] and provide:

your organisation name;
your Tellent Recruitee Company ID.
BrainCompass will configure your organisation's connection and the assessments that should be available in Tellent Recruitee.

Once configured, BrainCompass will provide your integration token.

Keep this token confidential. It is used to authenticate the connection between Tellent Recruitee and BrainCompass.


 
3. Connect BrainCompass in Tellent Recruitee
In Tellent Recruitee:

Go to Marketplace.
Search for BrainCompass in the Assessments category.
Open the BrainCompass integration and click Integrate.
Read the integration information and click Accept and integrate.
Enter the BrainCompass integration token provided to you.
Click Integrate.
Review the integration settings and permissions.
Save the configuration.
Tellent Recruitee will validate the token and retrieve the BrainCompass assessments configured for your organisation.

You can review or remove the integration later from the integration settings in Tellent Recruitee.


 
Send a BrainCompass assessment
There are two ways to send a BrainCompass assessment from a candidate profile in Tellent Recruitee.

Option 1: From the candidate profile menu
Open the candidate's profile in Tellent Recruitee.
Click the “...” menu at the top of the candidate profile.
Select the option to send an assessment.
Choose BrainCompass.
Select the BrainCompass assessment you want to send.
Confirm the candidate's first name, last name and email address.
Send the assessment.
Option 2: From the integrations section
You can also send the assessment from the integrations section at the bottom of the candidate profile.

Open the candidate's profile.
Scroll to the integrations section at the bottom of the profile.
Select BrainCompass from the available integrations.
Choose the assessment you want to send.
Send the assessment.
After the request is sent, BrainCompass creates or resolves the candidate's BrainCompass account, creates the appropriate assessment and initiates the relevant invitation or notification.

You do not select a BrainCompass Navigator as part of this process.


What does the candidate receive?
For a candidate who does not yet have an active BrainCompass account, BrainCompass sends an email invitation to access the assessment and complete their registration.

If the candidate already has a BrainCompass account, the existing account is reused and the appropriate invitation, reminder or new-assessment notification is sent.

The candidate then completes the BrainCompass assessment in the BrainCompass participant environment.


View the results in Tellent Recruitee
After the candidate has completed the required assessment, BrainCompass sends completion and result information back to Tellent Recruitee.

Open the candidate profile and view the BrainCompass assessment to see the returned information.

Depending on the assessment, this can include:

completion status;
score;
a short result summary;
key strengths;
potential risks;
interview or discussion topics.
The recruiter does not need to log in to BrainCompass to access this information.


Which assessments are available?
The BrainCompass assessments shown in Tellent Recruitee are configured for your organisation by BrainCompass.

If you would like to add, remove or change the assessments available in Tellent Recruitee, contact:

[email protected]


 
What data is shared between BrainCompass and Tellent Recruitee?
From Tellent Recruitee to BrainCompass
When an assessment is sent, Tellent Recruitee provides the information required to create and track the assessment, including:

candidate first name;
candidate last name;
candidate email address;
candidate ID;
Company ID;
selected assessment ID and name;
report/reference ID.
BrainCompass uses this information to identify or create the participant, create the selected assessment and initiate the appropriate candidate invitation or notification.

From BrainCompass to Tellent Recruitee
After completion, BrainCompass can return:

assessment completion status;
completion date and time;
score;
short result summary;
selected result insights.
BrainCompass does not send the candidate's questionnaire answers, login credentials or internal BrainCompass configuration to Tellent Recruitee.


 
Troubleshooting
The integration cannot be activated
Check that:

the BrainCompass integration token was entered correctly;
you are using the token provided for the correct organisation;
the Tellent Recruitee Company ID supplied to BrainCompass is correct.
If the problem continues, contact BrainCompass support.

An assessment is missing
Only the BrainCompass assessments configured for your organisation are shown in Tellent Recruitee.

Contact [email protected] if an expected assessment is missing.

The candidate did not receive an invitation
Ask the candidate to:

verify that the email address in Tellent Recruitee is correct;
check their spam or junk folder.
If the invitation is still missing, contact BrainCompass before sending another assessment.

The candidate completed the assessment but no result is visible
Refresh the candidate profile in Tellent Recruitee.

If the result is still unavailable, contact BrainCompass support and provide the candidate and assessment details necessary for us to investigate.

Please do not ask the candidate to complete the assessment again unless advised by BrainCompass.


 
Need help?
For questions about the BrainCompass integration with Tellent Recruitee, contact:

[email protected]

When contacting support, it is helpful to include:

organisation name;
Tellent Recruitee Company ID;
assessment name;
a short description of the problem;
a screenshot where relevant.
Please never include your BrainCompass integration token, passwords or unnecessary candidate information in a support request.

BrainCompass
 www.braincompass.com