These features are available on Subscription plans.
Introduction
Logikcull offers an effortless way to import your Slack data for easy search and review. With options for direct integration or manual transfers, you can quickly convert your Slack JSON files and metadata into Logikcull's powerfully simple interface, streamlining your workflows and getting you into your Discovery project work faster.
Connect With Slack (Slack Discovery Integration)
Setting Up
If you are an administrator of a Slack instance on Slack's Enterprise Grid, you will have the ability to establish a direct cloud integration between Slack and Logikcull*. Here's how to set it up:
*Note that the Slack organization must have already have access to the Slack Discovery API before it can set up with Logikcull's Slack integration. If Slack has not yet enabled the Discovery API for your organization, the Slack organization owner can email exports@slack.com for access.
From your project's Upload page, click "New Upload" and select Cloud Upload > Import from Slack
A window will appear. Click Select next to the "Connect with Slack." option.
A separate window will appear asking for the credentials of the Slack organization owner to sign in and grant permission for Logikcull to access data. Make sure the Slack organization (not workspace) is correctly selected in the drop-down menu in the top-right corner. Enter the credentials of the Slack organization owner and click Allow.
Close the login window.
You can now import data directly from Slack by following the prompts.
Importing Slack Data into Logikcull
See how Logikcull's document viewer displays Slack data to provide an intuitive, almost-native review experience:
Manual Transfer from Slack
Exporting a Slack Workspace
Workspace Owners and Admins can export data from their workspace:
1. From your desktop, click your workspace name in the top left.
2. Select Administration, then Workspace settings from the menu.
3. Choose Import/Export Data in the top right.
4. Select the Export tab.
5. Click Start Export. Slack will send you an email once it's ready.
6. Open the email and click Visit your workspace's export page.
7. Click Ready for download to access the .zip file.
The .zip file will contain your message history (in JSON format) and file links from all public channels.
This is the file you should upload to Logikcull.
ℹ️ For manual uploads, it's important to keep the Slack upload you receive intact prior to uploading into Logikcull. Do not modify the contents of original zip (and ideally, do not even unzip prior to uploading). Modified Slack zips will not upload correctly.
If you have additional questions or issues, you can go directly to help.slack.com to learn more.
Upload your exported Slack zip archive into Logikcull:
Start by navigating over to the Uploads tab in your Logikcull Project.
Then select Create New > Cloud Upload > Import from Slack.
Select Manual Transfer from Slack from the options.
Drag and drop/browse for your zipped Slack archive.
Assign the workspace (Custodian) name to the upload (and optionally assign a company name).
Name the Upload.
Select Start Upload!
Slack Messages in Logikcull will get assigned the "From Slack" Auto Tag (QC Tag):
Things to Note
Each day of messages = 1 document. All documents are rendered to HTML and then to PDF for easy review, redacting, and downloading.
Edited and Deleted messages are captured and easily discovered. Search for "DELETED MESSAGE" or "EDITED MESSAGE" to find all messages that were edited/deleted.
All channel names are preserved and added to the file path (e.g. Slack.com\Workspace\SuperSecretChatRoom).
The folder structure must have the reference files on the root level or one level in. To clarify, for the following example, you can either select all > compress, or you can encase these files in a folder and compress that folder:
Slack Discovery Integration FAQ's
What Slack plans will this integration work with?
This integration works with Slack Enterprise Grid plan. Users may need to reach out to Slack Support to ensure that the Discovery API has been enabled by Slack. If the Discovery API has not been enabled for your organization's Slack you will see the following error when you try to authenticate:
team_not_authorized
What data is collected through this integration?
Messages and Users in a Slack Organization.
How does a user authenticate with Slack?
Logikcull uses the Slack API to access data in a customer’s Slack organization. Logikcull users creating a new Slack Discovery Upload must log in with Slack credentials. If the credentials are valid, Logikcull then asks for consent to access the Slack data connected to those credentials.
At this time, we request consent for read-only access to the Slack organization’s user list, message data, and file data.
What permission does a user need to access the integration?
Logikcull app permissions - a Slack Org Owner needs to approve (i.e., grant consent to) the Logikcull app to allow Logikcull to connect to the Slack organization.
Permission Details
The Logikcull app requests consent for the following permissions:
users:read
discovery:read
OAuth Scope | Description |
Permissions to list users/custodians |
|
users:read | View people in a workspace |
Permissions to retrieve Slack message and file data |
|
discovery:read | View all of the organization’s messages (including all private channels and direct messages), as well as the organization’s files |
What metadata fields are available for export with data imported through Slack uploads?
Slack Conversation ID | The unique Channel ID issued by Slack for each Slack Channel and/or DM. The Channel ID is found in the About page in each channel's properties page.
A Slack Conversation is a set of time-bound messages in a given day. |
Slack Conversation Name | For Slack Channels, this field contains the name of the Slack Channel. For DMs, this field contains the name(s) of the Participants. |
Slack DM Participants | For DMs only, Author IDs, display names, and author names. |
Slack Senders | Author IDs, display names, and author names of those who sent or posted messages in the conversation-day. |
Slack Reactions | The list of all reaction emoji(s) used in messages in the conversation, meaning their Slack ID (e.g., :grin:) |
Slack Attachment Date-Time Created | Date and Time of when the attachment was sent in a Slack conversation. |
Slack Attachment Uploaded By | Author IDs, display names, and author names of sender for attachment in a Slack conversation. |
Full reference for Slack API scopes: https://api.slack.com/scopes
A guide to Slack Discovery APIs: https://slack.com/help/articles/360002079527-A-guide-to-Slacks-Discovery-APIs