Slack Bot Setup

Create one Slack app, issue the required tokens, and run onboarding. These steps are adapted from docs/SLACK_SETUP.md.

1) Create a Slack app

Open Slack App Dashboard.
Click Create New App and choose From scratch.
Name the app (for example, Discode Bot) and pick your workspace.

2) Enable Socket Mode and issue app token

Open Socket Mode in the app sidebar and turn it on.
Create an App-Level Token with connections:write.
Copy and store the xapp-... token safely.

3) Configure Bot Token Scopes

In OAuth & Permissions - Bot Token Scopes, add:

Scope	Why it is needed
`chat:write`	Send bot messages to channels.
`channels:history`	Read messages in public channels.
`channels:read`	List available channels.
`channels:manage`	Create and archive project channels.
`groups:read`	Read private channel metadata.
`files:read` / `files:write`	Receive and upload files.
`reactions:read` / `reactions:write`	Handle approval reactions.

4) Enable events and install to workspace

Enable Event Subscriptions and add message.channels.
Open Install App and click Install to Workspace.
Copy the xoxb-... Bot User OAuth Token.

Socket Mode handles event delivery, so you do not need a Request URL for events.

5) Run onboarding and verify

discode onboard --platform slack
discode config --show
discode new

Or pass tokens directly in non-interactive environments:

discode config --platform slack \
  --slack-bot-token xoxb-your-bot-token \
  --slack-app-token xapp-your-app-token

Never commit or share xoxb-... and xapp-... tokens.

Quick reference card

1. Create app at api.slack.com/apps
2. Enable Socket Mode and copy xapp token
3. Add required Bot Token Scopes
4. Enable Event Subscriptions: message.channels
5. Install app and copy xoxb token
6. Run discode onboard --platform slack
7. Start with discode new