Discord Bot

A custom branded discord bot that you own which allows you to interact with your workspace from Discord.

Setup

You'll be greeted by a modal stepper which requires three fields. It's crucial that we first create a discord bot and pass the values to our dashboard.

Creating a Discord Bot

Navigate to the discord developer portal, click "New Application" and name your application, for this example I'll be calling mine "Test Bot". Then make sure to give your bot some branding and a fun description!

Then copy the Application Id & Public Key and parse them into the correlating fields on the rankgun dashboard modal.

Securing Discord Bot

It's important to make sure that only we can invite the bot to our server, this is an additional security measure to ensure that nobody can cease control of our bot.

Locate the "Oauth2" tab and change the Install Link to None.

Navigate to "Bot" on the side bar *and disable the "Public Bot" switch. You may also change the username, icon and banner.

Then copy the token and parse it into the modal. Press on create

Final Configuration

Return back to the first menu from Creating a Discord Bot.

Scroll down and in the Interactions Endpoint URL field pass the value:

https://api.rankgun.works/discord/interactions/YourWorkspaceID

YourWorkspaceID should be replaced with your workspace ID.

Adding Permissions

To give people permissions add all of the role ID's that you want to be able to use the avaialble commands. Then press update. You can always change permissions later.

Inviting your Bot

Navigate back to "oauth", in the OAuth2 URL Generator enable "bot" and then click on "Administrator" on the list of permissions, make sure the integration type is guild install, then copy the URL and open it. You may then invite the bot to the servers of your choice.

Conclusion

You may now use your commands via the slash command feature. Available commands at the time of writing are listed below. All logs are logged to the universal logbook.