# Discord Integration

# Create a Bot Account

  1. Make sure you're logged on to the Discord website (opens new window).
  2. Navigate to the application page (opens new window).

application page

  1. Click on the "New Application" button.
  2. Give the application a name (for example "Kitsu") and click "Create".

Create application

  1. Create a Bot User by navigating to the “Bot” tab.

Bot Tab

  1. It's possible to add an icon for the bot by clicking on the icon next to "Username". It will be the same icon used when the bot chat.

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

Public Bot ticked

  1. Make sure that Server Members Intent is ticked to allow the bot to see other members of a server.

Server Members Intent ticked

  1. Copy the token using the "Copy" button.

  2. Copy the token in "Settings" of Kitsu and in the text field "Discord token (optional)" and after click on "Save settings".

Add discord token to settings

# Inviting your Bot

So you’ve made a Bot User but it’s not actually in any server.

To add the bot in a server, follow these steps:

WARNING

The person adding the bot needs Manage Server permissions to do so.

  1. Make sure you're logged on to the Discord website (opens new window).
  2. Navigate to the application page (opens new window).
  3. Click on your bot’s page.
  4. Go to the “OAuth2” tab

Bot page oauth2

  1. On the "OAuth2 URL Generator" section, on "Scopes", tick only "bot".

URL Generator Scopes

  1. In "Bot permissions" tick only "Send Messages".

URL Generator Bot permissions

  1. Now the resulting URL can be used to add your bot to a server. Copy and paste the URL into your browser, choose a server to invite the bot to, and click “Authorize”.

WARNING

The users who wants to have notifications enabled have to be in a same server than the bot.

# Enable Notifications

Each user can set in their profiles the notification push to Discord. They have to switch the "Discord notifications enabled" field to "Yes" and enter their "Discord username" (they're in the form username#number).

Add discord username in profile

You're done!