Skip to main content
All CollectionsGetting Started
Importing Slack data into Logikcull
Importing Slack data into Logikcull

Get to work faster by quickly converting your Slack files into Logikcull's powerfully simple interface.

John OHara avatar
Written by John OHara
Updated over a week ago

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.

  1. From your project's Upload page, click "New Upload" and select Cloud Upload > Import from Slack

  2. A window will appear. Click Select next to the "Connect with Slack." option.

  3. 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.

  4. Close the login window.

  5. 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:

  1. Start by navigating over to the Uploads tab in your Logikcull Project.

  2. Then select Create New > Cloud Upload > Import from Slack.

  3. Select Manual Transfer from Slack from the options.

  4. Drag and drop/browse for your zipped Slack archive.

  5. Assign the workspace (Custodian) name to the upload (and optionally assign a company name).

  6. Name the Upload.

  7. 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



Did this answer your question?