Connect Slack

Create a Slack app

Go to api.slack.com/apps, click Create New App → From scratch, name it (e.g. Buda Assistant), choose your workspace, and click Create App.

Enable Socket Mode and get the app-level token

Open Socket Mode and toggle it on. When prompted, create an app-level token: name it (e.g. buda-socket), add the connections:write scope, and Generate. Copy the token — it starts with xapp-.

Add bot token scopes

Go to OAuth & Permissions → Bot Token Scopes and add:

• app_mentions:read — receive @mentions in channels
• channels:history — read channel history
• chat:write — send messages
• im:history, im:read, im:write — read and open DMs
• users:read — resolve display names

Subscribe to events

Open Event Subscriptions, toggle Enable Events, and under Subscribe to bot events add app_mention and message.im. Click Save Changes.

Install and get the bot token

Back in OAuth & Permissions, click Install to Workspace and authorize. Copy the Bot User OAuth Token — it starts with xoxb-.

Configure the channel in Buda

Open Settings → Channels, click Add Channel, and select Slack. Paste both tokens — Bot User OAuth Token (xoxb-) and App-Level Token (xapp-) — optionally set a label and target agent, then click Connect.

Start chatting

• In a channel: invite the bot with /invite @YourBotName, then @mention it.
• In a DM: open a direct message and send anything — no @mention needed.