Skip to main content

Discord

The Kapa platform provides an integration to pull threads from Discord forum channels. Community Discord servers contain a lot of helpful information often in the form of support answers team members have provided. This integration supports only Discord channels of type Forum.

Prerequisites

  • Administrator access to the Discord server you want to connect
  • The Discord server must contain at least one forum channel
  • Permission to install a bot on the Discord server

Data ingested

When you connect Kapa to Discord, the following data is ingested:

  • Thread URLs
  • Question titles and content
  • Comments to the question
  • User information (anonymized)

Setup

Step 1: Install the kapa.ai Ingestor discord bot

  1. Install the kapa.ai Ingestor through this link
  2. By installing this bot you give the Kapa platform the necessary permissions to pull data from your Discord server
  3. This is a separate Discord bot from the discord bot used to interact with users

Step 2: Choose a forum channel

The easiest way to get the ID of the channel you would like to ingest:

  1. Copy the link to the channel

  2. The ID of the channel is the second ID in the URL:

    https://discord.com/channels/<SERVER_ID>/<CHANNEL_ID>

Step 3: Configure the Kapa platform

  1. Create a new source in the Kapa platform and select Discord as the source type
  2. Paste the copied channel ID into the Channel ID field
  3. Kapa validates the Channel ID by checking if it has the required permissions to access it
  4. Use the optional configuration options as needed
  5. Click Save to begin the ingestion process

Configuration options

The following configuration options are available for the Discord integration:

OptionDescriptionDefaultRequired
Channel IDThe unique identifier for the Discord forum channelNoneYes
Message ageFilter threads based on their creation dateAll timeNo
Include solved threads onlyOnly ingest threads marked as solvedDisabledNo
Include specific tagsFilter threads based on their tagsAll tagsNo
Exclude specific tagsExclude threads with certain tagsNoneNo

Best practices

  • Choose active forums: Select forum channels with high-quality discussions and active participation from knowledgeable community members
  • Focus on support channels: Technical support forum channels often contain the most valuable information
  • Consider recency: Newer discussions often contain more accurate and relevant information
  • Combine with documentation: The Discord integration works best when combined with official documentation sources
  • Use tag filtering: If your Discord community uses tags well, filtering by specific tags can improve content quality

Troubleshooting

  • Invalid channel ID error: Ensure you've copied the correct part of the URL and that the channel is a forum type
  • Permission denied error: Verify the bot has been properly installed and has access to the channel
  • Empty ingestion results: Check that your forum channel contains threads that match your filter criteria
  • Bot not responding: Ensure the bot is still active in your server; you may need to reinvite it