Skip to main content

​
Overview

The Slack integration allows your team to ask questions and get answers directly in Slack using the /sorcia command. It’s the fastest way to access your knowledge base without leaving your conversation flow.
Setup Time: 2-3 minutes
Requirements: Slack workspace admin permissions

​
Features

Slash Commands

Use /sorcia [question] to ask anything

Ephemeral Responses

Answers are private by default (only you see them)

Message Indexing

Search through all your Slack conversations

Channel Summaries

Get overviews of channel discussions

​
Installation

​
Step 1: Navigate to Integrations

  1. Log in to your Sorcia dashboard
  2. Click Integrations in the sidebar
  3. Find the Slack card
  4. Click Connect to Slack

​
Step 2: Authorize Sorcia

You’ll be redirected to Slack to authorize the app:
1

Select Workspace

Choose which Slack workspace to connect
2

Review Permissions

Sorcia requests the following permissions:
  • channels:history - Read public channel messages
  • channels:read - View channel list
  • chat:write - Send messages as Sorcia
  • commands - Enable slash commands
  • users:read - Access user directory
  • users:read.email - Match Slack users to Sorcia accounts
3

Grant Access

Click Allow to complete the installation
Success! Sorcia is now installed in your Slack workspace.

​
Step 3: Configure Sync Settings

After installation, configure which channels to index:
  1. Return to Sorcia dashboard
  2. Go to Integrations → Slack
  3. Click Configure
  4. Select channels to sync:
    • All public channels (default)
    • Specific channels (choose from list)
    • Exclude channels (blacklist specific channels)
Private channels require manual invitation. Invite @Sorcia to private channels you want to index.

​
Using the Slash Command

​
Basic Usage

Ask any question using the /sorcia command: 
/sorcia What's our refund policy?
Sorcia will respond with:
  • AI-generated answer
  • Source citations (with links)
  • Confidence score
  • Related questions
Slack Response Example

​
Advanced Syntax

​
Search Specific Channels

/sorcia in:#sales What were Q4 results?

​
Filter by Date

/sorcia since:2024-01-01 Product roadmap updates

​
Search Specific Sources

/sorcia from:google-drive Engineering handbook

​
Response Options

After receiving an answer, you can:
Click Share with Channel to post the answer for everyone

​
Features

​
Message Indexing

Sorcia automatically indexes:
  • Public channels - All messages from selected channels
  • Private channels - Only if Sorcia is invited
  • Direct messages - Never indexed (privacy)
  • Threads - Full thread context included
  • Files - Attached documents and PDFs
  • Links - Previews and metadata
Sync Frequency: Real-time via webhooks. New messages appear in search within seconds.

​
Permission Awareness

Sorcia respects Slack permissions:
  • Public channels: Visible to all workspace members
  • Private channels: Only visible to channel members
  • Archived channels: Read-only access maintained
Users only see results from channels they have access to in Slack.

​
Channel Summaries

Get a quick overview of any channel: 
/sorcia summarize #engineering
Response includes:
  • Key topics discussed
  • Recent decisions made
  • Action items mentioned
  • Active participants

​
Configuration

​
Sync Settings

Configure what content to index:
SettingOptionsDefault
ChannelsAll public, Selected, Exclude listAll public
Message HistoryAll time, Last year, Last 90 daysAll time
FilesInclude, ExcludeInclude
ThreadsInclude, ExcludeInclude
ReactionsInclude metadata, ExcludeExclude

​
Privacy Settings

Control how long Slack messages are retained in Sorcia:
  • Match Slack retention policy (recommended)
  • Custom retention (30/60/90 days, 1 year, forever)
  • Auto-delete when removed from Slack
  • User emails are hashed for privacy
  • DMs are never indexed
  • Private channels require explicit access
  • Users can request their data be excluded
  • GDPR data export available
  • Right to erasure supported
  • Audit logs for all queries
  • Retention policy enforcement

​
Notification Settings

Configure when Sorcia sends notifications:
  • New answers - When Sorcia learns something new
  • Low confidence - When answers may be inaccurate
  • Sync errors - When message indexing fails
  • Daily digest - Summary of questions asked

​
Permissions

​
Required Scopes

Sorcia needs these Slack OAuth scopes: 
bot_scopes:
  - channels:history      # Read public channel messages
  - channels:read         # List public channels
  - chat:write           # Send messages
  - commands             # Slash commands
  - users:read           # User directory
  - users:read.email     # Email addresses
  - files:read           # Access shared files
  
user_scopes:
  - channels:history     # Access user's channels

​
Admin Controls

Workspace admins can:
  • Approve/deny Sorcia installation
  • Restrict to specific channels
  • Monitor API usage
  • Revoke access anytime

​
Troubleshooting

Solutions:
  • Verify Sorcia is installed in your workspace
  • Check you’re in a channel where Sorcia is invited
  • Re-authorize the Slack integration
  • Contact support if persists
Solutions:
  • Verify channels are selected in sync settings
  • Wait 5-10 minutes for initial sync to complete
  • Check channel permissions (must be public or Sorcia invited)
  • Review sync logs for errors
Solution: Invite @Sorcia to the private channel:
/invite @Sorcia
Then wait for sync to complete (1-2 minutes)
Causes:
  • Large workspace (> 10K messages)
  • Complex questions requiring multiple sources
  • High API load (upgrade plan for faster processing)
Solutions:
  • Use filters to narrow search scope
  • Upgrade to Pro/Enterprise for better performance

​
Best Practices

  1. Announce Sorcia in #general
  2. Share example commands
  3. Encourage using /sorcia instead of asking teammates
  4. Collect feedback and iterate
  • Use descriptive channel names
  • Keep channels topic-focused
  • Archive outdated channels
  • Pin important messages
  • Don’t share sensitive info in public channels
  • Use private channels for confidential topics
  • Review what’s being indexed regularly
  • Train team on data sensitivity

​
Advanced Features

​
Slack App Home

Access Sorcia’s home tab in Slack for:
  • Quick Search - Search without using slash command
  • Recent Questions - View your query history
  • Popular Questions - See what teammates ask
  • Settings - Configure personal preferences

​
Workflow Integration

Trigger Sorcia from Slack workflows: 
- action: sorcia.query
  inputs:
    question: "{{ workflow.question }}"
    channel: "{{ workflow.channel }}"
  output:
    answer: "{{ sorcia.answer }}"

​
API Integration

Programmatically query Slack-indexed content: 
const response = await fetch('https://api.sorcia.ai/api/ai/query', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    question: 'Latest in #engineering?',
    filters: {
      sources: ['slack'],
      channels: ['engineering']
    }
  })
});

​
Metrics & Analytics

Track Slack integration usage:
  • Questions asked - Total queries via /sorcia
  • Channels indexed - Number of synced channels
  • Messages indexed - Total Slack messages in knowledge base
  • Response time - Average query latency
  • User adoption - Team members using Sorcia
  • Top questions - Most common Slack queries
View analytics in Dashboard → Integrations → Slack

​
Uninstalling

To remove Sorcia from Slack:
1

Go to Slack App Settings

Visit your workspace’s app management page
2

Find Sorcia

Search for “Sorcia” in installed apps
3

Remove App

Click Remove and confirm
4

Clean Up Data (Optional)

In Sorcia dashboard, go to Integrations → Slack → Delete Data
Uninstalling removes Sorcia’s access but doesn’t delete indexed messages. Delete data manually if needed.

​
Next Steps

Connect More Integrations

Add Notion, Google Drive, and more

Set Up Permissions

Configure who can access what