Aller au contenu
+90 850 303 07 52 [email protected]
Assistance Espace client
Sur une sélection d'offres d'hébergement annuelles et de VDS sur 3 mois, nom de domaine .com / .com.tr offert la première année · Voir les offres

Guides

Des guides pas à pas pour installer et gérer votre propre serveur, serveur de jeu ou site web, rédigés par l'équipe qui exploite notre infrastructure à Istanbul.

Bot Discord

Comment créer un bot Discord à partir de zéro avec Discord.js v14

26 août 2026 16 min de lecture Mis à jour :
Partager cet article

Dans ce guide, vous allez créer de A à Z, avec discord.js v14, un bot Discord qui répond aux commandes slash (/) : de la création de l'application dans le Developer Portal jusqu'au lien d'invitation, de l'installation de Node.js jusqu'au stockage du token (la clé de connexion du bot) dans un fichier .env, et de l'enregistrement des commandes via REST jusqu'au fichier index.js. À la fin, vous disposerez d'un modèle de projet bien rangé, que vous pourrez enrichir en ajoutant un fichier par nouvelle commande.

Avant de commencer

  • Un compte Discord et un serveur de test : vous avez besoin de la permission « Gérer le serveur » sur le serveur où vous inviterez le bot. Créez-vous un serveur vide pour vos essais.
  • Node.js LTS : d'après les informations de son paquet sur npm, discord.js 14 nécessite Node.js 18 ou une version plus récente. Installez néanmoins la version LTS (support à long terme) actuelle recommandée par nodejs.org ; l'option --env-file utilisée dans ce guide exige d'ailleurs au moins Node.js 20.6.0.
  • Une machine sur laquelle faire tourner le bot : votre propre ordinateur suffit pour le développement et les tests, mais lorsqu'il s'éteint ou se met en veille, le bot se déconnecte aussi. Pour le garder en ligne en permanence, utilisez un VDS. Les offres VDS pour bot Discord de HanHosting sont fournies avec 4 CPU, 2–4 Go de RAM et 30–40 Go de disque NVMe ; vous vous connectez à un VDS Linux en SSH (22) et à un VDS Windows en RDP (3389).
  • Aucun port à ouvrir : le bot se connecte lui-même au serveur Gateway de Discord via WebSocket ; aucun port n'est ouvert pour les connexions entrantes.

1. Créez l'application et le bot dans le Developer Portal

Connectez-vous au Discord Developer Portal :

  1. Cliquez sur le bouton New Application, donnez un nom à l'application et confirmez avec Create.
  2. Copiez la valeur Application ID sur la page General Information. Il s'agit de l'identifiant de votre application (CLIENT_ID).
  3. Ouvrez la page Bot, dans le menu de gauche. C'est là que vous définissez le nom et l'avatar du bot ; l'interrupteur Public Bot détermine si d'autres personnes peuvent aussi ajouter le bot à leurs serveurs.
  4. Dans la section Token, cliquez sur Reset Token, confirmez et copiez immédiatement la valeur affichée. Le token n'est plus affiché ensuite ; si vous le perdez, vous devez le réinitialiser à nouveau et l'ancien token devient invalide.

Le token est le mot de passe du bot : toute personne qui le détient peut envoyer des messages, supprimer des salons et expulser des membres au nom de votre bot. Ne l'écrivez pas dans votre code et ne le montrez ni dans des captures d'écran ni dans des salons d'assistance. Si vous avez copié une valeur courte sans aucun point, vous avez très probablement pris le client secret de la page OAuth2 ; le bot ne peut pas se connecter avec cette valeur.

La même page comporte une section Privileged Gateway Intents. Les intents (autorisations d'événements) déterminent quels événements Discord envoie à votre bot. Comme l'exemple de ce guide n'utilise que des commandes slash, il n'a besoin d'aucun intent privilégié ; si votre bot doit lire le contenu des messages ou suivre la liste des membres, activez ici l'interrupteur correspondant. Pour les bots non vérifiés présents sur moins de 100 serveurs, activer l'interrupteur suffit ; les bots présents sur 100 serveurs ou plus doivent être vérifiés et obtenir une approbation distincte pour ces intents.

2. Invitez le bot sur votre serveur de test

La documentation actuelle de Discord gère les invitations depuis la page Installation :

  1. Vérifiez que Guild Install est coché dans la section Installation Contexts. Lorsque vous sélectionnez Discord Provided Link dans la section Install Link, la section Default Install Settings apparaît.
  2. Dans cette section, ajoutez les scopes applications.commands et bot pour Guild Install. Dans la liste Permissions qui apparaît lorsque vous sélectionnez bot, cochez les permissions dont le bot a réellement besoin. Le bot d'exemple n'a pas besoin de Administrator ; réduire les permissions au minimum limite les dégâts en cas de fuite du token.
  3. Copiez l'adresse de la section Install Link, ouvrez-la dans votre navigateur, choisissez votre serveur de test sous Ajouter au serveur (Add to server) et confirmez. Le bot apparaît hors ligne dans la liste des membres ; il passera en ligne lorsque vous lancerez le code.

Vous pouvez aussi sélectionner les deux mêmes scopes dans l'écran OAuth2 → URL Generator et utiliser le lien généré. Un lien d'invitation écrit à la main ressemble à ceci ; remplacez client_id par votre propre Application ID et permissions par la valeur des permissions :

https://discord.com/api/oauth2/authorize?client_id=123456789012345678&permissions=0&scope=bot%20applications.commands

Si vous obtenez l'erreur « Bot requires a code grant », désactivez l'option Require OAuth2 Code Grant dans les réglages de l'application.

Enfin, récupérez l'identifiant du serveur de test : dans Discord, activez l'interrupteur Mode développeur dans la section Avancés des Paramètres utilisateur, puis faites un clic droit sur l'icône du serveur dans la liste de gauche et choisissez l'option Copier l'identifiant du serveur ; dans l'interface anglaise, ces options s'appellent « Developer Mode » et « Copy Server ID », et leur nom peut varier selon les versions. Cette valeur sera votre GUILD_ID.

3. Installez la version LTS de Node.js

Windows (votre ordinateur ou un VDS Windows) : téléchargez sur nodejs.org le programme d'installation Windows (.msi) marqué LTS et installez-le. Ouvrez une nouvelle fenêtre PowerShell et vérifiez les versions :

node -v
npm -v

VDS Linux (Ubuntu/Debian) : connectez-vous au serveur en SSH et utilisez la méthode nvm (Node Version Manager) recommandée sur la page de téléchargement de Node.js. Le paquet nodejs du dépôt de la distribution peut être en retard sur la version exigée par discord.js ; avec nvm, vous installez la version LTS actuelle :

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash
\. "$HOME/.nvm/nvm.sh"
nvm install --lts
node -v
npm -v

Si la commande nvm est introuvable, fermez puis rouvrez le terminal ou exécutez source ~/.bashrc ; la sortie de command -v nvm doit être nvm. nvm n'installe Node.js que pour l'utilisateur qui lance l'installation ; effectuez donc l'installation avec l'utilisateur qui fera tourner le bot.

4. Créez le projet et installez discord.js

mkdir discord-bot
cd discord-bot
npm init -y
npm install discord.js

npm init -y crée un fichier package.json avec les valeurs par défaut, et npm install discord.js télécharge la bibliothèque dans le dossier node_modules. À la fin du guide, votre dossier ressemblera à ceci :

discord-bot/
├── commands/
│   └── utility/
│       ├── ping.js
│       └── hello.js
├── node_modules/
├── .env
├── .gitignore
├── deploy-commands.js
├── index.js
├── package-lock.json
└── package.json

Chaque commande est un fichier distinct dans commands ; vous ne touchez pas à index.js lorsque vous ajoutez une nouvelle commande. Modifiez la section scripts de package.json comme suit :

"scripts": {
  "start": "node --env-file=.env index.js",
  "deploy": "node --env-file=.env deploy-commands.js"
}

5. Placez le token dans un fichier .env

Créez un fichier nommé .env dans le dossier du projet et écrivez-y les trois valeurs, sans guillemets :

DISCORD_TOKEN=your-bot-token
CLIENT_ID=your-application-id
GUILD_ID=your-test-server-id
VariableOù la trouverFichier qui l'utilise
DISCORD_TOKENDeveloper Portal → Bot → Reset Tokenindex.js, deploy-commands.js
CLIENT_IDDeveloper Portal → General Information → Application IDdeploy-commands.js
GUILD_IDDiscord → Mode développeur → Copier l'identifiant du serveurdeploy-commands.js (commandes de serveur uniquement)

Le guide discord.js recommande de charger le fichier .env avec l'option --env-file intégrée à Node.js ; aucun paquet supplémentaire n'est nécessaire. Dans le code, les valeurs se lisent sous la forme process.env.DISCORD_TOKEN. Si le même nom est aussi défini dans les variables d'environnement du système, c'est la valeur du système qui l'emporte ; si le fichier est introuvable, Node.js renvoie une erreur et ne démarre pas.

Pour éviter que le token ne se retrouve par erreur dans un dépôt Git, créez un fichier .gitignore à la racine du projet :

node_modules
.env

Sous Linux, exécutez chmod 600 .env pour que seul votre utilisateur puisse lire le fichier. Sous Windows, le Bloc-notes peut enregistrer le fichier sous le nom .env.txt ; lors de l'enregistrement, choisissez « Tous les fichiers » comme type de fichier et vérifiez le nom avec dir dans PowerShell.

6. Écrivez vos premières commandes slash

Créez le dossier commands/utility. Chaque fichier de commande exporte deux éléments : la définition à enregistrer auprès de Discord (data) et la fonction exécutée lorsque la commande est utilisée (execute).

commands/utility/ping.js :

const { SlashCommandBuilder } = require('discord.js');

module.exports = {
  data: new SlashCommandBuilder()
    .setName('ping')
    .setDescription('Checks that the bot is running.'),
  async execute(interaction) {
    await interaction.reply('Pong!');
  },
};

La seconde commande accepte une option utilisateur facultative ; si l'option est laissée vide, elle salue la personne qui a tapé la commande. commands/utility/hello.js :

const { SlashCommandBuilder } = require('discord.js');

module.exports = {
  data: new SlashCommandBuilder()
    .setName('hello')
    .setDescription('Greets a user.')
    .addUserOption((option) =>
      option.setName('user').setDescription('The user to greet'),
    ),
  async execute(interaction) {
    const target = interaction.options.getUser('user') ?? interaction.user;
    await interaction.reply(`Hello ${target.username}!`);
  },
};

Les noms de commandes et d'options doivent compter de 1 à 32 caractères, être écrits en minuscules et ne contenir aucun espace ; en dehors des lettres (lettres accentuées comprises) et des chiffres, les seuls symboles autorisés sont - et _. Une description est obligatoire et doit compter de 1 à 100 caractères.

7. Enregistrez les commandes auprès de Discord (REST)

Pour enregistrer les commandes auprès de Discord, créez un fichier deploy-commands.js à la racine du projet. Le script rassemble toutes les définitions du dossier commands et les envoie à l'API REST avec une requête PUT :

const { REST, Routes } = require('discord.js');
const fs = require('node:fs');
const path = require('node:path');

const { DISCORD_TOKEN, CLIENT_ID, GUILD_ID } = process.env;

const commands = [];
const foldersPath = path.join(__dirname, 'commands');

for (const folder of fs.readdirSync(foldersPath)) {
  const commandsPath = path.join(foldersPath, folder);
  const commandFiles = fs.readdirSync(commandsPath).filter((file) => file.endsWith('.js'));
  for (const file of commandFiles) {
    const command = require(path.join(commandsPath, file));
    if ('data' in command && 'execute' in command) {
      commands.push(command.data.toJSON());
    } else {
      console.log(`[WARNING] ${file}: missing data or execute.`);
    }
  }
}

const rest = new REST().setToken(DISCORD_TOKEN);

(async () => {
  try {
    console.log(`Registering ${commands.length} commands...`);
    const data = await rest.put(
      Routes.applicationGuildCommands(CLIENT_ID, GUILD_ID),
      { body: commands },
    );
    console.log(`Registered ${data.length} commands.`);
  } catch (error) {
    console.error(error);
  }
})();

Lancez le script :

npm run deploy

En cas de succès, /ping et /hello apparaissent lorsque vous tapez / sur le serveur de test. La requête PUT remplace entièrement la liste des commandes de ce serveur par celle que vous envoyez ; une commande dont vous avez supprimé le fichier disparaît au prochain enregistrement. Ne relancez le script que lorsqu'une définition de commande (nom, description, options) change ; si vous avez seulement modifié le code dans execute, il suffit de redémarrer le bot.

Lorsque les commandes sont prêtes, utilisez Routes.applicationCommands(CLIENT_ID) au lieu de Routes.applicationGuildCommands(CLIENT_ID, GUILD_ID) pour les rendre disponibles sur tous les serveurs :

CaractéristiqueCommande de serveur (guild)Commande globale
RouteRoutes.applicationGuildCommands(CLIENT_ID, GUILD_ID)Routes.applicationCommands(CLIENT_ID)
Où elle apparaîtUniquement sur le serveur GUILD_IDSur tous les serveurs auxquels l'application a été ajoutée, ainsi que dans les messages privés (MP) des utilisateurs qui partagent un serveur avec le bot
Mises à jourImmédiatesLa requête d'une personne qui tente d'utiliser l'ancienne version est rejetée, et la commande est actualisée dans son client
UsageDéveloppement et testsCommandes prêtes à être publiées

Si vous enregistrez la même commande à la fois sur le serveur et globalement, elle apparaît deux fois sur le serveur de test. Pendant le développement, utilisez une application de test distincte ou videz les commandes du serveur avec une liste vide ({ body: [] }).

8. Démarrez le bot avec index.js

index.js charge les fichiers de commandes, se connecte à Discord et transmet chaque commande reçue au fichier correspondant :

const fs = require('node:fs');
const path = require('node:path');
const { Client, Collection, Events, GatewayIntentBits, MessageFlags } = require('discord.js');

const client = new Client({ intents: [GatewayIntentBits.Guilds] });

// Load the command files
client.commands = new Collection();
const foldersPath = path.join(__dirname, 'commands');

for (const folder of fs.readdirSync(foldersPath)) {
  const commandsPath = path.join(foldersPath, folder);
  const commandFiles = fs.readdirSync(commandsPath).filter((file) => file.endsWith('.js'));
  for (const file of commandFiles) {
    const command = require(path.join(commandsPath, file));
    if ('data' in command && 'execute' in command) {
      client.commands.set(command.data.name, command);
    } else {
      console.log(`[WARNING] ${file}: missing data or execute.`);
    }
  }
}

// Runs once when the bot is ready
client.once(Events.ClientReady, (readyClient) => {
  console.log(`Ready! Logged in as ${readyClient.user.tag}.`);
});

// Handle slash commands
client.on(Events.InteractionCreate, async (interaction) => {
  if (!interaction.isChatInputCommand()) return;

  const command = interaction.client.commands.get(interaction.commandName);
  if (!command) {
    console.error(`No command named ${interaction.commandName} was found.`);
    return;
  }

  try {
    await command.execute(interaction);
  } catch (error) {
    console.error(error);
    const response = { content: 'There was an error while running this command.', flags: MessageFlags.Ephemeral };
    if (interaction.replied || interaction.deferred) {
      await interaction.followUp(response);
    } else {
      await interaction.reply(response);
    }
  }
});

client.login(process.env.DISCORD_TOKEN);

Démarrez le bot :

npm start

En quelques secondes, vous devriez voir dans le terminal la ligne qui commence par « Ready » ; le bot passe en ligne sur le serveur et répond « Pong ! » à la commande /ping. Pour l'arrêter, appuyez sur Ctrl+C dans le terminal. Trois points à connaître sur ce code :

  • GatewayIntentBits.Guilds remplit les caches des serveurs, des salons et des rôles ; il est nécessaire au bon fonctionnement de discord.js et suffit à lui seul pour les commandes slash.
  • Discord attend la première réponse à une interaction dans un délai de 3 secondes. Pour les tâches longues, comme une requête en base de données ou un appel à une API externe, appelez d'abord await interaction.deferReply(), puis envoyez le résultat avec interaction.editReply() ; vous disposez alors de 15 minutes.
  • Une réponse envoyée avec MessageFlags.Ephemeral n'est visible que par la personne qui a utilisé la commande ; c'est pratique pour que les messages d'erreur n'encombrent pas le salon.

9. Faites tourner le bot 24 h/24, 7 j/7 sur un VDS

Un processus lancé avec npm start est lié au terminal : lorsque vous fermez la session SSH ou la fenêtre PowerShell, ou lorsque le serveur redémarre, le bot s'arrête aussi. Pour un fonctionnement sans interruption, confiez le processus à un gestionnaire de processus comme PM2 ou à un service systemd ; ces outils redémarrent le bot s'il plante et le lancent automatiquement au démarrage du serveur. L'installation pas à pas est décrite dans le guide Garder un bot Discord en ligne 24 h/24, 7 j/7 sur un VDS. Lorsque vous transférez le projet sur le serveur, ne copiez pas le dossier node_modules ; exécutez npm install sur le serveur (les dépendances sont restaurées à partir de package-lock.json) et recréez-y le fichier .env.

Choix des intents et récapitulatif des réglages

IntentPrivilégié ?Ce qu'il apporteDans cet exemple
GuildsNonInformations sur les serveurs, les salons et les rôles ; suffisant pour les commandes slashNécessaire
GuildMessagesNonÉvénements de messages dans les salons des serveurs (messageCreate)Inutile
MessageContentOuiLecture du texte des messages, des pièces jointes et des embeds (encadrés de contenu enrichi) ; pour les bots à préfixe (!command)Inutile
GuildMembersOuiÉvénements d'arrivée et de départ des membres, liste des membresInutile
GuildPresencesOuiStatut en ligne et informations d'activitéInutile

L'approche « tapez Ping dans un salon et recevez Pong! en retour », courante dans les anciens exemples, nécessite à la fois les intents GuildMessages et MessageContent ; l'interrupteur Message Content doit aussi être activé dans le Developer Portal. Sans cette autorisation, le bot voit le texte des messages comme vide, sauf pour ses propres messages, les messages qui le mentionnent et les MP.

Erreurs fréquentes

  • « An invalid token was provided. » client.login() a reçu une valeur invalide. Si vous avez démarré le bot avec node index.js, c'est-à-dire sans --env-file, alors process.env.DISCORD_TOKEN est vide ; utilisez npm start. Copier le client secret à la place du token, ou ne pas mettre à jour le fichier .env après avoir réinitialisé le token, provoque la même erreur.
  • Une erreur commençant par [DisallowedIntents] : vous avez demandé MessageContent, GuildMembers ou GuildPresences dans le code, mais l'interrupteur correspondant est désactivé sur la page Bot du Developer Portal. Activez l'interrupteur ou retirez l'intent du code.
  • Les commandes n'apparaissent pas lorsque vous tapez / : npm run deploy n'a peut-être pas été exécuté, GUILD_ID correspond peut-être à un autre serveur, ou le scope applications.commands n'a pas été sélectionné lors de l'invitation du bot. Vérifiez le nombre de commandes dans la sortie du script d'enregistrement.
  • DiscordAPIError[50001]: Missing Access lors de l'enregistrement : en général, l'application n'a pas été ajoutée au serveur GUILD_ID ou les identifiants ont été intervertis. Refaites l'invitation ; vérifiez que CLIENT_ID est bien l'Application ID et GUILD_ID l'identifiant du serveur.
  • La commande ne répond pas ou Unknown interaction (10062) apparaît dans la console : si le bot ne tourne pas à ce moment-là, Discord indique que la commande n'a pas répondu ; si le bot tourne mais que la première réponse a pris plus de 3 secondes, cette erreur apparaît dans la console. Utilisez deferReply() pour les tâches longues. Ne faites pas tourner le bot à deux endroits à la fois avec le même token (par exemple sur votre ordinateur et sur le VDS) : les deux processus tenteraient de répondre à la même commande.
  • .env introuvable ou --env-file non reconnu : lancez la commande depuis le dossier du projet et, sous Windows, vérifiez que le nom du fichier n'est pas .env.txt. --env-file n'existe pas dans les versions de Node.js antérieures à 20.6.0 ; vérifiez votre version avec node -v et passez à la version LTS.

Questions fréquentes

De combien de RAM un bot simple a-t-il besoin ?

Un bot qui exécute des commandes slash sur quelques serveurs se contente de peu de ressources ; ses besoins augmentent avec le nombre de serveurs et de membres, les données mises en cache et les extras comme une base de données ou la musique. Lancez le bot et surveillez sa consommation de RAM dans les graphiques d'utilisation en direct de l'Espace client. Les offres VDS pour bot Discord sont fournies avec 2–4 Go de RAM.

Que faire si mon token a fuité ?

Cliquez immédiatement sur Reset Token sur la page Bot du Developer Portal. L'ancien token devient invalide ; écrivez la nouvelle valeur dans le fichier .env et redémarrez le bot. Si vous avez poussé le token dans un dépôt Git, le supprimer de l'historique du dépôt ne suffit pas : vous devez le réinitialiser.

Les anciens exemples de code trouvés sur Internet fonctionnent-ils en v14 ?

La plupart ne fonctionnent pas tels quels. En v14, on utilise GatewayIntentBits.Guilds au lieu de Intents.FLAGS.GUILDS, EmbedBuilder au lieu de MessageEmbed et ButtonBuilder au lieu de MessageButton ; les constantes de type chaîne comme 'STRING' sont aussi devenues des valeurs d'énumération comme ApplicationCommandOptionType.String. Si vous voyez ces anciens noms dans un code, ce code a été écrit pour la v13. La liste complète des classes et des méthodes se trouve dans la documentation de discord.js.

Guides associés

Les autres guides consacrés aux bots se trouvent sur la page Guides bot Discord ; les offres de serveurs, sur la page VDS pour bot Discord.

Commentaires0

Pas encore de commentaire

Soyez le premier à partager votre avis.

Rejoignez la discussion

Veuillez vous connecter ou vous inscrire pour laisser un commentaire.

Ne manquez aucun article

Recevez nos derniers tutoriels, guides et actualités produit dans votre boîte de réception.

Votre abonnement à notre newsletter est confirmé.