Skip to main content

​
Slack Setup

Connect your Vecbase agent to Slack so your team can chat with it in channels and DMs.

​
Prerequisites

  • A Slack workspace where you have admin permissions
  • A Vecbase agent created

​
Step 1: Create a Slack App

1

Open Slack API

Go to Slack API and click Create New App → From scratch.
2

Name and workspace

  • App Name: e.g., “Vecbase Assistant”
  • Workspace: Select your workspace
3

Enable Socket Mode

Go to Socket Mode in the left sidebar and toggle it On.Create an App-Level Token with connections:write scope. Name it anything (e.g., “socket-token”).Copy the token (starts with xapp-):
xapp-1-A07XXXXXXXX-1234567890123-abcdef...

​
Step 2: Configure Bot Permissions

1

Add bot scopes

Go to OAuth & Permissions → Bot Token Scopes and add:
ScopePurpose
chat:writeSend messages
channels:readList channels
channels:historyRead channel messages
users:readGet user info
files:readRead shared files
files:writeUpload files
reactions:writeAdd reactions
2

Enable events

Go to Event Subscriptions → toggle On.Subscribe to bot events:
  • message.channels — Messages in public channels
  • message.groups — Messages in private channels
  • message.im — Direct messages
  • app_mention — When someone @mentions the bot
3

Install to workspace

Go to Install App → Install to Workspace → Allow.Copy the Bot User OAuth Token (starts with xoxb-):
xoxb-1234567890-1234567890123-AbCdEfGhIjKlMnOpQrStUv

​
Step 3: Connect in Vecbase

1

Open agent settings

Open your agent, tap Settings in the top right, then select Channels.
2

Add Slack channel

Click Add Channel next to Slack.
3

Enter credentials

  • Display Name: A name for this channel (e.g., “Team Workspace”)
  • App Token: The xapp-... token from Socket Mode
  • Bot Token: The xoxb-... token from OAuth
4

Create

Click Create. Status will change to Connected.

​
Step 4: Test

Invite the bot to a channel (/invite @botname) and send a message. The bot will respond. For DMs, find the bot in your sidebar and send a message directly.
Use @botname to mention the bot in channels. By default, the bot only responds when mentioned in group channels.

​
Limitations

LimitValue
File upload1 GB (workspace plan dependent)
Message length40,000 characters