Mentioning
@Modem in a channel is the only way to reach the agent in Discord. Unlike the Slack integration, the
Modem bot does not accept direct messages, and it only answers people who have linked a Modem account. See Who Can Talk to
Modem?.Prerequisites
- Permission to add bots to the Discord server you want to connect
- Owner or admin role in your Modem organization
Setup
Start the connection
Go to Settings → Integrations → Discord in your Modem dashboard and click Connect Discord.
Authorize the bot
You’ll be redirected to Discord to authorize the Modem bot. Select the server you want to connect and click Authorize.
Subscribe to channels
Back in Modem, you’ll see a list of channels from your server. Toggle on the channels you want Modem to monitor. See Choosing
Channels below.
Wait for sync
Modem will backfill up to 30 days of message history from your selected channels, then listen for new messages in real time.
Talk to the agent
Mention the Modem bot in any channel it can read to ask questions and take action. See Talking to the
Agent.
Choosing Channels
Channels are not monitored by default. You subscribe to individual channels from Settings → Integrations → Discord, where each channel has a toggle. When you subscribe to a channel, Modem automatically starts a backfill of recent history. Supported channel types:- Text channels
- Forum channels (each post becomes a trackable conversation with its replies)
- Announcement channels
Recommended Channels
#supportor#help: Community support requests#feedbackor#suggestions: Feature requests and ideas#bugsor#bug-reports: User-reported issues- Forum channels for structured discussions and Q&A
Channels to Avoid
- Team-only or moderator channels (unless relevant)
- Bot command channels
- Off-topic or meme channels (high noise, low signal)
Talking to the Modem Agent in Discord
The same Modem Agent available on the web is also available in Discord. Mention@Modem in a channel to ask questions, get summaries, or take action on your data without leaving Discord.
Each mention starts its own reply thread, named after your message, so every question stays a separate conversation. Follow-up messages inside that thread continue it, so you don’t need to mention the bot again. If the bot can’t create a thread, it replies in the channel instead.
Channel subscriptions control what Modem captures. The agent is separate: it responds in any channel the bot has permission to read,
whether or not that channel is toggled on. A plain
@everyone won’t trigger it.Who Can Talk to Modem?
Only authorized users can interact with the Modem Agent in Discord. Authorization requires two things:- A linked Modem account. Your Discord identity must be connected to a Modem account. If it isn’t, go to Profile → Linked Identities in your Modem dashboard and connect Discord.
- Organization membership. You must be a member of the Modem organization connected to that Discord server. If your account is linked but you’re not a member, you’ll need an administrator to invite you.
Because Discord servers are often public, the bot stays silent for unauthorized users instead of replying with a prompt to connect
an account. Nudging every passer-by who pokes at the bot would invite a wave of dummy Modem accounts. Server admins and owners are the
exception: they get a DM explaining how to connect the first time they mention the bot, then at most once a day after that, since
they’re the ones most likely to be setting up the integration. If an admin has DMs closed, the prompt is posted as a reply instead.
Troubleshooting
Bot doesn't respond when I mention it
Bot doesn't respond when I mention it
The bot stays silent rather than explaining why, so work through these in order:
- Confirm you mentioned
@Modemdirectly.@everyoneand plain messages don’t trigger it - Confirm you’re in a channel, not a DM. The bot doesn’t accept direct messages
- Check that your Discord account is linked at Profile → Linked Identities in your Modem dashboard
- Check that you’re a member of the Modem organization connected to this server
- Check that the bot has permission to read and post in the channel, and to create threads
- If you’ve sent several requests in quick succession, wait a minute for the rate limit to reset
Bot isn't capturing messages
Bot isn't capturing messages
- Verify the bot has been added to your server - Check that the channel is toggled on in Settings → Integrations → Discord - For private channels, ensure the bot role has permission to view the channel
Can't see some channels
Can't see some channels
The bot can only see channels it has permission to access. Check: - Channel-specific permission overrides - Category permissions -
Role permissions for the Modem bot
Missing user information
Missing user information
Discord doesn’t expose user email addresses through its API. Person profiles will include username and display name, but not email.
Backfill is taking a long time
Backfill is taking a long time
Backfills process channels sequentially with delays between each to avoid Discord rate limits. High-volume channels with 30 days of
history may take several minutes. Check backfill status in Settings → Integrations → Discord.
Disconnecting
To disconnect a Discord server:- Go to Settings → Integrations → Discord
- Click Disconnect next to the server
- Open your Discord server settings
- Go to Integrations → Bots
- Find Modem and click Remove