Skip to content

Discord token

Joel edited this page Apr 17, 2018 · 21 revisions

< Back to "Getting Started"


This is a guide to create a new Discord bot, setting it up and using its token in the Prodosía application.

https://discordapp.com/developers/applications/me

Creating the discord bot

  1. After going to the specified url at the top, login to Discord and choose to create a "New App".
  2. Here you choose a name, description and app icon. It is not necessary to add a redirect uri (and as such, it is advised against).
  3. Choose to "Create App" where the website will transition to an overview of the account.
  4. For purposes of managing the Prodosía application, a Bot User should be used. Go to the Bot tab and choose to Create a Bot User. This will permanently transition your app into a bot user.
  5. Once this choice has been selected, the Bot tab will reveal a Username and allow for the user to "click to reveal" the bot token. Click this and use this bot token in the application.

Note:
Keep this token safe. If sharing the bot with other people, remove the keys.txt file from the folder before sending it over.

Adding the bot to a server

https://discordapp.com/oauth2/authorize?client_id=CLIENT_ID_GOES_HERE&scope=bot&permissions=101376

At the top of the bot overview page, under the tab App Details, the Client ID can be found. For the above url, replace CLIENT_ID_GOES_HERE with the specified client id of your bot.

Discord permissions can be calculated at:
https://discordapi.com/permissions.html
The recommended permission scope is 101376 which allows for:

  • Reading messages sent in discord (necessary for responding to Tracker commands)
  • Embedding links (optional for archives)
  • Reading message history (duplication prevention for archives)
  • Sending messages (responding to Trackers and posting archives)
  • Sending files through discord

The discord bot will only function for the channels that it has access to.

Open this url in a web browser that has a discord account logged in with admin access to the server the bot should be added to. The bot will prompt which server to add the bot to.
In the bot information page, if the Public Bot option is checked, accounts other than the account that created the bot app will be able to add the discord bot to their server.

Clone this wiki locally