Slack permissions
convly requests the minimum permissions needed for cross-platform interoperability.
| Scope | Description | Use case |
|---|---|---|
app_mentions:read | View messages that directly mention @convly in conversations that the app is in | Capture and route messages where the app is mentioned across connected platforms. |
channels:history | View messages and other content in public channels that convly has been added to | Retrieve message history for sync/continuity across platforms. |
channels:join | Join public channels in a workspace | Auto-join public channels on user request so convly can listen and route messages across platforms. |
channels:manage | Manage public channels that convly has been added to and create new ones | Create/manage channels used for cross-platform discussions. |
channels:read | View basic information about public channels in a workspace | Identify channels available for syncing. |
channels:write.invites | Invite members to public channels | Invite users so participants stay in sync. |
chat:write | Send messages as @convly | Post messages relayed from other platforms. |
chat:write.customize | Send messages as @convly with a customized username and avatar | Preserve richer formatting/identity across platforms. |
commands | Add shortcuts and/or slash commands that people can use | Link channels or initiate conversations via commands. |
files:read | View files shared in channels and conversations that convly has been added to | Read files to sync across platforms. |
files:write | Upload, edit, and delete files as convly | Upload files on behalf of users for cross-platform sharing. |
groups:history | View messages and other content in private channels that convly has been added to | Include private channel history where permitted. |
groups:read | View basic information about private channels that convly has been added to | Map private channels for syncing. |
groups:write | Manage private channels that convly has been added to and create new ones | Set up/adjust private spaces for collaboration. |
im:history | View messages and other content in direct messages that convly has been added to | Sync 1:1 DMs across platforms. |
links:read | View convly.io and conv.ly URLs in messages | Detect links from connected platforms (Teams meetings, files, channels) so they can be unfurled with consistent previews. |
links:write | Show previews of convly.io and conv.ly URLs in messages | Render rich previews for URLs originating from connected platforms instead of generic default cards. |
mpim:history | View messages and other content in group direct messages that convly has been added to | Sync multi-user DMs across platforms. |
mpim:read | View basic information about group direct messages that convly has been added to | Identify MPIMs for syncing. |
reactions:read | View emoji reactions and their associated content in channels and conversations that convly has been added to | Sync reactions so everyone sees them across platforms. |
reactions:write | Add and edit emoji reactions | Mirror reactions added on other connected platforms back into Slack so all participants see them. |
remote_files:read | View remote files added by the app in a workspace | Access remote files referenced in messages. |
remote_files:share | Share remote files on a user's behalf | Share remote files cross-app. |
remote_files:write | Add, edit, and delete remote files on a user's behalf | Manage remote files for interoperability. |
usergroups:read | View user groups in a workspace | Resolve user-group memberships so @mentions of groups reach the right individuals across platforms. |
usergroups:write | Create and manage user groups | Handle mentions consistently across messages. |
users.profile:read | View profile details about people in a workspace | Map identities between platforms. |
users:read | View people in a workspace | Access basic user info for mapping/presence. |