Skip to main content

Slack

The kapa platform provides an integration to pull threads from Slack channels. Community Slack channels contain a lot of helpful information often in the form of support answers team members have provided.

Step 1: Create a Slack App​

The kapa platform needs to authenticate itself against your Slack workspace in order to access it. The simplest way of doing this is through a Slack App. Navigate to the Slack API page and create a new app. You can choose any name for the app. Make sure to select the correct workspace.

Navigate to the OAuth & Permissions page and add the following scopes:

  • channels:history
  • channels:read
  • groups:history
  • groups:read
  • metadata.message:read
  • team:read
  • users:read

On the same page click Install to Workspace and authorize the app.

From the OAuth & Permissions page copy the Bot User OAuth Token. The token should begin with xoxb-.

Step 2: Choose a channel​

Pick a channel you would like kapa to ingest and copy the channel id. You can find the channel id at the bottom of the channel details.

Channel Details

info

If you want to export multiple channels, repeat this step for each channel. You will have to create a separate source in the kapa.ai platform for each channel. You can use the same bot token for each source.

Step 3 (Optional): Invite bot to channel​

This is only necessary if the channel you would like kapa to ingest is private. For public channels this is not required. In your Slack workspace, navigate to the channel you want to export.

Invite the bot to the channel by typing /invite @<bot-name>.

Step 4: Configure the kapa platform​

Create a new source in the kapa platform and select Slack as the source type.

  1. Paste the copied bot token into the Bot Token field.
  2. Paste the copied channel ID into the Channel ID field.

kapa will validate the Bot Token and Channel ID together to check that all permissions are correct.

Configure your bot as needed.