BotMux provides native Slack bridge support with full Events API and Web API integration.
Setup
1. Create a Slack App
Go to api.slack.com/apps → Create New App → From scratch.
Navigate to OAuth & Permissions → Scopes → Bot Token Scopes:
| Scope | Purpose |
|---|
chat:write | Send messages to channels |
users:read | Resolve user display names |
channels:history | Receive messages from public channels |
groups:history | Receive messages from private channels |
im:history | Receive direct messages |
mpim:history | Receive group DMs |
3. Install App to Workspace
Click Install to Workspace and authorize. Copy the Bot User OAuth Token (xoxb-...).
4. Get the Signing Secret
Go to Basic Information → App Credentials → copy the Signing Secret.
5. Create a Bridge in BotMux
- Select a bot → Bridges → Add Bridge
- Set Protocol to
Slack
- Set Config:
{
"bot_token": "xoxb-your-bot-token",
"signing_secret": "your-signing-secret"
}
- Enable and save
- In Slack App settings → Event Subscriptions → Enable Events
- Set Request URL:
https://your-botmux-host/bridge/{id}/incoming
- Subscribe to bot events:
message.channels, message.groups, message.im, message.mpim
- Save
HTTPS is required — Slack does not accept HTTP endpoints.
7. Invite the Bot
Security
Requests are verified using HMAC-SHA256 signature (X-Slack-Signature header) with 5-minute replay attack protection. 
