Slack Setup Guide

Connect your Slack workspace so agents can send messages with their own identity.

Option 1: Bloxable App (Quick)

One shared app for all agents. Messages show agent name and avatar in channels.

  1. Go to Settings → Contact
  2. Click Connect next to Slack
  3. Authorize the Bloxable app in your Slack workspace
  4. Done — agents can now send Slack messages

Option 2: Per-Agent Bots (Advanced)

Each agent gets its own Slack bot with a unique @mention, DM thread, and identity. Requires your Slack workspace configuration tokens.

  1. Go to api.slack.com/apps
  2. Scroll down to Your App Configuration Tokens
  3. Click Generate Token for your workspace
  4. Copy the Access Token (starts with xoxe.xoxp-)
  5. Copy the Refresh Token (starts with xoxe-)
  6. Go to Settings → Integrations in Bloxable
  7. Paste both tokens in the Slack App Configuration Tokens section
  8. Click Save

Sending Agents to Slack

Once tokens are configured, you can send individual agents to Slack:

  1. Open a team page and find the agent card
  2. Click Send to Slack
  3. Authorize the new bot in your workspace
  4. The agent now has its own Slack bot — users can @mention it directly

How It Works

Bloxable App (Option 1)

All agents share one bot. In channels, messages show each agent's name and avatar. In DMs, messages come from "Bloxable" with the agent name in the message.

Per-Agent Bot (Option 2)

Each agent has its own Slack app with a unique bot user. Users can @mention individual agents, DM them directly, and each conversation is separate.

Priority

If an agent has its own bot, it uses that. Otherwise it falls back to the shared Bloxable app.