Prerequisites
- Admin access to the Slack workspace you want to connect (or permission to install apps)
- A Modem organization
Setup
Start the connection
Go to Settings → Integrations → Slack in your Modem dashboard and click Connect Slack.
Authorize Modem
You’ll be redirected to Slack to authorize the Modem app. Review the permissions and click Allow.
Modem requests access to read messages in channels and respond to users who interact with the Modem Agent.
Add Modem to channels
Invite the Modem bot to channels you want it to monitor. See Adding Channels below.
Talk to the agent
DM or @mention the Modem bot to ask questions and take action. See Talking to the Agent.
Adding Channels
Modem monitors any channel the bot has been added to. You can add the bot to a channel in a few ways:- Use
/invite @Modemin the channel - Mention
@Modemin the channel - Open the channel’s Members tab and add Modem under Integrations
Recommended Channels
#supportor#help: Customer support requests#feedbackor#suggestions: Feature requests and ideas#bugsor#issues: Bug reports- Slack Connect channels shared with your customers
Channels to Avoid
- Social channels
- Bot notification channels (high noise, low signal)
- Channels with sensitive information
Auto-Join by Channel Prefix
If you use Slack Connect or follow a naming convention for external channels (e.g.#ext-acme, #ext-bigcorp), you can configure Modem to automatically join new public channels that match a prefix.
Go to Settings → Integrations → Slack and enable Auto-join channels. Add one or more prefixes (e.g. ext-, partner-). When a new public channel is created or renamed to match a prefix, Modem will join it automatically.
Auto-join only applies to public channels. Private channels must be added manually.
Talking to the Modem Agent in Slack
The same Modem Agent available on the web is also available directly in Slack. You can DM the Modem bot or @mention it in a channel to ask questions, get summaries, or take action on your data without leaving Slack. You can reach the agent two ways:- Direct message. Open a DM with the Modem bot to start a conversation.
- @mention in a channel. Mention @Modem in any channel where the bot has been added.
The Modem bot must be added to channels where you want to use @mentions.
Who Can Talk to Modem?
Only authorized users can interact with the Modem Agent in Slack. Authorization requires two things:- A linked Modem account. Your Slack identity must be connected to a Modem account. If it isn’t, the bot will prompt you to connect your account.
- Organization membership. You must be a member of the Modem organization connected to that Slack workspace. If your account is linked but you’re not a member, you’ll see an access denied message and need an administrator to invite you.
Auto-Join for Slack Workspace Members
By default, only users who have been invited to your Modem organization can interact with the agent. If you want your whole Slack workspace to have access, you can enable Allow Slack workspace members to join Modem in Settings → Integrations → Slack. When enabled, any member of your Slack workspace can automatically join your Modem organization by linking their Slack account. This is useful if your Slack workspace already represents your team and you don’t want to manage invitations separately.Troubleshooting
Messages aren't appearing
Messages aren't appearing
- Verify the channel is selected in integration settings
- Check that the Modem app is installed in the workspace
- For private channels, ensure Modem has been added to the channel
- Allow a few minutes for initial sync to complete
Historical messages are missing
Historical messages are missing
Slack API limits historical access to approximately 90 days for free workspaces and 10,000 messages for paid workspaces. Modem can only access what Slack makes available.
User emails aren't showing
User emails aren't showing
User email visibility depends on workspace settings. If your workspace restricts email visibility, Modem won’t be able to access them.
Disconnecting
To disconnect Slack:- Go to Settings → Integrations → Slack
- Click Disconnect
- Go to your Slack workspace settings
- Navigate to Apps
- Find Modem and click Remove