How Box Integrates with Slack
Note
To require people to store in Box all content shared via Slack, turn off native file uploads and sharing. To do this, please contact feedback@slack.com.
Installing the Slack integration
You must enable this integration in two places:
- the Box Admin Console
- the Slack App directory
Note
This integration is only available to Box enterprise customers and users.
Part I: Enabling Box for Slack in the Box admin console
- From your Admin console, navigate to the Apps tab. Scroll down to the Individual Application Controls section and search for Slack.
- When the entry for Box for Slack displays, change the status to Available.
- To change additional configuration settings, hover your mouse over the Box for Slack App and click Configure. For the best user experience, follow steps 4-6.
- To see when a file is shared in a Slack channel, in File Preview in Box, click the slider to toggle on Enable Box Activity Stream.
- To display a content card (file preview) of the first page of a Box file when shared, click the slider toggle on Enable File Thumbnails.
- If you leave this toggle off, Slack displays the generic file type icon in place of a thumbnail image of the first page of the file.
- To enable Slack to index and store text content from shared Box files, click the slider to toggle on Enable context indexing for Slack search. This improves search accuracy when you search within Slack.
- If you leave this toggle off, Slack only indexes and stores the file name.
- For more robust security settings, enable steps 8-9 (if applicable).
- To add an additional layer of security before displaying a content card (file preview) of a Box file when shared, click the slider to toggle on Enforce additional permissions check before file display. The file preview will be available only if:
- everyone in the channel or group are authenticated into Box; AND
- everyone in the channel can view/access the shared file
- Optionally, restrict the integration to work only with specific Slack workspaces (that is, placing certain domains on an allow list).
- To restrict the integration to a specific Slack organization, in the Restrict to specific Slack Enterprise Grid Org ID allowlist box, type in your organization’s Slack Enterprise Grid Org ID. (This option is only available for Slack Enterprise Grid customers.)
- To restrict the integration to specific Slack workspace domains (such as acme.slack.com, acme-marketing.slack.com, and so on), in the Restrict to specific Slack workspaces allowlist box, type in the specific Slack domains.
- To allow any Box for Slack integration to connect to your Box enterprise, leave clear both options a) and b), above.
- In effect. if you complete this option you connect one Box EID to one Slack enterprise organization.
- Only people from this Slack enterprise can access your Box enterprise.
- Only people from these Slack domains can access your Box enterprise.
- Separate multiple domains with commas.
- When you’re done, click Save.
Part II: Enabling Box for Slack in the Slack App directory
- Follow Slack’s standard instructions for enabling a third-party app in Slack for your workspace
- Navigate to the Slack app store and search for “Box.” Then enable the integration.
- When you’re done, the option to add Slack becomes available to everyone for whom you’ve enabled the integration. When just one person installs the integration in their workspace, the integration becomes available to everyone else in that workspace.
- Review Slack’s instructions for individual account holders to add Slack to their respective workspaces.
Turning on the “Share with Slack” Integration
To enable your people to send shared links to Box content via Slack without leaving their Box interface, you must turn on the Slack integration for your enterprise. To do this:
- From your Admin console, navigate to the Apps tab. Scroll down to the Individual Application Controls section and search for Slack.
- When the entry for Share with Slack displays, click Available or Added by Default.
- Individuals must then navigate to the Box App store and install this integration on their individual accounts.
Turning on “Box File Picker” in Slack
To activate this feature you should activate “Share with Slack” and also enable “Box File Picker” app from the Slack app directory.