As you set up the Slack integration, you will need to provide an Atlan Slack app permissions in Slack. Note the following:
- Atlan does not store any data for Slack messages. Slack messages are fetched on demand.
- Atlan connects to Slack via Slack APIs, and stores the following metadata to send messages on behalf of users — username, channel name, tenant name, refresh token, and access token.
- Atlan does not store any personally identifiable information of users.
Here is what Atlan does with each of those permissions:
What will Atlan be able to view?
Content and info about you
- View profile details about people in your workspace (
users.profile:read
) - View information about your identity
Atlan requires these permissions to:
- Show rich Slack message previews within Atlan (for example, a user's profile picture)
Content and info about channels & conversations
- View messages and other content in your public channels (
channels:history
) - View basic information about public channels in your workspace (
channels:read
) - View Atlan URLs in messages (
links:read
) - View messages and other content in public channels that Atlan has been added to (
channels:history
)
Atlan requires these permissions to:
- Show rich Slack message previews within Atlan (the message itself, the channel where it was posted)
Content and info about your workspace
- View people in your workspace (
users:read
) - View profile details about people in your workspace (
users.profile:read
) - View email addresses of people in your workspace (
users:read.email
)
Atlan requires these permissions to:
- Show rich Slack message previews within Atlan (for example, a user's profile picture)
- Send notifications about requests made in Atlan (
users:read.email
)
What will Atlan be able to do?
Perform actions in channels and conversations
- Show previews of Atlan URLs in messages (
links:write
) - Send messages as
@atlan
(chat:write
) - Send messages to channels
@atlan
isn't a member of (chat:write.public
) - Add and edit emoji reactions
- View messages that directly mention
@atlan
in conversations that the app is in - Upload, edit, and delete files as Atlan (
files.write
)
Atlan requires these permissions to:
- Unfurl Atlan links (show previews for them) within Slack
- Allow the Slack share button on Atlan assets to work (sending messages to Slack as
@atlan
) - Search Atlan from any Slack channel and share search results to the channel, all from within Slack
- Share query output from within Atlan to Slack (
files.write
)
Perform actions in your workspace
- Add shortcuts and/or slash commands that people can use (
commands
)
Atlan requires these permissions to:
- Search Atlan from within Slack (the
/search-term
and/search-query
commands) - Document a Slack conversation into Atlan (using the Slack context menu on any Slack conversation)