Discord

Delivery: Official add-on. 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 access mode.

Groups

Group access, mentions, and sender controls.

Troubleshooting

Cross-channel checks and repair steps.

Quick setup

Open Agents > selected Agent > Channels > Discord and click Install. Restart the Gateway when prompted.
Create a Discord application in the Discord Developer Portal.
Add a Bot user.
Enable Message Content Intent. Enable Server Members Intent only if you need role allowlists or name-to-ID matching.
Invite the bot with bot and applications.commands scopes.
Return to Agent > Channels > Discord.
Paste the bot token, server id, and owner/user id.
Save, then pair the first DM if using pairing.

CLI install:

fased plugins install @fased/discord
fased gateway restart

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

Area	Recommended start
DMs	`dmPolicy: "pairing"`
Servers	`groupPolicy: "allowlist"`
Mentions	required in shared channels
Commands	owner or allowlist first
Agent routing	route 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 controls are working.

Gateway 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

Symptom	Check
Bot sees no messages	Message Content Intent, invite scopes, channel permissions.
DMs do not work	Server privacy setting, pairing state, DM policy.
Server messages ignored	Group policy, mention requirement, allowlists.
Slash commands missing	`applications.commands` scope and command registration logs.
Role routing fails	Server Members Intent and stable role/user ids.

See Channel Troubleshooting for the shared command ladder.

Overview

Common setup

Team and enterprise

Self-hosted and protocol

Optional and legacy

Configuration and behavior

Discord

Discord

Pairing

Groups

Troubleshooting

Quick setup

Access model

Gateway behavior

Useful commands

Troubleshooting

​Discord

Pairing

Groups

Troubleshooting

​Quick setup

​Access model

​Gateway behavior

​Useful commands

​Troubleshooting

​Related

Discord

Quick setup

Access model

Gateway behavior

Useful commands

Troubleshooting

Related