The Slack integration connects a Slack workspace to your org so that emoji reactions on messages can automatically append content to a doc's task list.
Installing the Slack app¶⎘
Navigate to /o/<org>/slack. If no Slack workspace is installed yet, click Install Slack. This sends you through Slack's OAuth flow; once you authorize, Slack redirects back to the same page with a confirmation banner showing the connected team name. At most one Slack workspace can be active per org at a time.
Reaction routes¶⎘
A reaction route maps a (workspace, emoji) pair to a specific doc. When a Slack member adds the configured emoji reaction to any message, the bot appends the message text as a new item in the doc's task list. Routes are scoped to an mds workspace--the workspace determines which docs are eligible targets.
Adding a route¶⎘
The Add a route form is below the routes table on /o/<org>/slack. Required fields:
- Workspace--an mds workspace in this org (dropdown, filtered to workspaces you belong to).
- Emoji--the reaction emoji name without colons (e.g.
todo). Colons are stripped automatically if included. - Doc--the target doc, entered as a ULID or a full doc URL. The doc must belong to the selected workspace.
- List key--optional. Names the specific task list in the doc to append to. If omitted, the bot appends to the first task list it finds.
Click Add route to save. The page reloads and the new route appears in the table.
Editing a route¶⎘
Each row in the routes table has an Edit button. Clicking it prefills the add-route form with the route's current values. The workspace and emoji fields are disabled during editing--they identify the route, and changing either requires removing the route and adding a new one. Edit the doc or list key, then click Update route. Click Cancel to restore the form to add mode without saving.
Removing a route¶⎘
Each row has a Remove button. Clicking it shows a confirmation prompt; confirming deletes the route immediately. The page reloads and the row disappears.
Reinstalling¶⎘
Once an active installation exists, the page shows Reinstall Slack instead of Install Slack. Clicking it runs Slack's OAuth flow again and refreshes the integration's access for this org. Use this if the bot loses access to the workspace or if a Slack admin reinstalls the app on Slack's side.