Skip to content

Register with Discord

The first step in getting PBot running is registering your private bot with Discord to obtain an API key. Navigate to the Discord Developer Portal.

Create a New Application

Click on the New Application button to start the process of registering your bot.

weqwe
Default Empty Applications Page

Name the Application

You’ll first be prompted to name your bot. This is how the bot will be displayed to your users. In this guide, we will be building a bot that disseminates taco recipes to the masses; thus, we will name it simply “Taco Lover.”

weqwe
Naming an Application

Set a Profile Picture

Now that the bot is registered, we can add a profile picture for it.

weqwe
Newly Created Application

We will use McFriendy's Taco Lover (2024) as the bot's profile picture.

weqwe
Delightful

Reset Auth Token

Once you've customized your application, navigate to the Bot page under Settings and click on the Reset Token button.

weqwe
Reset Token Button

Confirm Token Reset

You will be prompted for confirmation, as this would usually break any apps using a previous token.

weqwe
Confirm Token Reset
weqwe
New Token Generated

Copy Auth Token

After doing so, the page will only display your secret token temporarily. Copy it down now in a secure location.

weqwe
Copy Temporarily Visible Token

Set Bot Intentions

Under Privileged Gateway Intents, you'll need to turn on MESSAGE CONTENT INTENT to allow your bot to view message contents.

weqwe
Privileged Intents

Bot Installation Setup

Now, navigate to the Installation page under Settings.

Install Contexts

Beneath Installation Contexts, ensure Guild Install is checked.

weqwe
Installation Contexts

Scopes

Scroll down to Default Install Settings, and then select bot for SCOPES.

weqwe
Guild Install Scopes

Pemissions

For PERMISSIONS, you'll want a minimum of Read Message History and Send Messages. For more complex bots, you'll likely need additional permissions.

weqwe
Minimum Permissions

Now, scroll up to Install Link and select Discord Provided Link.

Copy the generated Discord link. It'll start with https://discord.com/oauth2/...

weqwe
Install Link

Adding a Bot

Open the provided Discord link and select Add to Server.

weqwe
Opened Install Link

Review Pemissions

Review the permissions listed.

weqwe
Permissions

Select Server

Select the server you wish to add the bot to.

weqwe
Choose a Server

Authorize

If you're satisfied, click Authorize.

weqwe
Authorize

Success!

weqwe
Success

At this time, your bot should have already joined the server.

weqwe
Welcome

The bot, however, is not yet active. That will change when we get your instance of PBot running in the next section.

weqwe
Offline Bot