Discord

Discord access uses the Discord Gateway so users can DM the bot or mention it in a server channel to query status, control devices, or ask questions; server messages trigger only when the bot is mentioned, while DMs trigger directly.

Usage Modes

Mode	Trigger	Notes
Bot DM	Send text directly to the bot	Good for personal status queries and remote control.
Server channel mention	Mention the bot in a channel and enter a question	Good for communities, developer servers, and team channels.
Long replies	Handled by the Device Agent automatically	Discord has per-message length limits, so long replies are split automatically.

Prepare the Discord App

1. Create an Application in Discord Developer Portal.
2. Open the Bot page and copy or reset the Bot Token.
3. Enable Message Content Intent on the Bot page.
4. Open OAuth2 → URL Generator:
   • Select bot under Scopes.
   • Select View Channels, Send Messages, and Read Message History under Bot Permissions.
5. Open the generated authorization URL and add the bot to the target server.

Do not only install the app from the Installation page. The invite URL must include scope=bot, or the app may not join as a bot.

Configure Device Agent

Open Settings → Channels → Discord and fill in:

Field	.env	Description
Enabled	DISCORD_ENABLED	Starts the Discord channel
Bot Token	DISCORD_BOT_TOKEN	Discord Bot Token
Allow list	DISCORD_ALLOW_FROM	Optional Discord user Snowflake ID allow list

You can also configure it in .env:

DISCORD_ENABLED=true
DISCORD_BOT_TOKEN=your-discord-bot-token
DISCORD_ALLOW_FROM=1234567890,2345678901

Restart the service after saving.

Verify Access

1. Confirm the service has restarted.
2. Check logs for Discord: enabled and Logged in as ....
3. Send a DM to the bot, or send @Device Agent hello in a server channel.
4. If the allow list is enabled, make sure the sender Snowflake ID is included.

Discord has per-message length limits. Long Device Agent replies are split automatically.

Checks

• Used disallowed intents: enable Message Content Intent on the Bot page.
• No server channel response: mention the bot and confirm it can read and send messages.
• Allow list blocks messages: use user IDs, not usernames.