Chat on Slack
Slack is a natural home for your agent if your team already uses Slack for daily work. Your agent can respond in DMs or be mentioned in channels.
How to connect
Section titled “How to connect”- In the dashboard, go to Settings → Integrations → Slack and click Add to Slack.
- Slack’s OAuth screen opens. Pick the workspace you want your agent in and click Allow.
- Done. The bot is now in your Slack workspace.
Slack installation gives us scoped permissions: read messages in channels it’s mentioned in, send messages, upload files, and respond to slash commands. We do NOT request access to DMs between other users, or to channels the bot wasn’t added to.
How to use it
Section titled “How to use it”Direct message the agent
Section titled “Direct message the agent”From Slack, click the “Apps” section in the sidebar, find your agent, and click to open a DM. Everything you send in that DM goes directly to your agent.
Mention in a channel
Section titled “Mention in a channel”Invite the bot to a channel: /invite @MyAgent. Then mention it with @MyAgent followed by your message:
@MyAgent can you summarize the thread above and post it to #general?
Slash commands
Section titled “Slash commands”/myagent <message>— send a message without opening a DM/myagent-approve— approve the next pending action/myagent-deny— deny the next pending action/myagent-status— check if your agent is online
What works on Slack
Section titled “What works on Slack”| Feature | Works? |
|---|---|
| Text in either direction | Yes |
| Slack-native formatting (mrkdwn) | Yes |
| File uploads | Yes (both directions) |
| Code blocks | Yes |
| Images | Yes |
| Threads | Yes — your agent keeps thread context properly |
| Emoji reactions | Yes (including for approvals) |
| Interactive buttons | Yes for approvals |
Thread-first etiquette
Section titled “Thread-first etiquette”Slack is thread-heavy, and your agent handles this well. If you reply to an existing thread to talk to your agent, it’ll keep the context of that thread separate from other conversations. This is important for team environments — you don’t want your private conversation leaking into channel noise.
Team usage
Section titled “Team usage”If multiple team members talk to the agent in a shared channel, only the workspace owner’s agent is used by default. To let each team member talk to their own agent from the same Slack workspace, you’ll need team accounts — email us if you’re interested, we’re working on this.
For now, the simplest setup for teams: give each team member their own individual account, and each person DMs their own agent from their personal Slack.
Disconnecting
Section titled “Disconnecting”Settings → Integrations → Slack → Remove from workspace. Also revokes all Slack permissions immediately.
Troubleshooting
Section titled “Troubleshooting”“My agent isn’t responding in the channel” — Make sure the bot was invited to the channel (/invite @MyAgent). Slack bots can only see messages in channels they’re members of.
“OAuth failed during installation” — Try again in an incognito window, or make sure you’re logged in to the right Slack workspace as a user with permission to install apps.
“Slash commands returned an error” — Usually means the bot’s deployment is briefly restarting. Wait 30 seconds and try again.