Messaging
Slack
Post and manage Slack messages from Atlas.
What this connector does
- Post Atlas task and project notifications into selected Slack channels.
- Let users turn any Slack message into an Atlas task with the message action menu.
- Sync slash commands so /atlas can create tasks or lookups from any channel.
- Mirror channel membership so notifications respect Slack workspace privacy.
Before you begin
- You are an owner or administrator of your Atlas workspace.
- You can sign in to your Slack account and approve access for Atlas.
- Atlas looks after the Slack app on its side, so there is nothing for you to create or copy.
How to connect
Open Slack in Integrations
In Atlas, open Integrations and select Slack.
Press Connect
Atlas sends you to Slack to sign in. Sign in with the account you want to connect.
Approve access
Review the permissions that Slack lists and approve them. Atlas returns you to the connector page, which then shows the connection.
Check the connection
Select Test connection on the connector page. A passing result means Atlas can read from Slack.
Permissions Atlas asks for
channels:readchannels:historychannels:managegroups:read groups:historygroups:writechat:writefiles:writereactions:write pins:write bookmarks:writesearch:readusergroups:readteam:readusers:readusers:read.emailcommandsSetup checklist
- Confirm you are an owner or administrator of your Atlas workspace.
- Open Integrations and select the connector.
- Press Connect and sign in to Slack.
- Review the permissions that Slack lists and approve them.
- Select Test connection and read the result.
Troubleshooting
not_in_channel
The Atlas bot must be invited into a private channel before it can post. Use /invite @atlas in the channel.
Connect says Slack is not available yet
Atlas has not enabled Slack for this deployment, so there is nothing for you to configure. Check again later.
The sign-in was cancelled
If you close the Slack screen or choose Cancel, Atlas does not connect. Press Connect again and approve the access.
Atlas asks you to reconnect
Slack can end a connection when access is revoked or a password changes. Press Reconnect on the connector page and approve the access again.
Event notifications
Slack sends events to the Atlas Events Request URL, each one signed so that Atlas can check it.
Events Atlas listens for
- message.channels
- app_mention
- message_action: Create Atlas task
- slash_commands: /atlas
Provider docs: https://api.slack.com/events-api
Disconnect and data deletion
- Click Disconnect on the Atlas Slack connector page to revoke the bot's saved sign-in.
- Open the Slack app directory, find Atlas, and click Remove app for the workspace.
- Atlas deletes locally cached channel and user metadata within 24 hours of disconnect.
When you are ready, open the live connector page and press Connect to finish connecting Slack.
Open the Slack connector page