Connecting Slack
Install Vibey as a Slack bot in your workspace so agents can respond to DMs and channel mentions.
Prerequisites
- A Vibey account with at least one agent
- Admin access to a Slack workspace (or permission to install apps)
Installation
Open Agent Settings
Go to your agent's card in the Team page and find the Communication tab.
Click Connect Slack
Click the Slack connect button. You'll be redirected to Slack's OAuth screen.
Authorize the App
Review the permissions and click Allow. Vibey requests access to read messages, post replies, and view workspace members.
Map a Channel (Optional)
After installation, you can map the bot to a specific Slack channel. This means messages in that channel are routed directly to your agent without needing @Vibey.
What Happens on Install
When you install Vibey to Slack:
- Workspace members are synced Vibey fetches all workspace members (names, roles, avatars, timezones) so the agent can address people by name from the first message.
- A welcome DM is sent the person who installed the bot gets a welcome message in Slack.
- The webhook is registered Slack starts sending message events to Vibey.
Permissions
Vibey requests these Slack scopes:
| Scope | What it does |
|---|---|
app_mentions:read | Receives @Vibey mentions in channels |
assistant:write | Lets Vibey act as a Slack App Agent |
bookmarks:read, bookmarks:write | Reads and manages channel bookmarks |
channels:history | Reads recent channel messages for context when mentioned |
channels:read | Lists available channels for mapping |
chat:write | Posts replies and threaded messages |
chat:write.public | Posts to channels Vibey hasn't been added to |
commands | Adds slash commands and shortcuts |
files:read, files:write | Reads shared files and uploads attachments |
groups:history, groups:read | Handles private channels Vibey is added to |
im:history, im:read, im:write | Handles direct messages |
links:read, links:write | Reads URLs in messages and renders link previews |
mpim:history, mpim:read | Handles group direct messages |
reactions:read, reactions:write | Adds/removes emoji reactions (processing indicators) |
remote_files:read | Views remote files added by Vibey |
search:read.files | Searches files across the workspace |
search:read.im, search:read.mpim | Searches direct and group DM content |
search:read.private, search:read.public | Searches private and public channel content |
users:read | Syncs workspace member profiles |
How It Works
- DMs to the bot routed to the connected agent. Each person's DM is a separate conversation.
@Vibeyin a channel the agent sees the mention plus the last 10 messages for context. Replies go in a thread.- Thread replies follow-ups in the same thread continue the conversation.
Disconnecting
Go to the agent's Communication tab and click Disconnect. This removes the webhook but does not uninstall the Slack app from your workspace. You can do that from Slack's App Management settings.