Slack Setup Guide

Connect IntelliRepo to Slack so your team can ask questions directly from Slack channels. This guide walks you through the setup process.

What You Can Do With Slack

Once connected, your team can:

• Use /ask slash command to query your knowledge base
• @mention the IntelliRepo bot in any channel
• Send direct messages to the bot for private queries
• Get AI-powered answers with source citations

No IntelliRepo account required for Slack users - anyone in the workspace can ask questions.

Prerequisites

Before you start:

1. You must be an Admin or Owner in your IntelliRepo organization
2. You need admin access to your Slack workspace (to install apps)
3. You should have at least one collection with documents

Step 1: Start the Connection

1. Go to Settings in IntelliRepo
2. Click Integrations
3. Find the Slack section and click Connect to Slack

You'll be redirected to Slack to authorize the connection.

Step 2: Authorize in Slack

1. Select your Slack workspace from the dropdown
2. Review the permissions requested:
   • Read messages in channels where the bot is mentioned
   • Send messages in response to queries
   • Respond to slash commands
3. Click Allow

You'll be redirected back to IntelliRepo.

Step 3: Configure Collections

After connecting, choose which collections Slack users can query:

Default Collection

Set a default collection that applies to all channels:

1. In the Integrations page, find your connected workspace
2. Select a collection from the Default Collection dropdown
3. Click Save

All /ask commands will search this collection by default.

Channel Mappings (Optional)

Override the default for specific channels:

1. Click Add Channel Mapping
2. Enter the Slack channel ID
3. Select the collection for that channel
4. Click Add

Finding a Channel ID:

1. In Slack, right-click the channel name
2. Select "Copy link"
3. The ID is the last part of the URL (e.g., C0123456789)

Example Setup:

• Default: "Company Policies" collection
• #engineering → "Engineering Docs"
• #support → "Customer FAQs"
• #hr-questions → "HR Policies"

Step 4: Test the Connection

In Slack, try:

/ask What is our vacation policy?

You should receive an AI-generated answer with source citations.

Slack App Permissions

The IntelliRepo Slack app requests these permissions:

We only access the minimum permissions needed.

Inviting the Bot to Channels

For @mentions to work, the bot must be in the channel:

1. Open the Slack channel
2. Type /invite @IntelliRepo (or your bot's name)
3. The bot is now active in that channel

The /ask command works in any channel without invitation.

Managing the Integration

Update Default Collection

1. Go to Settings > Integrations
2. Change the default collection dropdown
3. Click Save

Add/Remove Channel Mappings

1. Go to Settings > Integrations
2. Click Add Channel Mapping or the X to remove
3. Changes take effect immediately

Disconnect Slack

1. Go to Settings > Integrations
2. Click Disconnect next to your workspace
3. Confirm the action

Your collection mappings are saved and will be restored if you reconnect.

Troubleshooting

"IntelliRepo is not configured for this workspace"

The Slack app isn't linked to an organization:

• An admin needs to reconnect via Settings > Integrations

"No knowledge base configured"

No default collection is set:

• Go to Settings > Integrations
• Select a default collection
• Save changes

Bot not responding to @mentions

• Ensure the bot is invited to the channel
• Type /invite @IntelliRepo

Slow responses

Responses typically take 2-5 seconds. If slower:

• Check if documents are still processing
• Large collections may take slightly longer

See Common Issues for more help.

Security Notes

• All Slack requests are verified using cryptographic signatures
• Bot tokens are encrypted at rest
• Each workspace connects to exactly one organization
• All queries are logged for audit purposes

Related Articles

• Using Slack Commands
• Common Issues
• Audit Logs

Need Help?

Contact our support team if you have trouble connecting Slack.