Documentation
Slack
Connect Slack so @dispatcher mentions create tasks for your organization.
Canonical HTML: https://getdispatcher.dev/help/slack
Turn Slack messages into Dispatcher tasks by mentioning @dispatcher.
Connect Slack
- Sign in to the Dispatcher desktop app and select an organization
- Open Settings → Slack
- Click Connect Slack and approve the install in your browser
- 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 the task. Agents still run locally in Dispatcher worktrees.
Slack intake is metered by plan (UTC month). Basic can create 5 tickets from Slack each month; Plus, Pro, and Enterprise raise that cap. Mentions after the cap get a reply in-thread instead of a new task. Duplicate Slack events and bot messages do not count.
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, or to pick up new bot scopes such as users:read) |
| Disconnect | Unlinks Slack from your organization |
After reconnecting, task descriptions show Slack display names instead of raw user ids (U0…).
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 use Sync or Reconnect if the workspace is not registered |
| Authorized but mentions ignored | 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 |
| Connected but still silent | Invite the bot with /invite @dispatcher, then mention it again |
| Duplicate replies for one mention | Fixed server-side (idempotent event claim). Delete any leftover duplicate tasks. |
Task shows <@U…> instead of a name | Reconnect Slack so the bot gets the users:read scope |
| 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 |
| Task link opens but desktop app does not | Safari “address is invalid” means dispatcher:// is not registered. Install/update the desktop app to 0.1.31+ from Download, open it once from Applications, then retry. Being signed in on the website does not launch the app. Check Dispatcher → About (or the dock icon version); the download page version can be ahead of the DMG you actually have. |