This article walks you through how to integrate Slack with Swyft AI, the permissions (scopes) required, and how user permissions are respected during setup. Swyft AI connects to Slack as a bot, meaning all access is managed by your Slack admins.
1. Overview
Swyft AI connects to Slack as a bot via OAuth, allowing our platform to send messages, create channels, and read user information on your behalf—within the bounds set by your admins. By granting Swyft AI the necessary permissions, you can automate workflows (e.g., posting deal updates or routing important notifications) without extra manual steps.
Important: Swyft AI cannot perform any actions in Slack that your bot doesn’t have permission to do. We do not override your organization’s Slack security settings or channel permissions. Everything is controlled by your Slack admins.
2. Required Scopes
When authorizing Swyft AI to connect to Slack as a bot, you’ll be prompted to grant the following scopes:
chat:write,chat:write.public
Allows the Swyft AI bot to post messages in channels or public conversations.channels:read,channels:manage,channels:join,channels:write.invites
Enables the bot to read channel lists, create/join channels, and send invites—subject to admin-approved settings.groups:read,groups:write,groups:write.invites
Lets the bot read and manage private channels (also called groups), if allowed by your Slack admin.im:write,mpim:write
Lets the bot send direct messages (DMs) or group DMs.users:read,users:read.email
Allows the bot to read basic user information (e.g., display names, email addresses) to ensure accurate tagging and notifications.
Why these scopes?
Posting & Managing Channels: Swyft AI can post updates or create dedicated channels to streamline team collaboration—only where the bot is permitted.
Direct Messages: Automatically notify specific users or groups with real-time updates.
User Information: Ensures accurate user mentions and helps identify who should receive notifications.
3. Setting Up the Integration
Go to the Integrations Page in Swyft AI: From your Swyft AI account, navigate to Settings → Integrations.
Click “Connect” Next to Slack: This will open the Slack OAuth permissions screen.
Admin Approval: A Slack Workspace Admin must grant one-time approval for the Swyft AI bot to connect.
You’re All Set: After approval, the Swyft AI bot can post messages, create channels, and manage conversations based on your Slack workspace policies—no extra setup required.
4. Respecting Slack Permissions & Security
Admin-Controlled Bot: All of the Swyft AI bot’s actions in Slack are governed by the permissions your Slack admin grants.
No Overrides: Swyft AI does not bypass Slack security settings or channel restrictions. If a channel is private or restricted, the bot can only access it if your admin has allowed it.
Granular Controls: You can revoke or modify the bot’s access at any time through your Slack Workspace settings.
5. Troubleshooting & FAQs
Q: Why does Swyft AI need all these scopes?
A: Each scope enables specific Slack features (e.g., posting messages, creating channels). Without them, the bot can’t automate your workflows effectively.Q: Do I need to re-authenticate periodically?
A: Typically no, unless your Slack Workspace policies require periodic re-authentication or token refresh.Q: Will the Swyft AI bot override channel permissions?
A: No, the bot respects existing Slack permissions. If it’s not allowed to create or manage a channel, it can’t do so on your behalf.
If you have any further questions about setting up or managing your Slack integration, please reach out to our support team at [email protected]. We’re here to help you get the most out of your Swyft AI experience!