Skip to main content

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.
Slack app creation flow with manifest option selected
4

Configure app manifest

Select the “YAML” tab, paste the following manifest into the text box, and click Next:
display_information:
  name: NexusConnector
  description: ReadOnly Connector for indexing Nexus
features:
  bot_user:
    display_name: NexusConnector
    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.
Slack OAuth & Permissions page showing Bot User OAuth Token

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 CredentialsNexus Slack connector settings showing Bot User OAuth Token input
3

Set workspace ID and connect

Set the Workspace ID (see below) and click Connect.
Locating the Slack workspace ID in the app configuration Note: The first indexing pulls all of the public channels and takes longer than future updates.