Before you start
- A Pro plan or higher, and permission to edit sources in the knowledge base.
- A Discord bot token. Create an application at discord.com/developers, add a Bot and copy its token.
- The bot invited to your server, with View Channel and Read Message History on every channel you want to index.
- The channels to index: a channel link, or a channel ID. To copy an ID, turn on Settings → Advanced → Developer Mode in Discord, then right-click the channel and choose Copy Channel ID.
Set up
Choose Discord
Open your knowledge base, go to Sources, click Add source and choose Discord. Give the source a name.
Options
The add form shows the bot token and the first four options below. The rest are on the source’s Configuration tab after you add it.| Option | Default | What it does |
|---|---|---|
| Channels | — | Required. A forum channel, text channel or thread, as a link or an ID. One per line when you edit. |
| Server ID | Empty | Fallback for building citation links. Rarely needed: a channel link already carries it. |
| Forum posts archived within | 180 days | Only forum posts archived in this window. Counted from when a post was archived, not opened. Active posts are always included. On the Configuration tab, -1 reads the whole forum. |
| Replace author names with pseudonyms | On | Writes “Community member 1”, “Community member 2” instead of usernames. Trusted users keep their names. |
| Messages per channel | 2000 | Text channels only. Newest messages first. Maximum 10,000. |
| Only posts tagged | Empty | Forum tags to keep, by name or ID, one per line. For example solved. Empty keeps every post. |
| Skip posts tagged | Empty | Forum tags to drop, one per line. Wins over Only posts tagged. |
| Trusted users | Empty | Usernames or user IDs, one per line. Their replies are marked “Answer from …”. |
| Only posts a trusted user answered | Off | Drops every post no trusted user replied to. Ignored while Trusted users is empty. |
| Exclude users | Empty | Usernames or user IDs whose messages are skipped. |
What gets indexed
| You name | Kelu creates |
|---|---|
| A forum or media channel | One document per post: the opening message, then each reply under a heading with its author and date. |
| A thread | One document for that thread. |
| A text channel | One document with the newest messages, split into conversations. Each part links back to Discord. |
- Messages from bots and webhooks are skipped, as are empty messages.
- A post or thread is read up to 300 messages.
- A post’s forum tags are included in the text.
- Each document cites its Discord link.
Sync
Discord re-syncs every 2 hours. Click Sync Now on the source page to sync right away.Troubleshooting
- Test connection says
401. Discord rejected the bot token. Copy it again from the Bot page. - Test connection says
403. The bot cannot read that channel. Give it View Channel and Read Message History there. - Test connection says
404. The channel ID is wrong, or the bot is not in that server. - Only one forum post was indexed. You named a post, not the forum. Use the forum channel’s link or ID.
- A post is missing. Open the source’s Sync history tab. Skipped posts are listed with the reason, for example a tag filter or no trusted answer.
- Community answers outrank your docs. Put the Discord source in its own source group, then scope public surfaces away from it.