Statistics channels

What statistics channels look like

Voice channels

Category

Creating a statistics channel

From the panelUsing the /config command

⫸ Open the DraftBot panel

Creating a channel

To create a statistics channel, click the "Create a channel" button. You can then choose a target.

Show / hide the list of targets

NAME	EXPLANATION
Members	Every user (humans and bots) on your server.
Members (without bots)	Every human user on your server.
Bots	Every bot user on your server.
Roles	Every role on your server.
Channels	Every channel on your server.
Members with a role	Every member holding a certain role on your server.
Category exhibitions	Every channel in a given category.
Custom API	Data from a web API.

Configuring the channels

When you decide to edit a statistics channel, a series of settings appears. You can Edit or Delete the channels of your choice.

Creating a channel

To create a statistics channel, go to the Statistics channels menu of the /config command. If you have no other statistics channel configured, DraftBot offers you two buttons to click:

• Quick Configuration
• Advanced Configuration

If you choose Category as the channel type and you want to use an existing category, you have to give DraftBot the ID of that category.

Once the method has been chosen (quick or advanced), you have to select the counter's target (members, bots, a specific role, etc.).

Show / hide the list of targets

NAME	EXPLANATION
Members	Every user (humans and bots) present on your server.
Members (without bots)	Every human user present on your server.
Bots	Every bot present on your server.
Roles	Every role on your server.
Channels	Every channel on your server.
Members with a role	Every member holding a certain role on your server.
Category exhibitions	Every channel in a given category.
Custom API	Data from a web API.

Once you have created your channel, you can then configure your channels.

Customizing the name format

Channel

You can change the name of a voice channel to whatever you want, as long as it comes before the " : ".

Category

You can change the name of a category to whatever you want, as long as it comes before the " – ".

Custom API

The Custom API target displays a statistic coming from an external service, through an HTTP/HTTPS request to a web API.

To configure a custom API, you first have to give:

• The API's URL: for example https://api.draftbot.fr/base/stats
• The path to the numeric value: for example guilds

This can be used, for example, to display:

• The number of users registered on a website
• Any other numeric value reachable through an API

Format

The API has to return a JSON object containing a usable value.

Example of a valid response

{"count": 42}

In this example, DraftBot displays 42 in the statistics channel.

A concrete example

If your API is reachable at:

https://api.draftbot.fr/base/stats

and returns:

{"guilds":1008140,"users":53253590}

The channel can display, for example:

👤 Servers: 1008140