Skip to main content
All CollectionsConnectors
Slack Enterprise Grid Connector
Slack Enterprise Grid Connector
Cindy Chang avatar
Written by Cindy Chang
Updated over 2 months ago

Overview

  • Glean requires authentication to the Slack instance in order to fetch relevant information from Slack.

  • Index Slack data and associated permissions in an Enterprise Grid instance

  • Syncs permission and content updates every few minutes after initial indexing

  • Search for Slack messages across workspaces, channels, and direct messages

  • The app requires a Slack admin to install it.

  • It’s important to note that all data is stored in the customer’s cloud account and no data leaves the customer environment.

Integration Features

By default Glean will capture the following content:

  • Conversations (messages, threads, the channel itself) and files in:

    • Public channels

    • Shared Public Channels within an enterprise

    • Shared Public Channels outside an enterprise (called “Slack Connect” or “Connections”)

    • Private channels (optional)

    • Direct messages (optional)

API Usage

Glean will use the Slack Discovery API to ingest all data.

Setup

Installation Process

Required permissions for setup

Other prerequisites

  1. Verify that your Organization is on a Slack Enterprise plan.

  2. Enable the Discovery API for your Organization if you have not already:

    • You can email exports@slack.com requesting enablement or reach out to your AE, as they should be able to take care of this for you

Option1: Setup For GleanBot (Recommended)

This is recommended. If decide not to set this up then leave the three inputs blank in the Glean setup page and proceed to Setup for Glean Enterprise App for Search.

Create an app

  1. Visit the Slack API site and click Create New App.

  2. Choose From an app manifest.

  3. Select a workspace where you'd like to install the app and click Next.

  4. Replace existing YAML comment with the following and click Next. %manifest%

  5. Click Create.

  6. Add an icon

    1. Click the Basic Information tab.

    2. Download this logo.

    3. Click Choose File and select the logo you just downloaded above.

  7. Connect App to Glean

    1. Click the Collaborators tab and add at least one additional administrator from your company.

    2. Go to OAuth & Permissions from the left navigation and click Install to Workspace.

    3. Click on Manage distribution and select Distribute App

    4. Go to Enable Org-Wide App Installation and click Opt into Org Level Apps and Opt-In

    5. Go to Install App and copy the Bot User OAuth Token and paste into Glean setup page.

    6. Go to Basic Information and copy the Signing Secret and paste into Glean setup page.

Generate a token

  1. Click the Basic Information tab and scroll down until you see App-Level Tokens.

  2. Click Generate Token and Scopes.

  3. Name the token: Glean

  4. Click Add Scope and add the scope authorizations:read.

  5. Click Generate and paste the token into Glean.


Follow the steps listed in the section below to add Glean app to multiple workspaces (if required).


Optional to set up the Glean Bot in multiple workspaces

  1. Navigate to the management console for your Slack Enterprise Grid organization.

  2. Click on Integrations and Installed apps in the left navigation.

  3. On the right side of the page, click on the ... next to the Glean app and you will see the option to Add to more workspaces.

Option2: Setup for Glean Enterprise App for Search (Required for Search)

Follow this if you don't need the Gleanbot and just need the ability to search for slack messages in Glean. This will install the app "Glean Enterprise".

Generate an OAuth token

  • Follow the authorize link below and follow the on-screen instructions. You will see a page with the option to Allow the access scopes for our app on your workspace:

The scopes on screen read-only, and are necessary as follows:

  • Administer Slack for your organization: equivalent to "read all", used to index messages in your organization for search. This is used rather the individual read scopes to allow for better performance, admin search, and data-loss prevention.

Follow the steps listed in the Optional to set up the Glean Bot in multiple workspaces section above to add Glean app to multiple workspaces (if required).

Post Setup

After the initial setup, we will crawl data to get up to speed with your Slack instance’s current state. If things are not behaving as expected, or if you have any issues with this setup, please reach out to support@glean.com.

Did this answer your question?