Skip to main content

​
Discord

Discord connects Fased through the official Discord bot APIs. Use it when you want a public bot identity, DMs, server channels, slash commands, and mention-gated team routing. Status: supported for DMs and guild channels.

Pairing

DMs start with pairing unless you choose another policy.

Groups

Group policy, mentions, and sender controls.

Troubleshooting

Cross-channel checks and repair steps.

​
Quick setup

  1. Create a Discord application in the Discord Developer Portal.
  2. Add a Bot user.
  3. Enable Message Content Intent. Enable Server Members Intent only if you need role allowlists or name-to-ID matching.
  4. Invite the bot with bot and applications.commands scopes.
  5. Open Agents > selected Agent > Channels > Discord.
  6. Paste the bot token, server id, and owner/user id.
  7. Save, start or restart the gateway, then pair the first DM if using pairing.
Scripted setup can use config: 
{
  channels: {
    discord: {
      enabled: true,
      token: "DISCORD_BOT_TOKEN",
      dmPolicy: "pairing",
      groupPolicy: "allowlist",
      requireMention: true,
    },
  },
}
Do not paste bot tokens into Chat or channel messages. Store them from Agent > Channels, config, or secrets.

​
Access model

AreaRecommended start
DMsdmPolicy: "pairing"
ServersgroupPolicy: "allowlist"
Mentionsrequired in shared channels
Commandsowner or allowlist first
Agent routingroute server/channel/thread to the selected Agent explicitly
Discord servers should start narrow: one private test server, one allowed user, and mention-gated channels. Widen access after the route and command policy are working.

​
Runtime behavior

  • DMs and guild messages route into Agent sessions.
  • Threads and forum channels keep their own session shape.
  • Slash commands use the same command authorization path as other channels.
  • Task commands create Agent-owned Tasks; Discord does not own the task.
  • Delivery can return to the same channel/thread or an explicit target.

​
Useful commands

fased gateway
fased channels status discord
fased pairing list discord
fased pairing approve discord <CODE>
fased logs --follow

​
Troubleshooting

SymptomCheck
Bot sees no messagesMessage Content Intent, invite scopes, channel permissions.
DMs do not workServer privacy setting, pairing state, DM policy.
Server messages ignoredGroup policy, mention requirement, allowlists.
Slash commands missingapplications.commands scope and command registration logs.
Role routing failsServer Members Intent and stable role/user ids.
See Channel Troubleshooting for the shared command ladder.