Skip to main content
The Slack integration captures messages from your Slack workspace (you choose which channels) and lets your team interact with the Modem Agent directly from Slack.

Prerequisites

  • Admin access to the Slack workspace you want to connect (or permission to install apps)
  • A Modem organization

Setup

1

Start the connection

Go to SettingsIntegrationsSlack in your Modem dashboard and click Connect Slack.
2

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.
3

Add Modem to channels

Invite the Modem bot to channels you want it to monitor. See Adding Channels below.
4

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 @Modem in the channel
  • Mention @Modem in the channel
  • Open the channel’s Members tab and add Modem under Integrations
  • #support or #help: Customer support requests
  • #feedback or #suggestions: Feature requests and ideas
  • #bugs or #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 SettingsIntegrationsSlack 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.
A few examples of what you can do:
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:
  1. 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.
  2. 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 SettingsIntegrationsSlack. 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

  • 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
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 email visibility depends on workspace settings. If your workspace restricts email visibility, Modem won’t be able to access them.

Disconnecting

To disconnect Slack:
  1. Go to SettingsIntegrationsSlack
  2. Click Disconnect
This stops new data from being captured. Historical data remains in Modem. To fully remove Modem from your Slack workspace:
  1. Go to your Slack workspace settings
  2. Navigate to Apps
  3. Find Modem and click Remove