Files
danswer-docs/connectors/slack.mdx
T
2023-07-12 19:40:43 -07:00

62 lines
1.9 KiB
Plaintext

---
title: Slack Connector
description: 'Access knowledge from your Messages'
---
## How it works
The Slack connector indexes all public channels for a given workspace.
- Upcoming: Support for private channels by tagging/adding the Danswer Slack Bot to private channels.
## Setting up
### Authorization
1. **Note: You must be an admin of the Slack workspace to set up the connector**
2. Navigate and sign in to [https://api.slack.com/apps](https://api.slack.com/apps).
3. Create a new Slack app:
- Click the **Create New App** button in the top right.
- Select **From an app manifest** option.
- Select the relevant workspace from the dropdown and click **Next**.
![SlackApp](/images/connectors/slack/SlackApp.png)
4. Copy the following manifest into the text box
```
display_information:
name: danswer-read-only
features:
bot_user:
display_name: DanswerReadOnly
always_online: false
oauth_config:
scopes:
bot:
- channels:history
- channels:read
- groups:history
- channels:join
- im:history
- users:read
settings:
org_deploy_enabled: false
socket_mode_enabled: false
token_rotation_enabled: false
```
5. Click the **Create** button.
6. In the app page, navigate to the **OAuth & Permissions** tab under the **Features** header.
7. Copy the **Bot User OAuth Token**, this will be used to access Slack.
![SlackBotToken](/images/connectors/slack/SlackBotToken.png)
### Indexing
1. Navigate to the Connector Dashboard and select the **Slack** Connector.
2. Place the **Bot User OAuth Token** under **Step 1 Provide Credentials**
![SlackConnectorSetting](/images/connectors/slack/SlackConnectorSetting.png)
3. Set the **Workspace ID** (see below) and click **Connect**.
![SlackId](/images/connectors/slack/SlackId.png)
__Note:__ The first indexing pulls all of the public channels and takes longer than future updates.