Discord
Connect Discord when you want an agent available in Discord direct messages or servers.
Prerequisites
- An existing Cloud Agents agent.
- Permission to create a Discord application.
- Permission to invite the bot to the target server.
Create the Discord application
- Open the Discord Developer Portal.
- Create a new application.
- Open Bot and create a bot user.
- Reset and copy the bot token.
- Enable Message Content Intent under Privileged Gateway Intents.
Message Content Intent is required. Without it, Cloud Agents can connect the bot but cannot read user prompts.
Invite the bot
Open OAuth2 URL Generator:
- Select the
botscope. - Select these bot permissions:
| Permission | Why |
|---|---|
| View Channels | Let the bot see messages in target channels. |
| Send Messages | Send agent replies. |
| Read Message History | Read message context delivered by the Gateway. |
Copy the generated URL, open it, and invite the bot to the server.
Connect it to Cloud Agents
- Open Settings -> Channels.
- Create a new channel and choose Discord.
- Select the agent that should receive messages.
- Enter a label and paste the bot token.
- Optionally restrict the channel to specific servers.
- Create the channel.
- Run the channel test.
Discord does not require you to paste an inbound URL into Discord.
Recommended settings
| Setting | Recommendation |
|---|---|
| Allowed servers | Restrict to known server IDs when the bot is invited to multiple servers. |
| Mention only | Keep on for servers so the agent replies only when mentioned. DMs still work. |
| Shared session | Keep off unless everyone in the server channel should share one conversation. |
| Progress mode | Use preview if you want one message updated while the agent works. |
Verify
Open the channel detail page and run Test. A healthy channel confirms the bot identity and Message Content Intent status.
Troubleshooting
- Message Content Intent is disabled: enable it in the Developer Portal, then test the channel again.
- Bot connects but ignores server messages: mention the bot or turn off mention-only mode.
- Messages from a server are ignored: check the allowed server list.
- Bot cannot send replies: re-invite it with View Channels, Send Messages, and Read Message History permissions.