Discord

How it works#

The Discord connector indexes all channels for all servers(guilds) mentioned.

Setting up a Bot User#

Open Discord developer portal#

Login to your discord's developer portal https://discord.com/developers/applications

Create application#

Click on the "New Application" button.

Name and create#

Give the application a name and click "Create".

Configure Bot tab#

Navigate to the "Bot" tab to configure it.

Public Bot option#

Make sure that Public Bot is ticked if you want others to invite your bot.

Enable privileged intents#

Under the Privileged Gateway Intents make sure MESSAGE CONTENT INTENT is checked.

Copy bot token#

Copy the token using the "Copy" button. If you have lost your token, you can click on Reset Token.

Inviting the Bot User to server(s)#

So you've made a Bot User but it's not actually in any server. To add the bot user in your server follow the steps:

Open application#

Open your application at https://discord.com/developers/applications .

Open Installation tab#

Head over to the Installation tab.

Enable Guild Install#

Check the Guild Install under the Installation contexts.

Add bot scope#

Add bot scope under the scopes for Guild Install.

Set minimum permissions#

Under the permissions section for Guild Install, give these minimum permissions Manage Messages, Read Message History and View Channels.

Install bot with link#

Use the Discord Provided Link to install the bot to the server(s) you want. Make sure you have Manager server permissions on that guild or server

Add bot to servers#

Open the link in the browser and add the bot to your server(s)

Indexing#

Open Discord connector#

Navigate to the Connector Dashboard and select the Discord Connector.

Enter Bot Token#

Enter the Bot Token under credentials you fetched from Setting up a Bot User step 6.

Enter server IDs#

Enter the server IDs. By default all channels of all servers/guilds in which the bot user is added will be indexed or processed.

Find server ID#

To fetch server ID of a particular server, right click on the name of the server located on the top right corner and click on Copy Server ID

Enter channel names#

Enter the channel names. By default all channel names under the server(s) from step 3 that the bot user has access to will be indexed or processed.

Find channel name#

To get the channel name, hit on the settings icon next to the channel name. You will find the channel name in the Overview section

Optional Start Date#

Optionally you can set a Start Date in the format of YYYY-MM-DD. Only messages after this date will be indexed or processed.

Before using this source with students#

Start with approved course material. Check which documents the connector can retrieve and how it maps source permissions. Test with a student account and a teacher account before widening access. A successful sync does not prove that the intended class boundary is correct.

Use source troubleshooting when a document is missing or visible to the wrong audience.