Slack Channel Configuration
Connect your Memoh bot to Slack to receive direct messages, join channels and threads, read attachments, send files, and reply with streaming.
Prerequisites
- A Slack workspace you can install apps into, and access to the Slack API dashboard.
- A Memoh bot; channels are configured from its Platforms tab.
Steps
1. In the Slack console, create an app
- Go to the Slack API dashboard and create a new app.
- Choose the workspace where you want to install the bot.
TIP
Keep the app settings page open — steps 2 through 5 all happen there.
2. In the Slack console, enable Socket Mode
Memoh's Slack adapter uses Socket Mode, so you need an app-level token in addition to the bot token.
- In Basic Information, enable Socket Mode.
- Create an App-Level Token with the
connections:writescope. - Copy the generated token. It starts with
xapp-.
3. In the Slack console, add bot token scopes
In OAuth & Permissions, add the bot token scopes required by the Slack adapter:
app_mentions:read- receive bot mentions in channelschannels:history- read messages in public channelsgroups:history- read messages in private channelsim:history- read direct messagesmpim:history- read group direct messageschat:write- send replies and thread messagesfiles:read- read uploaded files and imagesfiles:write- upload outbound filesreactions:write- add and remove reactions
Also add these recommended scopes if you want Slack conversation names and metadata to show up more completely in Memoh:
channels:readgroups:readim:readmpim:read
4. In the Slack console, subscribe to bot events
In Event Subscriptions, enable bot events and add the inbound event types the Slack adapter handles:
app_mentionmessage.channelsmessage.groupsmessage.immessage.mpim
5. In the Slack console, install the app to your workspace
- In OAuth & Permissions, click Install to Workspace.
- Review the permission screen and authorize the app.
- Copy the Bot User OAuth Token. It starts with
xoxb-.
6. In Memoh, add the Slack channel
- Open your bot's detail page and go to the Platforms tab.
- Click Add Channel and select Slack.
- Fill in:
- Bot Token: your
xoxb-...token - App-Level Token: your
xapp-...token
- Bot Token: your
- Click Save and Enable.
7. In Slack, add the bot to conversations
After the channel is enabled, the Slack app still needs to be present in the conversations where you want it to work:
- Direct messages: open a DM with the app and send a message.
- Public channels: invite the bot to the channel.
- Private channels: invite the bot explicitly after installation.
Credentials
| Field | Description |
|---|---|
| Bot Token | The Bot User OAuth Token (xoxb-...) copied after installing the app to the workspace. |
| App-Level Token | The Socket Mode token (xapp-...) created with the connections:write scope. |
Both tokens must come from the same Slack app and workspace.
Verify
Invite the bot to a channel and @mention it with /help, or send /help in a DM with the app. If the bot replies with its command list, the channel is working.
Group chats
Slack channels are supported. Invite the bot to a public or private channel, then @mention it to talk to it there. Replies can continue in threads — Slack is the only channel with thread support.
Disable and rotate credentials
You can disable or remove this channel at any time from the bot's Platforms tab. To rotate credentials, update the Bot Token and App-Level Token fields and save.
FAQ
Why does Slack need two tokens?
Memoh's Slack adapter uses Socket Mode: the xapp-... app-level token is required in addition to the xoxb-... bot token, and both must come from the same Slack app and workspace.
The bot can send messages but cannot read uploaded images or files
Check that the files:read scope is enabled.
The bot connects but receives no incoming messages
Check the bot events in Event Subscriptions and the matching history scopes again.