Discord Developer Portal : créer un bot, token et intents

Le Discord Developer Portal est le site où vous créez et réglez votre bot. Sur discord.com/developers/applications, cliquez sur « Nouvelle application », puis ouvrez la page Bot : « Réinitialiser le token » affiche le token une seule fois. Activez seulement les Privileged Gateway Intents dont le bot a besoin, puis créez le lien d'invitation sous Installation ou avec le générateur d'URL OAuth2 et le scope bot.

Héberger un bot Discord ? Chez HostValues à partir de €1,40 par mois, en ligne en quelques minutes. Voir les offres →

Ce guide parcourt les pages du portail qui comptent pour un bot : Informations générales, Bot, Installation et OAuth2. Il s'applique à l'API Discord v10, discord.js 14.27 et discord.py 2.7.1. Les règles, les codes d'erreur et les noms des boutons ont été vérifiés le 27 octobre 2026 dans la documentation officielle de Discord et dans les fichiers de traduction du portail. Deux changements de 2026 rendent beaucoup d'anciens tutoriels inexacts : le portail s'affiche dans la langue de votre client Discord, et l'accès libre aux intents privilégiés dépend désormais du nombre d'utilisateurs, et non plus du nombre de serveurs.

À quoi sert le Discord Developer Portal

Le portail regroupe vos applications Discord. Une application peut avoir un utilisateur bot, des commandes slash, un lien d'installation et des réglages OAuth2. Vous y gérez aussi le token, le mot de passe avec lequel votre code se connecte à Discord. La liste de vos applications se trouve sur discord.com/developers/applications, sous « Mes applications ».

Le 9 mars 2026, Discord a remanié le portail : nouvelle page d'accueil, nouveau thème, nouvelle navigation et, surtout, une version traduite. Le portail utilise maintenant la langue choisie dans votre client Discord ; si votre Discord est en français, les boutons le sont aussi. Nous donnons le nom français, avec le nom anglais entre parenthèses, car la documentation et beaucoup de tutoriels restent en anglais. Certains termes ne sont pas traduits : Bot, Token, OAuth2, Privileged Gateway Intents et les noms des trois intents. La documentation a déménagé sur docs.discord.com/developers ; les anciens liens discord.com/developers/docs redirigent vers ce site.

Créer l'application et le bot étape par étape

Il vous faut un compte Discord, une bibliothèque pour votre langage (discord.js pour Node.js, discord.py pour Python ou JDA pour Java) et un serveur de test dont vous êtes propriétaire ou sur lequel vous avez la permission « Gérer le serveur ».

1. Ouvrez la liste de vos applications et cliquez en haut à droite sur Nouvelle application (New Application).
2. Donnez un nom à l'application. Sous Équipe, laissez « Personnelle » ou choisissez une équipe si vous développez à plusieurs. En cliquant sur Créer, vous acceptez les Conditions d'Utilisation et la Politique pour les Développeurs de Discord.
3. Vous arrivez sur la page Informations générales, qui affiche l'identifiant d'application (Application ID) et la clé publique (Public Key).
4. Ouvrez la page Bot dans le menu de gauche. Selon la documentation de Discord, une nouvelle application a déjà un utilisateur bot : vous n'avez rien à ajouter.

L'identifiant d'application est public : c'est le client_id du lien d'invitation. La clé publique sert à vérifier que des requêtes HTTP viennent bien de Discord. Vous n'en avez besoin que si vous recevez les interactions sur votre propre adresse web, via l'URL du point de terminaison des interactions. Un bot qui se connecte par le Gateway, comme avec discord.js ou discord.py, s'en passe.

Token du bot : copier, protéger, régénérer

Le token autorise les requêtes envoyées à l'API et porte les permissions de votre application : quiconque le connaît peut agir comme votre bot. Discord ne l'affiche qu'une fois, au moment où il est créé.

1. Sur la page Bot, sous Token, cliquez sur Réinitialiser le token (Reset Token).
2. Discord demande « Réinitialiser le token du bot ? » et prévient que le bot cessera de fonctionner tant que vous n'aurez pas mis à jour le token dans son code. Confirmez.
3. Copiez aussitôt le nouveau token avec Copier, dans un gestionnaire de mots de passe ou dans le fichier .env de votre projet : vous ne le reverrez plus.

Discord le demande clairement : ne partagez jamais le token et ne l'enregistrez dans aucun système de gestion de versions. Il n'a sa place ni dans le code, ni sur GitHub, ni sur une capture d'écran. Mettez-le dans une variable d'environnement, le plus simplement dans un fichier .env qui contient DISCORD_TOKEN=votre_token, et ajoutez .env à votre .gitignore. S'il a fuité malgré tout, réinitialisez-le : l'ancien ne fonctionne plus, et vous mettez le nouveau partout où le bot tourne.

Avec discord.js, le paquet dotenv lit le fichier .env :

require('dotenv').config();
const { Client, Events, GatewayIntentBits } = require('discord.js');

const client = new Client({ intents: [GatewayIntentBits.Guilds] });
client.once(Events.ClientReady, (c) => console.log(`Connecté en tant que ${c.user.tag}`));
client.login(process.env.DISCORD_TOKEN);

Avec discord.py, c'est le paquet python-dotenv :

import os
import discord
from dotenv import load_dotenv

load_dotenv()
intents = discord.Intents.default()   # tout sauf presences, members et message_content
client = discord.Client(intents=intents)

@client.event
async def on_ready():
    print(f"Connecté en tant que {client.user}")

client.run(os.getenv("DISCORD_TOKEN"))

Privileged Gateway Intents : quand les activer

Les intents déterminent les événements que Discord envoie à votre bot par le Gateway. Trois d'entre eux sont privilégiés, car ils donnent accès à des données sensibles. Ils sont désactivés par défaut et se trouvent sur la page Bot, dans la section Privileged Gateway Intents. Activez seulement ce dont le bot a besoin, puis cliquez sur Enregistrer les modifications. Discord n'autorise un intent privilégié que si votre usage l'exige et respecte sa Politique pour les Développeurs.

Sans Message Content Intent, le bot reçoit des champs vides, sauf pour ses propres messages, les messages privés qu'on lui adresse, les messages qui le mentionnent et le message visé par une de ses commandes de menu contextuel. Les commandes slash n'ont besoin d'aucun intent privilégié : pour un nouveau bot, partez donc sur des commandes slash.

La règle depuis le 10 juin 2026 : une application qui a moins de 10 000 utilisateurs active les intents privilégiés librement dans le portail. Discord compte les utilisateurs uniques qui ont accès à l'application sur l'ensemble des serveurs où elle est installée. Dès que l'application atteint 10 000 utilisateurs, il faut demander l'accès. Discord vous prévient dans le portail, par e-mail ou par message système, et vous avez 90 jours pour déposer la demande ; pendant l'examen, le bot garde ses intents et peut continuer à rejoindre des serveurs. Un accès accordé se redemande chaque année. Avant ce changement, la limite était de 100 serveurs. La vérification de l'application est désormais une procédure séparée, obligatoire pour dépasser 100 serveurs.

Un intent doit être activé à deux endroits : dans le portail et dans votre code. Si le code demande un intent privilégié non activé ou non accordé, Discord ferme la connexion avec le code 4014 (Disallowed intent(s)). Avec discord.js, ajoutez par exemple GatewayIntentBits.MessageContent ou GatewayIntentBits.GuildMembers ; avec discord.py, intents.message_content = True ou intents.members = True. Redémarrez ensuite le bot, car un changement d'intents ne vaut que pour une nouvelle connexion au Gateway.

Inviter le bot : Install Link ou OAuth2 URL Generator

Pour ajouter un bot à un serveur, Discord utilise un lien d'autorisation OAuth2, que le portail prépare de deux façons. Dans les deux cas, la personne qui ouvre le lien doit être propriétaire du serveur ou avoir la permission « Gérer le serveur ».

Méthode A, page Installation et lien d'installation, celle du guide de démarrage actuel de Discord :

1. Ouvrez la page Installation. Par défaut, une nouvelle application ne s'installe que sur des serveurs ; l'installation pour un utilisateur ne sert qu'aux commandes que chacun utilise depuis son propre compte.
2. Sous Lien d'installation, choisissez « Lien fourni par Discord ». La section Paramètres d'installation par défaut apparaît.
3. Pour Installation pour une guilde, ajoutez les scopes applications.commands et bot, cochez les permissions dans le menu qui apparaît, puis enregistrez.
4. Copiez le lien d'installation, ouvrez-le dans le navigateur, choisissez votre serveur et autorisez.

Ce lien ne contient que l'identifiant de votre application : Discord demande au moment de l'ajout les scopes et permissions réglés par défaut, limités à bot et applications.commands. Il fait aussi apparaître un bouton « Ajouter l'application » sur le profil de votre application.

Méthode B, générateur d'URL OAuth2 :

1. Ouvrez la page OAuth2 et descendez jusqu'au Générateur d'URL OAuth2.
2. Sous Champs d'application (Scopes), cochez bot. D'après la documentation, applications.commands est inclus par défaut avec bot ; les tutoriels de Discord cochent tout de même les deux.
3. Sous Permissions du bot, cochez seulement ce que le bot utilise.
4. Copiez l'URL générée, ouvrez-la, choisissez le serveur et autorisez.

Le lien obtenu suit ce modèle ; le nombre après permissions est la somme des permissions choisies :

https://discord.com/oauth2/authorize?client_id=VOTRE_ID_APPLICATION&scope=bot&permissions=84992

1024 + 2048 + 16384 + 65536 donnent les 84992 de l'exemple. Évitez Administrateur (valeur 8) : cette permission donne tous les droits et ignore les restrictions posées sur chaque salon. Deux réglages de la page Bot jouent aussi sur l'invitation. Quand Bot public est décoché, vous seul pouvez installer l'application ; coché, toute personne qui a le lien peut l'ajouter là où elle en a le droit. Laissez Requiert un code d'accès OAuth2 décoché si vous n'avez pas votre propre flux OAuth2 : activé, le bot ne rejoint un serveur qu'au terme d'un flux OAuth2 complet.

Garder le bot en ligne 24/7

Votre bot n'est en ligne que tant que son programme tourne : sur votre PC, il se déconnecte dès que vous l'éteignez. Notre article garder un bot Discord en ligne 24/7 compare l'hébergement gratuit, le forfait bot et le VPS. Sur un forfait bot HostValues, tout se passe dans le panel de jeu :

1. Commandez un forfait d'hébergement de bot Discord. Le serveur est prêt juste après le paiement.
2. Envoyez vos fichiers dans l'onglet File managers ou en SFTP, avec votre package.json (Node.js) ou votre requirements.txt (Python), sans le dossier node_modules. Le panel installe les paquets listés dans ces fichiers.
3. Créez le fichier .env avec votre token dans File managers, ou envoyez-le en SFTP.
4. Dans l'onglet Startup, choisissez l'environnement : Node.js pour discord.js, Python pour discord.py, pycord ou nextcord, ou Java pour JDA (fichier .jar). La version se choisit sous Docker Image : Node.js 18, 20, 22, 24 ou 26, Python 3.11, ou Java 17 ou 21. Indiquez aussi votre fichier de démarrage, par exemple index.js ou bot.py, dans les variables de démarrage.
5. Démarrez le bot dans l'onglet Console. Quand le message de votre événement ready s'affiche, il est en ligne.

Si le bot plante, le panel le redémarre automatiquement. S'il plante de nouveau peu après, le panel ne le relance plus, pour éviter une boucle sans fin, et la console affiche l'erreur. Chaque offre inclut des bases de données MySQL, que vous créez dans l'onglet Databases et gérez avec phpMyAdmin. Pour un bot complet en Python, voyez créer un bot Discord avec Python.

Les prix sont TTC, chaque offre est résiliable tous les mois et comprend la protection DDoS. En payant à l'avance, vous obtenez 10 % de remise par trimestre et 15 % par an. Un bot discord.js simple utilise généralement 100 à 200 Mo, un bot discord.py souvent 80 à 150 Mo : Small suffit à la plupart des bots. Si la mémoire reste au-dessus de 80 %, passez à l'offre supérieure depuis l'espace client ; vos fichiers et votre base de données sont conservés.

Erreurs fréquentes

Questions fréquentes

Où trouver le token de mon bot dans le Discord Developer Portal ?

Sur la page Bot, sous Token. Discord ne montre un token qu'une fois, juste après le clic sur Réinitialiser le token. Si vous ne l'avez pas copié, réinitialisez-le encore : l'ancien cesse de fonctionner et vous mettez le nouveau partout où le bot tourne.

Le Discord Developer Portal existe-t-il en français ?

Oui. Depuis la mise à jour du 9 mars 2026, le portail utilise la langue choisie dans votre client Discord. Quelques termes restent en anglais, comme Bot, Token, OAuth2 et les Privileged Gateway Intents. La documentation pour les développeurs, sur docs.discord.com, est rédigée en anglais.

Quels Privileged Gateway Intents mon bot doit-il activer ?

Seulement ceux sans lesquels une fonction ne marche pas. Les commandes slash n'en demandent aucun. Les messages de bienvenue demandent le Server Members Intent, les commandes à préfixe comme !help le Message Content Intent, et l'affichage des statuts le Presence Intent.

Faut-il faire vérifier son bot Discord ?

Oui, pour dépasser 100 serveurs : Discord exige alors la vérification de l'application. Les intents privilégiés suivent une autre règle depuis le 10 juin 2026. Dès que votre application atteint 10 000 utilisateurs, vous demandez l'accès et le renouvelez chaque année.

Faut-il le Developer Portal pour créer un webhook Discord ?

Non. Un webhook publie des messages dans un salon et ne demande ni utilisateur bot ni authentification. Vous le créez dans les paramètres du serveur, onglet Intégrations, puis vous donnez son URL au service qui doit publier. Pour un bot qui répond aux membres, il faut en revanche une application dans le portail.