Slack
Connect Clearly AI to Slack.
Getting started
If your IT team manages Slack app installation, share the Clearly AI Slack app manifest with them. The manifest is the source of truth for the bot permissions and event subscriptions the integration requires.
Required bot scopes
These are the required bot scopes from the Slack app manifest under oauth_config.scopes.bot:
| Scope | Purpose |
|---|---|
channels:join | Join public channels when needed |
chat:write | Send messages |
files:read | Read shared files |
links:read | Read links in messages |
app_mentions:read | Read app mentions |
channels:history | Read messages in public channels |
channels:read | Read public channel metadata |
groups:history | Read messages in private channels |
im:history | Read direct messages |
im:write | Send direct messages |
mpim:history | Read group direct messages |
mpim:read | Read group direct message metadata |
reactions:read | Read reactions |
reactions:write | Add reactions |
users:read | Read user profiles |
users:read.email | Read user email addresses |
Required bot events
These are the required bot events from the manifest under settings.event_subscriptions.bot_events:
app_mentionmessage.channelsmessage.imreaction_added
Request URL
The Slack app manifest also includes the event subscription request URL. Your IT team should use the request URL provided for your Clearly AI deployment.
Notes for admins
- The required scopes are the bot scopes listed in the manifest. They are not user scopes.
- If your IT team manages Slack app approvals through Okta or another identity layer, they should still use the Slack manifest as the source of truth for requested permissions.
- If you need the full Slack app manifest, contact Clearly AI support.
Related
- Integrations - Auth patterns and credential scope