SLACKENTGRID-5

Issue

The Glean Slack custom app is not properly installed for your Enterprise Grid organization. This can mean the app is not installed at the organization level, or it is not installed in all the workspaces where the Glean Enterprise App previously had access. Glean requires the custom app to be installed org-wide and in all required workspaces so it can continue indexing public content.

Resolution

First, ensure the app is installed at the organization level:

1. Go to api.slack.com/apps and click on your Glean Slack custom app.
2. In the sidebar under Features, click Org Level Apps.
3. Click Enable Org-Readiness and confirm Yes, Enable.
4. In the sidebar under Settings, click Install App.
5. Click Install to Organization.
6. Go to OAuth & Permissions and copy the new Bot User OAuth Token.
7. In the Glean Admin Console, navigate to your Slack Enterprise Grid datasource setup page and paste the new token. Click Save.

Then, install the app in all required workspaces:

1. In your Slack Enterprise workspace, go to Tools & Settings → Organization settings.
2. Click Integrations → Installed apps.
3. Find and click on your Glean Slack custom app.
4. In the top right, click Manage → Approve for Organization and click Approve.
5. In the top right, click Manage → Add to workspaces.
   • Select the same workspaces where the Glean Enterprise App previously had access. Normally, this would be all workspaces in your organization.
   • Then, make sure to select Default for future workspaces.

For more details, see Slack's guide on installing an app at the org level and their documentation on developing for Enterprise organizations.

If you choose not to enable “Default for future workspaces,” Glean will not automatically gain access to any newly created workspaces. As a result, these future workspaces will not be included in the Enterprise Graph, and their data will remain unavailable until the Glean application is explicitly installed in each workspace.

If you prefer not to include Glean in all of your workspaces, please configure one of the options below:

If you prefer to exclude specific workspaces, you can do so from the Glean Admin Console:

1. Navigate to the Slack Enterprise Grid datasource setup page.
2. Select the Manage data tab.
3. Add the desired workspaces to the Exclusion rules list. Workspaces added to this list will not be accessible to Glean and will be excluded from indexing and the Enterprise Graph.

If you prefer to include specific workspaces, you can do so from the Glean Admin Console:

1. Navigate to the Slack Enterprise Grid datasource setup page.
2. Select the Manage data tab.
3. Add the desired workspaces to the Inclusion rules list. Only workspaces added to this list will be accessible to Glean and included in indexing and the Enterprise Graph.