Configuring the Slack integration

This topic describes how to configure Brightspot for integration with Slack. The following procedure enables the following functionalities:

• Publishing notifications from Brightspot to subscribers using Slack.
• Searching for files in Slack from Brightspot.

After the configuration described in this topic is complete, refer to the following topics to complete setup of the functionalities above:.

• Add Slack delivery method
• Searching for files in Slack

To configure integrated search and notifications with Slack:

1. From the Slack console, create a new app in the Slack API console. For details on this process, see Build apps with Slack's developer tools. After doing so, on the Basic Information page, retrieve the client ID and client secret, which you paste into Brightspot in step 7.
   
   Note

   To enable actionable notifications in Slack (available in v4.8), you must toggle on the Interactivity option located on the Interactivity & Shortcuts page of your Slack console. In addition, the Request URL must end in /cms/slack-notification-response.
2. Click menu > Admin > Sites & Settings > Sites > Global
3. Under Main, ensure that the Default Tool URL field is set.
   

   

4. Expand Integrations > Slack.
5. Under Workspaces, click add_circle_outline Add Slack Workspace and select Create New.

6. In the Workspace Name field, enter a name for the workspace (typically the name of the Slack workspace you are integrating).

   

7. In the Client ID and Client Secret fields, paste the values you obtained in step 1. After doing so, copy the redirect URL located under the Client ID field and paste it in your Slack app's OAuth & Permissions section in the sidebar. In this section, ensure you have given the bot the following scopes:
   
   • For notifications—chat:write and chat:write.public.

   • For search—files:read and search:read.

     After doing so, install the bot to your Slack workspace and retrieve the Bot User OAuth Token.

8. In Brightspot, in the Token field, paste the token you retrieved in step 7.
9. Click Save.
10. Click Back.
11. In the Workspaces list, select the workspace you created.
12. Click Save.

See also:

• Searching for files in Slack