Skip to main content

Slack

Slack connects Fased to a hosted workspace through a Slack app. Fased supports Socket Mode and HTTP Events API mode, then applies the same pairing, allowlist, mention, and task ownership rules as other channels. Status: supported for DMs and channels. Socket Mode is the recommended default.

Pairing

DMs can start in pairing mode.

Groups

Channel mention and sender policy.

Slash commands

Command behavior and catalog.

Quick setup

Socket Mode avoids public inbound exposure.
  1. Create a Slack app.
  2. Enable Socket Mode.
  3. Create an App Token with connections:write.
  4. Install the app and copy the Bot Token.
  5. Subscribe to message, mention, reaction, and membership events you need.
  6. Open Agents > selected Agent > Channels > Slack.
  7. Paste App Token and Bot Token, choose Socket Mode, save, and restart if needed.
Config shape:
{
  channels: {
    slack: {
      enabled: true,
      mode: "socket",
      appToken: "xapp-...",
      botToken: "xoxb-...",
      dmPolicy: "pairing",
      groupPolicy: "allowlist",
    },
  },
}
HTTP mode is available when you have a public HTTPS endpoint and Slack Signing Secret configured.

Slack app checklist

Typical bot events:
  • app_mention
  • message.channels
  • message.groups
  • message.im
  • message.mpim
  • reaction_added
  • reaction_removed
Also enable App Home messages if you want Slack DMs.

Access model

AreaRecommended start
DMspairing
Channelsallowlist plus mention requirement
Commandsowner or allowlist first
Routesexplicit Agent route per channel/thread when needed

Runtime behavior

  • Socket Mode keeps a private outbound connection to Slack.
  • HTTP mode accepts Slack events at the configured endpoint.
  • Threads keep route/session context.
  • Slash commands share the normal command authorization path.
  • Task commands create Agent-owned Tasks.

Troubleshooting

SymptomCheck
No events arriveSocket Mode, App Token, event subscriptions, app installed.
DMs missingApp Home messages tab and message.im event.
Channel replies ignoredMention requirement, group policy, bot channel membership.
HTTP mode failssigning secret, request URL, public HTTPS endpoint.
Slash commands missingcommand request URL and app reinstall.