Slack Connector
Connect to Slack to index messages, threads, and files from your workspace channels.
Overview
The Slack connector allows you to:
- Index public and private channels
- Search message history
- Include file attachments
- Filter by date range
Prerequisites
- Slack workspace membership
- Admin approval for app installation
- OAuth authorization
Authentication
OAuth 2.0
- Click Connect with Slack
- Select your workspace
- Review permissions
- Authorize the app
Required Scopes
| Scope | Purpose |
|---|---|
channels:history | Read public channel messages |
channels:read | List public channels |
groups:history | Read private channel messages |
groups:read | List private channels |
files:read | Access shared files |
Configuration
| Setting | Description |
|---|---|
| Channels | Specific channels or all |
| Include Private | Index private channels |
| Date Range | Message history period |
| Include Files | Sync attached files |
Setup Steps
- Add Connector: Knowledge → Add Data Source → Slack
- Authorize: Connect with Slack OAuth
- Select Channels: Choose channels to index
- Set Date Range: Configure history period
- Test & Create: Verify and save
Channel Selection
Include: #engineering, #product, #announcements
Exclude: #random, #social
Content Indexed
| Content | Included |
|---|---|
| Messages | Yes |
| Threads | Yes |
| Reactions | Yes |
| Files | Optional |
| Canvas | Yes |
Permission Handling
- Users see channels they're members of
- Private channels require membership
- DMs are not indexed
Real-time Sync
Slack webhooks enable instant updates:
- New messages sync immediately
- Edited messages update
- Deleted messages are removed
Best Practices
- Focus on knowledge-sharing channels
- Exclude high-volume social channels
- Set reasonable date range limits
- Include files for complete context
Troubleshooting
Authorization failed: Ensure workspace admin has approved the app
Missing channels: Check channel membership and type (public/private)
Rate limits: Large history may require multiple syncs