Aller au contenu

Tutoriel

Slash commands Discord : le guide pour bien démarrer

Fini les commandes à préfixe du type !play : Discord a imposé les slash commands. Plus lisibles, plus sûres et découvrables directement dans le champ de saisie. Voici comment les mettre en place proprement.

Publié le 3 min de lecturePar Jupiter

Slash commands d'un bot Discord hébergé 24/7 chez TalCloud

Pourquoi les slash commands ont tout changé

Avant, un bot Discord réagissait à des messages commençant par un préfixe : !aide, ?play, .ban… Le bot devait lire tous les messages pour repérer les commandes, ce qui posait des problèmes de permissions et de confidentialité.

Les slash commands renversent la logique. L’utilisateur tape /, et Discord affiche la liste des commandes disponibles, avec leur description et leurs options. Le bot ne reçoit que ce qui le concerne : une interaction propre, structurée, envoyée par Discord.

Les avantages sont concrets :

  • Découvrables : les utilisateurs voient les commandes en tapant /.
  • Plus sûres : plus besoin de lire tous les messages du serveur.
  • Validées : Discord vérifie les options (nombre, utilisateur, choix) avant même que votre bot n’agisse.

Bon à savoir : depuis que Discord a restreint l'accès au contenu des messages, les slash commands sont devenues la norme. Un bot moderne se construit autour d'elles, pas autour des préfixes.

Comment ça fonctionne

Une slash command suit trois temps :

  1. L’enregistrement : vous déclarez la commande (nom, description, options) auprès de Discord.
  2. L’interaction : quand un utilisateur l’exécute, Discord envoie une interaction à votre bot.
  3. La réponse : votre bot répond dans un délai court (sinon Discord considère la commande échouée).

En Python, cela passe par app_commands (discord.py) ; en Node.js, par le SlashCommandBuilder de discord.js v14. Si vous débutez, suivez d’abord créer un bot Discord en Python ou en Node.js pour poser les bases.

Enregistrement global ou par serveur ?

C’est le point qui déroute le plus les débutants.

TypePortéeDélai de mise à jour
Par serveur (guild)Un seul serveurQuasi instantané
GlobalTous les serveursJusqu’à ~1 heure

En développement, enregistrez vos commandes par serveur : elles apparaissent immédiatement, idéal pour tester. En production, basculez en global pour qu’elles soient disponibles partout - en acceptant un délai de propagation.

Piège classique : « ma slash command n'apparaît pas ». Neuf fois sur dix, c'est un enregistrement global tout juste effectué : il faut attendre la propagation, ou tester en enregistrement par serveur.

Les pièges à éviter

  • Répondre trop tard. Si un traitement est long (appel à une API, base de données), répondez d’abord un « en cours… » puis complétez, sinon l’interaction expire.
  • Oublier les permissions. Une commande d’administration doit être restreinte via les permissions Discord.
  • Doublonner les commandes. Enregistrer la même commande en global et par serveur crée des doublons visibles pour l’utilisateur.

Pour d’autres soucis fréquents (intents, permissions, connexion), voir les erreurs fréquentes d’un bot Discord.

Un bot qui répond suppose un bot en ligne

Une slash command ne fonctionne que si votre bot est connecté au moment où l’utilisateur l’exécute. Un bot hébergé sur votre PC devient injoignable dès qu’il est éteint. Pour un service fiable, il faut un hébergement 24/7 avec redémarrage automatique - c’est exactement ce que fournit notre hébergement de bot Discord, Python et Node.js préinstallés.

En résumé

Les slash commands sont la façon moderne et sûre de piloter un bot Discord : découvrables, validées par Discord, sans lecture de tous les messages. Retenez la distinction enregistrement par serveur (instantané, pour développer) contre global (partout, avec délai), répondez toujours à temps, et gérez les permissions. Le tout suppose un bot réellement en ligne 24/7 pour être utile à votre communauté.

Articles liés