Skip to main content

Slack Bot Setup

The Branco Slack bot is the primary way feedback is collected across your organization. Connecting it is the single most important integration step.

What the bot does​

Once connected, the Branco bot sends direct messages to team members in Slack:

  • Peer feedback — Short questions about a colleague's contributions, skills, and competencies. Sent once per week.
  • Self-reflections — Prompts focused on personal progress and growth. Sent every two weeks.

Responses flow directly into Branco and power dashboards, career pages, action plan suggestions, and reports.

Prerequisites​

Before connecting, make sure you have:

  • Slack workspace admin access (or the ability to authorize third-party apps)
  • Active users in Branco — The bot targets users who exist in User Management. Add users before connecting Slack so the bot has people to message.
  • FEEDBACK_ACTIVE toggled On — This is on by default, but confirm it in Settings.

How to connect​

  1. Log in to Branco with your IT Admin account.
  2. Navigate to Integrations in the sidebar.
  3. Under Slack Bot Integration, click "Enable Branco".
  4. You'll be redirected to Slack's OAuth authorization screen.
  5. Review the permissions requested and click Allow.
  6. You'll be redirected back to Branco. The integration status should show as connected.
What permissions does the bot need?

The Branco bot needs permission to send direct messages to users in your workspace. It does not read channel messages, access files, or modify your Slack workspace configuration.

After connecting​

  • The bot will begin sending messages on its configured cadence (weekly for peer feedback, biweekly for self-reflections).
  • It may take a few days before the first round of messages goes out, depending on the schedule.
  • You can verify it's working by checking the Feedback Hub for incoming responses after the first cycle.

Next: BambooHR Integration →