The Slack Enterprise integration allows organizations to collect Slack conversations and messages from custodians as part of a legal hold. Administrators can configure the integration at the subscription level, create Slack collection locations, and enable collections for individual holds. Collections are processed through Onna, with their status tracked in Reveal Hold.
Create a Slack Enterprise integration
A System Administrator can configure the Slack Enterprise integration from the subscription settings.
Navigate to Admin Center > Subscription > Integrations.
Click
.In the Integration Type dropdown, select Slack Enterprise.
Select the Tenant and click Next.
In the Slack sign-in window, enter your Slack workspace URL and click Continue.
Select Enter email and password.
Enter the Slack administrator’s email address and password, then click Sign In.
Enter the authentication code from your authenticator app, if prompted.
Click Allow to authorize the Onna Discovery app to access Slack.
Return to Reveal Hold and click Save.
After the integration was created successfully, it appears in the Integrations grid with its status set to Enabled.
Create a Slack collection location
After configuring the integration, create a location to specify which Slack conversations to collect.
Navigate to Admin Center > Subscription > Locations.
Click Create Location.
Enter a Name for the location.
Under Preservation Type, select Slack Enterprise. The Source field automatically displays Slack.
Select a Source Value Type:
All Conversations: Collects all channels and direct messages.
Only direct and multiparty messages: Collects direct and group messages only.
Select the Tenant and click Save.
The new location appears in the Locations grid.
To collect different types of Slack conversations separately, create another location and select a different Source Value Type. For example, one location can include all conversations, while another collects only direct and multiparty messages.
Configure Slack collection settings
Once the Slack integration and locations are configured, you can enable Slack collection for a hold.
Create or open a hold and add the custodians whose Slack data needs to be collected.
Navigate to the Collection tab.
Click Edit Collection Settings.
Enter the Collection Start Date and Collection End Date.
Verify that Onna is selected as the Target Location.
Under Collection Locations, enable the Slack locations you want to collect from.
Enable Auto-Sync if the collected data should continue to be updated.
.png)
Click Save.
A card appears for each enabled Slack location, displaying the number of custodians with Done, In Progress, To Do, and Failed counts.
Click on Start Collection, then click Yes in the confirmation dialog.
The collection starts in Onna. The status initially displays Not Collected until the collection is completed.
Note
Starting a collection again also recollects previously collected records.
To start a collection for an individual custodian, click the Start icon 
in the corresponding custodian row.
Reveal Hold retrieves Slack collection statuses through the Onna integration. These statues can be:
Status | What it means |
|---|---|
Not Collected | Collection has not started for this custodian yet. |
Automatic Collection Pending | Reveal Hold requested the Slack data through Onna and is waiting for a response. |
Collected Automatically | The custodian was found in Slack and their data was collected successfully. The Delete action is available. |
Collected Manually | A user manually marked the Slack location as collected for this custodian. |
Not Present | No Slack user matches the custodian's email address. There is nothing to collect; this is not an error. The available actions are Exclude, Set to Collected, and Retry. |
Excluded | The Slack location was excluded for this custodian before collection started. |
Failed | The collection request failed. The error appears under Health Status > Activity Errors. After resolving the issue, the collection can be retried from the Activity or Collection grid. |
Use the collection status and available actions to manage individual custodian collections.