Slack Setup

Slack Setup

Add your AI agent to Slack workspaces for team-based conversations.

Setup steps

1. Create a Slack app

1. Go to api.slack.com/apps
2. Click Create New App → From scratch
3. Give it a name and select your workspace

2. Configure bot permissions

1. Go to OAuth & Permissions in the sidebar
2. Under Bot Token Scopes, add:
   • chat:write — send messages
   • app_mentions:read — respond when mentioned
   • channels:history — read channel messages (optional)
   • im:history — read direct messages
   • im:write — send direct messages

3. Install to workspace

1. Go to Install App in the sidebar
2. Click Install to Workspace and authorize the permissions
3. Copy the Bot User OAuth Token (starts with xoxb-)

4. Enable events

Deployments stay private by default. If you selected Slack on DigitalOcean or Google Cloud, the deployment opens public 443 for webhook routes only. Other providers need a separate public HTTPS entrypoint in front of the deployment.

1. Go to Event Subscriptions and toggle Enable Events on
2. Set the Request URL to: https://YOUR_WEBHOOK_DOMAIN/webhook/slack/YOUR_DEPLOY_ID
3. Under Subscribe to bot events, add:
   • message.im — direct messages
   • app_mention — when someone mentions your bot

5. Connect in the wizard

1. On the wizard's messaging screen, select Slack
2. Paste your Bot User OAuth Token
3. After deploy, finish the channel checks from the management dashboard

Using the bot

• Direct messages — just message the bot directly
• Channels — invite the bot to a channel and mention it with @botname
• Threads — the bot can reply in threads for organized conversations

Tips

• In App Home settings, enable the Messages Tab so users can DM your bot
• Add a bot description and profile picture under Basic Information
• Use Slash Commands if you want to add custom /commands