Slack

Create a Slack app

You create a Slack app, grant bot scopes and choose one of two transport modes. Takes about 10 minutes.

1. Create the app

1. Open api.slack.com/apps → Create New App → From scratch.
2. Pick a name + workspace → Create App.

2. Set bot scopes

Left sidebar → OAuth & Permissions → Scopes → Bot Token Scopes → add these: app_mentions:read, chat:write, reactions:write, im:history, channels:history, groups:history, mpim:history, users:read.

3. Install & get the bot token

1. At the top, click Install to Workspace → Allow.
2. Copy the Bot User OAuth Token (starts with xoxb-) → paste below as Bot User OAuth Token.

4. Choose a transport

Option A — Events API (for production, public HTTPS host)

1. Basic Information → App Credentials → copy the Signing Secret → field Signing Secret.
2. Set the Public HTTPS Base-URL field (e.g. https://bot.example.com).
3. Left sidebar → Event Subscriptions → Enable → Request URL: <your-base-url>/api/slack/events (must be reachable, Slack verifies immediately).
4. Subscribe to bot events: app_mention, message.im, message.channels, message.groups, message.mpim → Save Changes.

Option B — Socket Mode (local / behind a firewall, no public host)

1. Leave Public HTTPS Base-URL empty.
2. Basic Information → App-Level Tokens → Generate Token with scope connections:write → copy → field App-Level Token (xapp-…).
3. Left sidebar → Socket Mode → Enable.
4. Event Subscriptions → subscribe to the same bot events as above (no Request URL needed).

5. Invite the bot to channels

Run /invite @YourBot in each channel you want. DMs work without an invite (if Allow direct messages is on).