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: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. |
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… | Sync reactions so everyone sees 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: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. |