Documentation

Slack - Query Configuration

Slack Configuration

Crawl User

The search provider uses a user token to access the Slack APIs. You should consider this user as a technical user. This means that all users who search will see all knowledge, this user has access to.

In order to acquire such a user token, please follow the steps below:

  1. Open Slack API: Applications | Slack

  2. Click on “Create a new app”

  3. Choose from Scratch

  4. Add an app name and choose your workspace, which you would like to crawl

  5. Open OAuth & Permissions

    image-20241003-155037.png

    1. On this page browse to scopes and either for Bot Token Scopes or User Token Scopes click on Add an Oauth Scope

    2. Assign the following permissions:

      1. search:read

      2. search:read.files

        image-20250811-074113.png

    3. Scroll up and click on Install to <Tenant Id>

      image-20241003-155318.png

    4. Take a note of the User OAuth Token. This will be used to authenticate the connector against Slack.

Slack Search Engine Configuration

You can access this configuration dialog via Search UX > Search Engine. Here you can add a Slack instance as search engine.

image-20250811-073626.png

  1. Token: please add the User or Bot OAuth Token from Step 5.d above.

  2. Root URL: please add your tenant url as https://<tenant>.slack.com
    This will be used for mandatory calculations in the course of the crawl.

  3. Number of search results defines how many search results should be returned per query / page

  1. Response timeout: determines the timeout when waiting for Elasticsearch responses in milliseconds.

  2. Connection timeout: determines the timeout when waiting for connections to Elasticsearch in milliseconds.

When finished with setting these fields, click on validate and save. If you observe any issues, then the validator will let you know or you can find more insights in the log files.