Skip to content

Custom Bot ​

Custom Bots let you run an instance of Invite Tracker on your own application.

Premium feature

This feature requires a Custom Bot subscription. See the Premium page for plans and details.

If you have the applicable subscription already, let's get started with making an application for Invite Tracker to run on. It is highly recommended you follow this tutorial step by step. Should you run into any issues, you may join our support server. You may skip this part if you already know what you're doing.

Creating an Application ​

Let's start by heading over to the Discord Developer Portal. Make sure you're logged into the desired account and click the button New Application at the top right of the page below your avatar.

New Application

Choose a name for your new application and agree to the terms and conditions. After, click Create.

Create Application

First, head to the Installation tab on the left. (1) Select the dropdown menu in Install Link and (2) select the None option.

Install Link Step 1

(3) Confirm Install Link is set to None. Save Changes.

Install Link Step 2

Next, head to the Bot tab. From there, disable the Public Bot option and enable both the Server Members Intent and Message Content Intent options.

App Permissions

DANGER

Both intents are required: the custom bot will not work without the Server Members Intent option, and ticket transcripts require the Message Content Intent option.

Server with 10,000+ members?

Discord requires applications that can reach 10,000+ users to apply for Privileged Intent access. For a custom bot, that means a server with 10,000+ members. See Custom Bot: Privileged Intent Review for a full walkthrough of the form, including ready-to-use answers.

To invite the custom bot to your server, head to the OAuth2 tab on the left. Select bot in OAuth2 URL Generator and Administrator in Bot Permissions. You will then be able to use the Generated URL to invite your custom bot to the server by copying and pasting the link into your browser. You can also paste the link in a Discord channel and click it there to invite the custom bot.

App Invite

DANGER

Do not use the Installation tab to invite the bot. Please follow the steps provided through the OAuth2 tab.

TIP

For this tutorial, administrator allows the custom bot to function as efficiently as possible. You may still choose to use the default Invite Tracker permissions. Click here to see them.

After inviting your custom bot, we need to activate it. Head to the Bot tab on the left and copy your token.

App Token

On the server with the Custom Bot subscription, you will see a new plugin called Custom Bot in the dashboard sidebar, under the Settings section. Paste the copied token into Bot token and click Save changes. Invite Tracker checks the token with Discord when you save it, so a mistyped or invalid token is rejected right away. There are no further steps. Should you run into any issues, you may join our support server.

Bot Token

WARNING

The bot token input being empty after saving is intended: the token is stored securely and never shown again. Please make sure to save your bot token separately.

The saved token belongs to your subscription: if you move your Custom Bot subscription away from the server and back, the same bot comes back. If someone else's Custom Bot subscription is put on the server, the saved token is cleared and they need to add their own bot token.

TIP

Please allow a couple of minutes for the bot to come online.

If your custom bot stops ​

If your custom bot cannot sign in to Discord (for example because the token was reset in the Developer Portal or the Server Members Intent was turned off), it is stopped and the Custom Bot page shows a warning at the top:

Invalid Bot Token

Double-check the bot token and the intents in the Discord Developer Portal, then paste the token into Bot token and save it again to restart the bot.

Embed Color ​

Customize the color of every embed sent by the custom bot with the color picker.

Embed Color

Status and Activity ​

You can also customize the custom bot's status and activity.

There are 4 statuses you can choose from:

  • Online
  • Invisible
  • Idle
  • Do Not Disturb

Status

For the activity, pick an Activity type: Playing, Streaming, Listening, Watching, Competing, Custom, or Empty for no activity type.

Activity Type

Then customize the Activity text that displays after the type (up to 100 characters).

Activity Text

Invite Tracker Documentation