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
The user setting up this data source must be a Slack Org Owner or Slack Org Admin. You can check whether you have this permission using this slack guide.
Other prerequisites
Verify that your Organization is on a Slack Enterprise plan.
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
Visit the Slack API site and click Create New App.
Choose From an app manifest.
Select a workspace where you'd like to install the app and click Next.
Replace existing YAML comment with the following and click Next. %manifest%
Click Create.
Add an icon
Click the Basic Information tab.
Download this logo.
Click Choose File and select the logo you just downloaded above.
Connect App to Glean
Click the Collaborators tab and add at least one additional administrator from your company.
Go to OAuth & Permissions from the left navigation and click Install to Workspace.
Click on Manage distribution and select Distribute App
Go to Enable Org-Wide App Installation and click Opt into Org Level Apps and Opt-In
Go to Install App and copy the Bot User OAuth Token and paste into Glean setup page.
Go to Basic Information and copy the Signing Secret and paste into Glean setup page.
Generate a token
Click the Basic Information tab and scroll down until you see App-Level Tokens.
Click Generate Token and Scopes.
Name the token: Glean
Click Add Scope and add the scope
authorizations:read.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
Navigate to the management console for your Slack Enterprise Grid organization.
Click on Integrations and Installed apps in the left navigation.
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.