Slack

Canonical HTML: https://getdispatcher.dev/help/slack

Turn Slack messages into Dispatcher tasks by mentioning @dispatcher.

Connect Slack

1. Sign in to the Dispatcher desktop app and select an organization
2. Open Settings → Slack
3. Click Connect Slack and approve the install in your browser
4. Invite the bot to channels: /invite @dispatcher

You do not paste tokens or run a local bridge. Connection is one OAuth click; mentions are handled on Dispatcher servers.

Create a task from Slack

In any channel or thread where the bot is invited:

@dispatcher create a task
@dispatcher create a task and work on it
@dispatcher create a task priority high and work on it

The bot replies with a link to open the task in the web app or desktop app. Agents still run locally in Dispatcher worktrees.

What the Settings screen means

Control	Meaning
Connect Slack	Installs the Dispatcher Slack app into your workspace and links it to your current organization
Reconnect Slack	Runs OAuth again (e.g. after permissions change)
Disconnect	Unlinks Slack from your organization

Troubleshooting

Problem	Fix
Connect button disabled	Sign in and select an organization first
Bot never replies	Run /invite @dispatcher in the channel; in Settings → Slack confirm “Cloud registration OK” (use Sync or Reconnect if missing)
Authorized but mentions ignored	Open Settings → Slack diagnostics: if Last Slack event is never, turn Socket Mode Off, set Event Subscriptions Request URL to https://getdispatcher.dev/api/slack/events, subscribe to app_mention, then Reconnect Slack
Request URL challenge fails	Socket Mode must be Off; SLACK_SIGNING_SECRET must match the app’s Signing Secret
Cloud OK but still silent	Invite the bot with /invite @dispatcher; check Settings for Last mention error
OAuth redirect error	Restart Connect from the app; don’t edit the callback URL by hand
Agent doesn’t launch	Open the task in the desktop app and run an agent

Related

• Integrations overview
• Support