> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gorbit.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack Indexed

> Set up the Slack Indexed connector

## How it works

The Slack connector indexes all public channels for a given workspace.

To index private channels, add the Slack App to the private channel.

## Setting up

### Authorization

<Steps>
  <Step title="Admin requirement">
    **Note: You must be an admin of the Slack workspace to set up the connector**
  </Step>

  <Step title="Navigate to Slack Apps">
    Navigate and sign in to [https://api.slack.com/apps](https://api.slack.com/apps).
  </Step>

  <Step title="Create new Slack app">
    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**.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/connectors/slack/SlackApp.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=39f7e298b83998636f7fe824c111ace2" alt="Slack app creation flow with manifest option selected" width="1137" height="862" data-path="assets/admins/connectors/slack/SlackApp.png" />
  </Step>

  <Step title="Configure app manifest">
    Select the "YAML" tab, paste the following manifest into the text box, and click **Next**:

    ```
    display_information:
      name: GorbitConnector
      description: ReadOnly Connector for indexing Gorbit
    features:
      bot_user:
        display_name: GorbitConnector
        always_online: false
    oauth_config:
      scopes:
        bot:
          - channels:history
          - channels:read
          - groups:history
          - groups:read
          - channels:join
          - im:history
          - users:read
          - users:read.email
          - usergroups:read
    settings:
      org_deploy_enabled: false
      socket_mode_enabled: false
      token_rotation_enabled: false
    ```
  </Step>

  <Step title="Create the app">
    Click the **Create** button.
  </Step>

  <Step title="Navigate to OAuth permissions">
    In the app page, navigate to the **OAuth & Permissions** tab under the **Features** header.
  </Step>

  <Step title="Copy OAuth token">
    Copy the **Bot User OAuth Token**, this will be used to access Slack.
  </Step>
</Steps>

<img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/connectors/slack/SlackBotToken.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=042ae52abe034555cae74a94004ee0c9" alt="Slack OAuth & Permissions page showing Bot User OAuth Token" width="1626" height="1066" data-path="assets/admins/connectors/slack/SlackBotToken.png" />

### Indexing

<Steps>
  <Step title="Navigate to connector">
    Navigate to the Connector Dashboard and select the **Slack** Connector.
  </Step>

  <Step title="Provide credentials">
    Place the **Bot User OAuth Token** under **Step 1 Provide Credentials**

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/connectors/slack/SlackConnectorSetting.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=7cbc06e76706be8fd42812243036bf13" alt="Gorbit Slack connector settings showing Bot User OAuth Token input" width="1427" height="1142" data-path="assets/admins/connectors/slack/SlackConnectorSetting.png" />
  </Step>

  <Step title="Set workspace ID and connect">
    Set the **Workspace ID** (see below) and click **Connect**.
  </Step>
</Steps>

<img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/connectors/slack/SlackId.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=006084ee374e9cad7cf09930a7bb36c8" alt="Locating the Slack workspace ID in the app configuration" width="680" height="519" data-path="assets/admins/connectors/slack/SlackId.png" />

**Note:** The first indexing pulls all of the public channels and takes longer than future updates.