The Slack AirSync simplifies the process of importing and syncing Slack public channel conversations into DevRev, supporting both one-time imports and ongoing syncs. This integration ensures knowledge accessibility and streamlines information retrieval from Slack.

Supported objects

The following is a list of Slack objects and their corresponding DevRev equivalents. Those marked as Sync to DevRev are eligible for import from Slack to DevRev.

Installation

When you install the snap-in, you'll be prompted to configure the Slack snap-in. Follow these steps to complete the installation:

1. After selecting Configure, a modal will appear prompting you to configure the snap-in.

2. You can choose whether to include Slack attachments in your DevRev import by using the toggle option:

   • Toggle enable: All files and attachments from Slack conversations will be imported to DevRev

   • Toggle disable: No files or attachments will be imported, only the conversation messages

   Note: In the My Settings section of the configuration page, toggle Enable to true. Ensure to save the changes at the end to apply the configuration settings to the import.

⚠️ Important: These attachments settings cannot be changed after the import begins, as this would affect which files are included or excluded in the import. Make sure your configuration reflects what you want to import.

Import from Slack

1. Go to Settings > Integration > Snap-ins in the Marketplace.

2. Under All Snap-ins, search for Slack AirSync.

3. In the Snap-in configuration modal, enable Extract attachments if you want to import files from Slack messages, then click Install.

4. Go to the Airsync section in your settings left nav, click Airsync and select the Slack logo.

5. Create a new connection to your Slack workspace, or use an active existing connection if available.

6. Once the connection is established, select the Slack workspace or specific public channels to import. DevRev automatically maps fields from Slack to DevRev but may prompt for manual mapping if needed.

Connections

You can establish a connection between Slack and DevRev in two ways:

Using OAuth

Use Slack's OAuth flow to authenticate and generate a bot token. Once authenticated, make sure to add the bot to every public channel you want to import. Only messages from channels the bot has access to will be imported.

Using Token

Generate an OAuth token manually by following the steps in the OAuth Tokens section. This method gives you control over the token (user or bot) used for data extraction.

Adding DevRev Bot to Channels

After authentication, add the DevRev bot to the desired public channels so it can access and import messages. To do this:

• Open Slack and navigate to the target public channel.

• In the message box, type /invite @DevRev and press Enter.

• You should see a confirmation that the bot has been added to the channel.

OAuth Tokens

You need to generate a User OAuth Token.

1. Create a new Slack app here: Slack Apps

2. Choose From Scratch, enter an app name, and pick a workspace.

3. Add scopes in the OAuth and Permissions page.

4. Add the following scopes under User Token Scopes:

   • channels:history

   • channels:read

   • files:read

   • groups:history

   • groups:read

   • im:history

   • im:read

   • mpim:history

   • mpim:read

   • users:read

   • users:read.email

5. Generate the OAuth token by installing the app and copy the token.

The import duration depends on the volume of Slack messages and data. It can take seconds for small workspaces or hours for large-scale imports.

Post import options

After a successful import, you have the following options available for the imported account:

• Sync to DevRev

  Synchronize Slack messages and updates with the corresponding items in DevRev. This ensures real-time updates and continuous data syncing.

• View Report

  Access detailed reports of imported Slack conversations and subsequent syncs.

• Delete Import

  Remove all imported Slack data from DevRev, including conversations, users, and groups.

• Edit Connection

  Modify the existing connection settings for future imports and syncs.

Sync to DevRev

After a successful import from a Slack workspace, you can choose to sync the imported data with DevRev. This feature ensures continuous integration of Slack messages into DevRev.

To perform a one-time sync to DevRev, follow these steps:

1. Go to Settings > Integrations > Airsync.

2. Locate the previously imported Slack project.

3. Select ⋮ > Sync Slack to DevRev.

⚠️ A one-time sync may overwrite modified fields in DevRev.

Historical imports

To view currently running and previous imports from various sources, do the following:

1. Go to Settings > Integrations > Airsync.

2. Select the import you want to view.

3. Click on the context menu (⋮) and select View Report.

Periodic sync

After successfully importing to DevRev, you have the option to enable a periodic sync. This allows for automatic synchronization with DevRev on a regular basis.

To configure periodic sync, follow these steps:

1. Go to Settings > Integrations > Airsync.

2. Locate the imported project.

3. Click ⋮ > Set Periodic Sync.

You'll see three periodic sync options:

• Slack → DevRev

  Enable this option to sync data from Slack into DevRev.

• DevRev → Slack

  Note: Syncing from DevRev to Slack is not supported.

• Automation Option

  Enable automation to trigger webhooks, Snap-ins, and DevRev-native events for synced items. If disabled, periodic syncs will not trigger any events or automations.

Select the frequency and start date, then click Schedule to set up the periodic sync.

Enabling automation for synced items triggers events such as webhooks, notifications, and snap-ins when new messages are imported.

Delete import

⚠️ Deleting an import removes all imported content, including users, groups, members, and messages.

An import and all the content it creates can be deleted from DevRev. This can be useful when running POCs or to change the configuration used during the import. Once an import has been deleted, all the content it created gets deleted, even if they were modified in DevRev. It's possible to import the project again after its deletion.

To delete an import and all the content it created, go to Settings > Integrations > Airsync, find the previously imported project, and select ⋮ > Delete Import.