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

1. Admin requirement

   Note: You must be an admin of the Slack workspace to set up the connector

2. Navigate to Slack Apps

   Navigate and sign in to https://api.slack.com/apps.

3. 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.

   
4. Configure app manifest

   Select the “YAML” tab, paste the following manifest into the text box, and click Next:

   display_information:
     name: OnyxConnector
     description: ReadOnly Connector for indexing Onyx
   features:
     bot_user:
       display_name: OnyxConnector
       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
   
5. Create the app

   Click the Create button.

6. Navigate to OAuth permissions

   In the app page, navigate to the OAuth & Permissions tab under the Features header.

7. Copy OAuth token

   Copy the Bot User OAuth Token, this will be used to access Slack.

Indexing

1. Navigate to connector

   Navigate to the Connector Dashboard and select the Slack Connector.

2. Provide credentials

   Place the Bot User OAuth Token under Step 1 Provide Credentials

   
3. Set workspace ID and connect

   Set the Workspace ID (see below) and click Connect.

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