Integrations

Connect Branco to your existing tools — Slack for feedback collection and BambooHR for employee data sync.

---

What is it?

Integrations is where admins connect the third-party services that power Branco's data collection and HR sync capabilities. Slack is the primary integration — it's how Branco collects 360 feedback from your team through automated bot conversations. BambooHR is an optional HRIS integration that keeps your employee data in sync automatically.

Admin only

Integrations is located at /integrations and is only accessible to users with admin permissions.

---

Available integrations

💬 Slack

Slack Bot Integration

The Branco Slack bot is the core feedback collection mechanism. Once connected, it runs automated conversations with your team members directly in Slack, collecting 360 feedback on skills, competencies, and team contributions.

What it does

• Initiates feedback conversations with team members on a regular cadence
• Collects structured feedback on skills, competencies, and objectives
• Feeds results into Feedback Hub, My Career, Dashboard, and Reports

How to connect

1. Navigate to the Integrations page.
2. Under the Slack Bot Integration section, click "Enable Branco".
3. You'll be prompted to authorize the Branco bot in your Slack workspace.
4. Once connected, the bot will begin reaching out to team members based on your configured cadence.

This is the most important integration

Without the Slack bot, Branco has no feedback flowing through the system — and almost every feature depends on feedback data. Prioritize connecting Slack during initial setup.

Troubleshooting

• If the bot isn't sending messages, check that FEEDBACK_ACTIVE is toggled on in Settings.
• Make sure the team members you want to collect feedback from are active users in User Management and have Slack accounts in your workspace.

🌿 BambooHR

BambooHR Integration

Connect your BambooHR HRIS to automatically sync employee data into Branco. This is a read-only, one-way sync — data flows from BambooHR into Branco, not the other way around.

What it syncs

• Employee names and contact details
• Manager assignments
• Hire dates
• Probation dates
• Job titles (configurable field via HRIS_SYNC_TITLE_FIELD in Settings)

How to connect

1. Navigate to the Integrations page.
2. Expand the "Other integrations" accordion.
3. Enter your BambooHR subdomain in the text input field.
4. Click "Connect to BambooHR".

Sync behavior

The sync runs daily and is read-only. This means:

• New employees added in BambooHR will appear in Branco automatically.
• Changes to titles, managers, or other fields in BambooHR will update in Branco on the next sync.
• Changes made directly in Branco may be overwritten on the next sync — always make edits in BambooHR first.

Sync overwrites manual changes

If you update a user's title or manager in Branco directly, the next daily BambooHR sync will overwrite those changes with whatever's in BambooHR. Always make your source-of-truth edits in BambooHR.

Related settings

The following settings in Settings control HRIS sync behavior:

Setting	What it does	Default
HRIS_SYNC_ACTIVE	Enable or disable the BambooHR sync	On
HRIS_SYNC_TITLE_FIELD	Which BambooHR field maps to job title	jobTitleName

---

Getting started

1. Navigate to Integrations in the left sidebar.
2. Connect Slack first — click "Enable Branco" and authorize the bot in your workspace.
3. Optionally, expand "Other integrations" and connect BambooHR if your organization uses it.
4. Verify everything is working by checking that feedback starts appearing in the Feedback Hub after the bot's first cycle.

---

Related features

• Feedback Hub — Where feedback collected by the Slack bot appears.
• User Management — Users synced from BambooHR show up here.
• Settings — Toggle FEEDBACK_ACTIVE and HRIS_SYNC_ACTIVE, and configure the title sync field.
• Dashboard — The Slack & IT step in the setup wizard points here.