Skip to main content

Limit the Hiring Team Agent to specific users

Choose who can message BrightHire’s Hiring Team Agent in Slack, instead of your whole organization.

Written by Jennifer Steinker

By default, everyone in your organization can message the Hiring Team Agent in Slack. If you’d rather start with a smaller group, such as recruiters, a pilot team or a staged rollout, you can limit it to specific people.

You need to be an organization admin to change these settings, and your organization needs the Slack Hiring Team Agent connected.

What changes for each group

People with access can message the agent in Slack as usual.

Everyone else can’t message the agent. If they try, it replies: “Please contact your organization’s administrator for access to the Hiring Team Agent.”

Notifications don’t change. Everyone in your organization keeps receiving the agent’s notifications, such as call summaries and interview prep, whether or not they have access.

Before you turn on the limit

As soon as the limit is on, anyone who hasn’t been given access loses the ability to message the agent. To avoid cutting people off, give access to everyone who uses the agent first, then turn on the limit.

How to set it up

  1. In BrightHire, go to the Slack Settings page.

  2. Turn on Limit to specific users.

  3. Give access to each person who should keep using the agent, either one at a time or from a CSV file (both covered below).

Give one person access

  1. Go to Settings > Users list and open the user.

  2. Turn on Enable Hiring Team Agent.

This switch only appears while Limit to specific users is on. People can’t turn it on for themselves.

Update many people from a CSV file

You can turn the agent on or off for many people at once. Only the people in your file are changed.

  1. On the Slack Settings page, find Update users from a file.

  2. Choose Turn on for these users or Turn off for these users.

  3. Select Upload CSV and choose your file.

  4. Check Review changes, then select Apply changes.

  5. Keep the page open until you see Update complete. If you close it early, the update stops partway. Upload the same file again to finish.

Your file can use one of three formats:

  • Allowed list: one email address per row. Use with Turn on for these users.

  • Disallowed list: one email address per row. Use with Turn off for these users.

  • Mixed list: email,1 to turn someone on, or email,0 to turn them off.

Example of a mixed list:

email,value [email protected],1 [email protected],1 [email protected],0

Select the ? next to Update users from a file to see the formats and download an example file.

Good to know

  • A header row is optional. Files can be up to 1 MB and 10,000 rows.

  • Emails are matched to people in your organization, including their alternate email addresses. Capitalization doesn’t matter.

  • After an update, a Not changed list shows any rows that weren’t applied and why, for example No matching user or Already set.

  • Access is set per person, not by role, so new hires need to be given access individually or added in your next CSV upload.

  • If you never turn on the limit, nothing changes. Everyone keeps the agent, just as before.

  • If you turn the limit off, everyone gets access again. Each person’s setting is saved, so turning the limit back on restores the same list.

Related articles
​BrightHire Slack Integration · BrightHire x Slack – Integration Setup

Did this answer your question?