Slack
Connect Slack for real-time conversation. Your agent appears as a bot in your workspace.
How it works
Section titled “How it works”Your agent joins Slack as a bot user. Mention it to wake it up:
@yourbot can you summarize today's emails?The agent sees the message, processes it, and replies in the thread.
Unlike email (which runs one turn per message), Slack enables back-and-forth conversation in real time.
-
Upgrade to Tiny tier
Slack integration is included in the $5/month Tiny plan.
-
Create a Slack app
Go to api.slack.com/apps and create a new app.
-
Configure bot permissions
Your bot needs these OAuth scopes:
chat:write— Send messagesapp_mentions:read— See when mentionedchannels:history— Read channel messagesgroups:history— Read private channel messagesim:history— Read direct messagesusers:read— Look up user info
-
Install to workspace
Install the app to your Slack workspace and copy the Bot User OAuth Token.
-
Add token to TinyFat
Dashboard → Settings → Integrations → Slack Bot Token
-
Configure webhook URL
In your Slack app settings, add Event Subscriptions:
- Request URL:
https://tinyfat.com/api/slack/events - Subscribe to:
app_mention,message.im
- Request URL:
Features
Section titled “Features”Real-time responses
Section titled “Real-time responses”Unlike email, Slack shows responses as they stream in. You see the agent thinking in real time.
Thread context
Section titled “Thread context”The agent reads the full thread context when replying. Continue conversations naturally.
File sharing
Section titled “File sharing”Share files in Slack and the agent can access them:
@yourbot analyze this spreadsheet[attached: data.csv]Channel awareness
Section titled “Channel awareness”The agent knows which channel it’s in and can adjust behavior accordingly.
Commands
Section titled “Commands”Same commands work in Slack:
| Command | Effect |
|---|---|
/clear | Start fresh session |
/resume | List recent sessions |
/model haiku | Switch models |
Just @mention the bot with the command.
Limitations
Section titled “Limitations”Rate limits
Section titled “Rate limits”Slack has API rate limits. If your agent sends too many messages quickly, it may be throttled.
No background execution
Section titled “No background execution”The agent only responds when mentioned. It doesn’t monitor channels passively.
Single workspace
Section titled “Single workspace”Currently, each agent can only be connected to one Slack workspace.
Security
Section titled “Security”Private by default
Section titled “Private by default”The agent only sees messages where it’s @mentioned or in DMs. It doesn’t have access to all workspace messages.
Token storage
Section titled “Token storage”Your Slack bot token is encrypted at rest, same as your API keys.
Troubleshooting
Section titled “Troubleshooting”Bot not responding
Section titled “Bot not responding”- Check the bot is in the channel (
/invite @yourbot) - Verify event subscriptions are configured
- Check dashboard for errors
Duplicate messages
Section titled “Duplicate messages”This can happen if event delivery retries. The agent should deduplicate, but if it persists, check webhook configuration.