Pourquoi mes commandes slash ne s’affichent-elles pas ?

Après tree.sync(), Discord peut mettre jusqu’à une heure à afficher partout les commandes enregistrées globalement. Pour les tester, tu peux les synchroniser directement sur un seul serveur afin qu’elles soient disponibles immédiatement.

Programmer ton propre bot Discord avec discord.py

Q: Mon bot reste hors ligne : que vérifier en premier ?

Vérifie que le token est correctement défini dans la variable d’environnement DISCORD_TOKEN et qu’aucun message d’erreur n’apparaît dans le journal du service.

Apprends étape par étape à créer ton propre bot Discord avec Python et discord.py, puis à le déployer sur ZapX.

10 novembre 20263 min de lecture0 Vues0 utile

Introduction

Dans ce guide, tu vas créer ton propre bot Discord de zéro avec Python et la bibliothèque discord.py. Tu vas enregistrer l’application du bot dans le Discord Developer Portal, écrire une structure de base fonctionnelle avec une commande slash personnalisée, puis déployer le bot sur ton hébergement de bot Discord ZapX. Des connaissances de base en Python sont utiles, mais pas indispensables.

Préparation

Avant de commencer à coder, tu as besoin d’une application de bot sur Discord :

Ouvre le Discord Developer Portal et clique sur New Application. Choisis un nom pour ton bot.
Dans le menu de gauche, ouvre l’onglet Bot. Tu trouveras le Token de ton bot en cliquant sur Reset Token. Copie le token et conserve-le en lieu sûr : il donne un accès complet à ton bot et ne doit jamais être inclus dans ton code ni partagé publiquement.
Sur la même page, sous Privileged Gateway Intents, active Message Content Intent si tu veux que ton bot réagisse au contenu des messages (par exemple, aux commandes textuelles).
Ouvre l’onglet OAuth2 → URL Generator. Sélectionne le scope bot, ainsi que applications.commands (pour les commandes slash). Choisis ensuite les permissions nécessaires à ton bot, puis ouvre le lien généré pour inviter le bot sur ton serveur Discord.

Écrire le bot en Python

Commence par installer discord.py dans ton environnement de développement :

bash

pip install -U discord.py

Crée un fichier main.py et mets en place la structure de base de ton bot :

python

import os
import discord
from discord import app_commands

intents = discord.Intents.default()
intents.message_content = True

client = discord.Client(intents=intents)
tree = app_commands.CommandTree(client)


@client.event
async def on_ready():
    await tree.sync()
    print(f"Bot ist online als {client.user}")


@tree.command(name="hallo", description="Begrüßt dich mit einer kurzen Nachricht")
async def hallo(interaction: discord.Interaction):
    await interaction.response.send_message(f"Hallo {interaction.user.mention}!")


client.run(os.environ["DISCORD_TOKEN"])

Ici, le token n’est volontairement pas écrit directement dans le code : il est récupéré via la variable d’environnement DISCORD_TOKEN (os.environ["DISCORD_TOKEN"]). Ton token reste ainsi en dehors du code, ce qui constitue la base de l’étape de déploiement ci-dessous.

Si tu veux aussi réagir à l’arrivée de nouveaux membres sur le serveur, par exemple en leur envoyant un message de bienvenue, ajoute un autre gestionnaire d’événement :

python

@client.event
async def on_member_join(member: discord.Member):
    channel = discord.utils.get(member.guild.text_channels, name="willkommen")
    if channel:
        await channel.send(f"Willkommen auf dem Server, {member.mention}!")

Déployer le bot sur l’hébergement de bot Discord ZapX

Crée un nouveau service de bot Discord dans le panneau client ZapX si ce n’est pas déjà fait.
Lors de la configuration, sélectionne Python 3.12 comme runtime.
Envoie ton fichier main.py (et, si tu en as une, un fichier requirements.txt contenant les paquets supplémentaires) dans le répertoire du service, à l’aide du gestionnaire de fichiers intégré ou du téléversement de fichiers.

Gestionnaire de fichiers du bot Discord ZapX

Dans l’onglet Einstellungen, saisis le token du bot que tu as créé précédemment sous Bot-Konfiguration → Discord Bot Token, puis enregistre les paramètres. Ton token reste ainsi séparé du code et tu n’as pas besoin de le modifier lors d’un nouvel envoi de fichiers. En arrière-plan, cette valeur reste accessible dans ton code via la variable d’environnement DISCORD_TOKEN.

Paramètres du bot Discord ZapX avec le champ du token

5. Démarre le service. Si tout fonctionne correctement, ton bot affiche Bot ist online als ... dans le journal et apparaît « En ligne » sur ton serveur Discord.

Dépannage

Le bot reste hors ligne : vérifie que le token est correctement défini dans la variable d’environnement DISCORD_TOKEN et qu’aucun message d’erreur n’apparaît dans le journal du service.

Les commandes slash ne s’affichent pas : après tree.sync(), Discord peut mettre jusqu’à une heure à afficher partout les commandes enregistrées globalement. Pour les tester, synchronise plutôt les commandes directement sur un seul serveur : elles seront alors disponibles immédiatement.

« Missing Access » ou autres erreurs de permission : le bot ne dispose pas des autorisations nécessaires sur le serveur. Vérifie les autorisations de rôle du bot et assure-toi d’avoir sélectionné les bonnes permissions dans l’URL Generator OAuth2 lors de son invitation.

Conclusion

Tu as créé un bot Discord fonctionnel avec discord.py, tu l’as doté d’une commande slash personnalisée et tu l’as déployé sur ton hébergement de bot Discord ZapX. Tu peux maintenant l’enrichir à ta guise avec d’autres commandes, des fonctions de modération ou des intégrations.

FAQ

Questions fréquentes

Tu as besoin d’une application de bot dans le Discord Developer Portal. Crée une New Application, récupère ton token dans l’onglet Bot en cliquant sur « Reset Token », puis génère le lien d’invitation de ton serveur dans OAuth2 URL Generator avec les scopes « bot » et « applications.commands ».

Le token n’est volontairement pas écrit directement dans le code : il est récupéré via la variable d’environnement DISCORD_TOKEN (os.environ["DISCORD_TOKEN"]). Dans l’hébergement de bot Discord ZapX, saisis-le dans l’onglet Einstellungen, sous Bot-Konfiguration -> Discord Bot Token.

Python 3.12.

Avis

Cet article t’a-t-il été utile ?

Ton avis nous aide à mieux définir les priorités et à améliorer les contenus.

0 de 0 Les personnes ayant donné leur avis ont trouvé cet article utile.

Aide personnalisée

Le guide ne suffit pas ?

Notre équipe d’assistance ZAP connaît ton produit : décris brièvement ta demande et nous t’aiderons personnellement.

Quels 🍪 cookies acceptes-tu ?

Programmer ton propre bot Discord avec discord.py

Introduction

Préparation

Écrire le bot en Python

Déployer le bot sur l’hébergement de bot Discord ZapX

Dépannage

Conclusion

Questions fréquentes

Bot Discord

Préparation

Écrire le bot en Python

Déployer le bot sur l’hébergement de bot Discord ZapX

Dépannage

Conclusion

Serveur de jeu

Serveurs et hébergement

ZAPX

Ressources

ZAP-Hosting