Créer votre premier bot Discord est plus facile que vous ne le pensez. Vous n'avez pas besoin d'une licence en informatique ou d'années d'expérience de programmation. En 2026, construire et déployer un bot fonctionnel prend un week-end si vous êtes focalisé.
Ce guide vous marche à travers le processus entier : enregistrer votre bot, écrire votre première commande, le tester localement et le déployer en direct. À la fin, vous aurez un bot fonctionnant sur votre serveur.
Comprendre ce qu'est un bot Discord
Un bot Discord est un programme qui se connecte à Discord via l'API et répond aux événements : quand quelqu'un tape une commande, réagit à un message, rejoint le serveur, etc.
Concepts clés :
- Application contre Bot: Votre "application" est enregistrée dans le Portail des développeurs Discord. Le "bot" est le compte utilisateur associé à cette application. Une application a un bot.
- Tokens: Une clé secrète qui authentifie votre bot. Ne la partagez jamais. C'est comme un mot de passe pour votre bot.
- Intents: Les permissions qui laissent votre bot voir certains événements (messages, réactions, changements de statut de membre, etc.). Vous n'activez que ce dont vous avez besoin.
- Commandes: Les bots répondent aux commandes. Les bots modernes utilisent les commandes slash (
/command) plutôt que les commandes préfixe (!command). Les commandes slash sont officiellement supportées et recommandées. - Événements: Votre bot écoute les événements Discord (message envoyé, réaction ajoutée, membre rejoint) et y réagit.
Étape 1 : Enregistrer votre bot dans le Portail des développeurs Discord
C'est là que votre bot existe officiellement dans le système Discord.
Processus :
- Allez sur Discord Developer Portal
- Connectez-vous avec votre compte Discord
- Cliquez sur "New Application"
- Nommez-le (ex. "My First Bot")
- Cliquez sur "Create"
- Vous êtes maintenant dans les paramètres de votre application
Maintenant créez l'utilisateur bot :
- Allez dans la section "Bot" (sidebar gauche)
- Cliquez sur "Add Bot"
- Sous le nom d'utilisateur du bot, vous verrez un bouton "TOKEN"
- Copiez le token — c'est comment votre bot s'authentifie. Gardez-le secret. Ne le partagez jamais publiquement ou ne le committez pas sur GitHub sans chiffrement.
Configurez les paramètres du bot :
- Activez "Message Content Intent" (laisse le bot lire le texte des messages)
- Activez "Server Members Intent" (laisse le bot voir qui est dans le serveur)
- Faites défiler vers la section "OAuth2"
Étape 2 : Générer le lien d'invitation de votre bot
Vous avez besoin d'un lien d'invitation spécial pour ajouter le bot à un serveur.
Dans le Portail des développeurs :
- Allez dans "OAuth2" → "URL Generator"
- Sous "SCOPES", cochez :
bot - Sous "PERMISSIONS", sélectionnez ce que votre bot peut faire :
Send Messages(essentiel pour tout bot)Manage Messages(si vous modérez)Add Reactions(si le bot réagit à des choses)Connect+Speak(si c'est un bot musique/voix)- Pour l'apprentissage, sélectionnez juste
Send Messages+Read Messages(minimum viable)
- Copiez l'URL générée en bas
- Partagez cette URL avec les propriétaires de serveurs (ou utilisez-la pour l'ajouter à votre propre serveur de test)
N'utilisez pas la permission Administrateur à moins qu'absolument nécessaire. Sur-permissionner c'est un risque de sécurité.
Étape 3 : Choisir votre langue et framework
Deux options principales pour les débutants :
JavaScript (discord.js)
Discord.js est le framework de bot Discord le plus populaire. Énorme communauté, tonnes de tutoriels et excellente documentation.
Avantages :
- Plus grande communauté et plus de tutoriels en ligne
- La documentation de discord.js est excellente
- Node.js est largement utilisé et facile à apprendre
- Déploiement facile sur la plupart des plateformes d'hébergement
Inconvénients :
- JavaScript a des bizarreries (courbe d'apprentissage async/await)
- Node.js ajoute une surcharge mémoire vs Python
Commencez :
- Installez Node.js (v18+)
- Créez un dossier de projet
npm init -ynpm install discord.js
Python (discord.py)
Syntaxe plus simple, super pour les débutants, excellent pour apprendre les fondamentaux.
Avantages :
- Syntaxe la plus facile à apprendre
- Intuitive pour les débutants
- La documentation de discord.py est bonne
- Python est utilisé partout (science des données, web, automation)
Inconvénients :
- Plus petite communauté que discord.js (mais toujours grande)
- Moins de tutoriels que JavaScript
- Utilisation mémoire légèrement supérieure
Commencez :
- Installez Python 3.10+
- Créez un dossier de projet
pip install discord.py
Recommandation pour débutants : Si vous connaissez Python, utilisez discord.py. Si vous connaissez JavaScript, utilisez discord.js. Si vous ne connaissez aucun, Python est plus facile à apprendre, mais JavaScript a plus de ressources en ligne. Choisissez-en un et engagez-vous.
Étape 4 : Écrivez votre premier bot (exemple Python)
Voici un bot Discord minimal fonctionnel en Python qui répond à une commande :
import discord
from discord.ext import commands
# Créez le bot avec le préfixe de commande et les intents
intents = discord.Intents.default()
intents.message_content = True
bot = commands.Bot(command_prefix='!', intents=intents)
@bot.event
async def on_ready():
print(f'{bot.user} has connected to Discord!')
@bot.command(name='hello', help='Says hello')
async def hello(ctx):
await ctx.send(f'Hello {ctx.author.name}!')
@bot.command(name='ping', help='Responds with pong')
async def ping(ctx):
await ctx.send('Pong!')
bot.run('YOUR_TOKEN_HERE')
Ce que ça fait :
- Se connecte à Discord
- Écoute les commandes
!helloet!ping - Répond avec un message quand déclenché
Pour l'exécuter :
- Remplacez
'YOUR_TOKEN_HERE'avec votre vrai token d'étape 1 - Enregistrez comme
bot.py - Exécutez :
python bot.py - Dans Discord, tapez
!hellodans tout canal - Le bot répond : "Hello [VotreName]!"
Étape 5 : Testez localement
Avant de déployer, testez votre bot localement (sur votre ordinateur).
Configurez un serveur de test :
- Créez un serveur Discord privé pour le test
- Ajoutez votre bot using le lien d'invitation d'étape 2
- Exécutez votre code de bot localement
- Tapez les commandes dans le serveur de test
- Regardez les erreurs dans votre terminal ; corrigez-les
Erreurs courantes :
- "Invalid token" — Vous avez mal copié le token ou il est expiré. Régénérez dans le Portail des développeurs.
- "Missing permissions" — Le bot n'a pas la permission de faire cette action dans ce canal. Ajoutez les permissions ou utilisez un canal où le bot a plus de droits.
- "Intents are not enabled" — Vous avez besoin d'activer les intents dans le Portail des développeurs (Message Content Intent, Server Members Intent, etc.)
Testez à fond. Un bot avec des bugs en production c'est embarrassant.
Étape 6 : Ajoutez plus de commandes
Maintenant que vous comprenez les bases, expandez avec plus de fonctionnalités.
Exemple Python — une simple commande d'économie :
@bot.command(name='balance', help='Check your coin balance')
async def balance(ctx):
# Dans un vrai bot, ça interrogerait une base de données
# Pour l'instant, renvoyez juste une valeur simulée
await ctx.send(f'{ctx.author.name}, you have 100 coins!')
@bot.command(name='roll', help='Roll a dice (1-6)')
async def roll(ctx):
import random
result = random.randint(1, 6)
await ctx.send(f'{ctx.author.name} rolled: **{result}**')
Chaque commande est une simple fonction. Ajoutez-en autant que vous voulez.
Étape 7 : Déployez votre bot
L'hébergement local fonctionne pour tester, mais votre bot s'arrête quand vous fermez votre laptop. Déployez sur un serveur pour l'exécuter 24/7.
Options d'hébergement gratuit
Replit (le plus facile pour les débutants) :
- Allez à Replit.com
- Créez nouveau Repl → Python (ou Node.js)
- Collez votre code de bot
- Cliquez "Run"
- Replit l'héberge gratuitement (avec limitations : peut hiberner après inactivité)
Railway.app (moderne, fiable) :
- Allez à Railway.app
- Connectez GitHub (ou uploadez les fichiers directement)
- Créez nouveau projet → sélectionnez votre bot
- Railway déploie automatiquement
- Le niveau gratuit inclut $5 de crédit mensuel
Glitch (similaire à Replit) :
- Allez à Glitch.com
- Créez nouveau projet
- Collez le code
- Glitch le garde fonctionnant (dans les limites du niveau gratuit)
Important : Ne codez pas votre token en dur dans le code que vous pushez sur GitHub. Utilisez les variables d'environnement :
import os
from dotenv import load_dotenv
load_dotenv()
TOKEN = os.getenv('DISCORD_TOKEN')
bot.run(TOKEN)
Créez un fichier .env localement (ajoutez à .gitignore donc il ne soit pas committable) :
DISCORD_TOKEN=your_actual_token_here
Sur Replit/Railway, réglez le token comme une variable d'environnement secrète dans les paramètres de la plateforme (pas dans le code).
Erreurs courantes des débutants
Erreur 1 : Coder le token en dur Ne mettez jamais votre token dans le code que vous pushez sur GitHub. Les bots avec des tokens divulgués sont compromis instantanément. Utilisez les variables d'environnement.
Erreur 2 : Ne pas gérer les erreurs Votre bot crash sur une input inattendue. Ajoutez la gestion d'erreurs :
@bot.command()
async def divide(ctx, a: int, b: int):
try:
result = a / b
await ctx.send(result)
except ZeroDivisionError:
await ctx.send('Cannot divide by zero!')
except ValueError:
await ctx.send('Please enter valid numbers!')
Erreur 3 : Ne pas respecter les limites de taux Discord limite la vitesse d'envoi de messages. Ne spammez pas l'API. Ajoutez des délais entre les actions en masse.
Erreur 4 : Ignorer les intents Beaucoup de bots débutants échouent parce qu'ils n'activent pas les intents nécessaires dans le Portail des développeurs. Vérifiez les intents dont votre bot a besoin avant de déployer.
Erreur 5 : Portée trop ambitieuse N'essayez pas de construire un système économique, modération, musique et 50 commandes dans votre premier bot. Commencez avec 3-5 commandes simples. Expandez une fois à l'aise.
Prochaines étapes
Maintenant que vous avez un bot basique :
- Expandez les fonctionnalités : Ajoutez plus de commandes, utilisez les bases de données pour persister les données, implémentez la logique complexe
- Utilisez les commandes slash : Syntaxe moderne
/commandplutôt que les commandes préfixe - Ajoutez les réactions : Laissez les utilisateurs cliquer les boutons ou réagir avec les emojis
- Connectez une base de données : Stockez les données utilisateurs, coins, préférences (SQLite pour débutants, PostgreSQL pour l'échelle)
- Rejoignez les communautés : Les communautés de développeurs de bots Discord (reddit.com/r/discordbots, serveur de support Discord.js) ont les réponses à chaque question
Ressources
- Documentation discord.js : https://discord.js.org
- Documentation discord.py : https://discordpy.readthedocs.io
- Documentation API Discord : https://discord.com/developers/docs/intro
- Tutoriels YouTube : Recherchez "[discord.js/discord.py] tutorial" — quantité énorme de contenu
Votre premier bot Discord est un projet de week-end. Votre premier bon bot Discord est un mois de pratique. Votre premier bot utilisé par 1000 serveurs est des mois d'itération, développement de fonctionnalités et construction communautaire. Commencez maintenant, itérez constamment et ne le suranalysez pas.