Slack
Brightspot's Slack integration lets you search and import files from a linked Slack workspace into federated search.
Configuring the integration
To configure a Slack workspace:
- In the Slack API console, create a new app. On its Basic Information page, retrieve the client ID and client secret.
- From the left navigation, under Admin, click Sites & Settings, then select the Global site.
- From the Integrations tab, expand the Slack cluster.
- Under Workspaces, add a workspace, and complete the following fields:
- In the Workspace Name field, type a name to identify this workspace.
- In the Client Id field, type the client ID from step 1.
- In the Client Secret field, type the client secret from step 1.
- Click Save.
Brightspot displays the redirect URL to add in the Slack API Console next to the Client Id field. The Token and Signing Secret fields configure Slack notifications, a separate feature—leave them blank if you only want Slack search.
Linking your account
Slack imports files on behalf of the signed-in editor rather than a shared service account. If you have not linked a Slack workspace, the search results panel shows a Sign in with Slack button instead of a search field.
To link your Slack account:
- Open the search panel for Slack.
- Click Sign in with Slack, or, to add an additional workspace, click Link Another Account.
- Sign in to Slack and approve the requested permissions.
After you approve access, Brightspot returns you to the search panel and Slack is ready to search.
If no workspace has been configured yet, the search panel shows a message to contact an administrator instead of the sign-in button.
Searching Slack
Slack search in Brightspot behaves the same as Slack's own search: you can find files whose name contains a search term, and you can find text files that contain a search term. Brightspot can only search the files the signed-in editor has access to in Slack—if an editor can find a file in Slack's own search, they can find it in Brightspot too.