Documentation

Tout ce dont vous avez besoin pour déployer et gérer vos bots Discord sur BotHost.

Démarrage rapide

Bienvenue sur BotHost ! Ce guide vous accompagnera pour déployer votre premier bot Discord en quelques minutes.

Créez un compte sur BotHost et connectez-vous à votre dashboard.
Créez un nouveau bot en cliquant sur "Nouveau Bot" et choisissez votre langage (Python ou Node.js).
Uploadez vos fichiers via l'interface ou connectez votre repository GitHub.
Configurez vos variables d'environnement (TOKEN, etc.).
Déployez et votre bot est en ligne !

Astuce

Vous pouvez tester gratuitement pendant 7 jours avec notre plan Starter, aucune carte bancaire requise !

Créer un bot Discord

Avant de déployer sur BotHost, vous devez créer une application Discord :

Rendez-vous sur le Discord Developer Portal.
Cliquez sur "New Application" et donnez un nom à votre bot.
Allez dans l'onglet "Bot" et cliquez sur "Add Bot".
Copiez le Token de votre bot (gardez-le secret !).
Dans "OAuth2 > URL Generator", sélectionnez les scopes et permissions nécessaires.
Utilisez l'URL générée pour inviter le bot sur votre serveur.

Important

Ne partagez jamais votre token ! Si votre token est compromis, régénérez-le immédiatement sur le Developer Portal.

Déployer votre bot

Une fois vos fichiers prêts, voici comment les déployer sur BotHost :

Via l'interface web

Allez sur votre bot dans le dashboard.
Cliquez sur "Fichiers" puis "Upload".
Sélectionnez vos fichiers ou glissez-déposez-les.
Cliquez sur "Déployer".

Via GitHub (recommandé)

Connectez votre compte GitHub dans les paramètres.
Sélectionnez votre repository et la branche.
Activez le déploiement automatique (optionnel).
Chaque push déclenchera un nouveau déploiement.

Bots Python

BotHost supporte Python 3.10+ avec les principales bibliothèques Discord.

Structure recommandée

                        
# Structure de fichiers
my-bot/
├── main.py          # Point d'entrée
├── requirements.txt # Dépendances
├── cogs/            # Commandes (optionnel)
└── utils/           # Utilitaires (optionnel)
                        
                    

requirements.txt

                        
discord.py>=2.0.0
python-dotenv
aiohttp

Exemple de bot

                        
import discord
from discord.ext import commands
import os

bot = commands.Bot(
    command_prefix="!",
    intents=discord.Intents.all()
)

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

@bot.command()
async def ping(ctx):
    await ctx.send(f"🏓 Pong! {round(bot.latency * 1000)}ms")

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

Bots Node.js

BotHost supporte Node.js 18+ avec discord.js v14.

Structure recommandée

                        
# Structure de fichiers
my-bot/
├── index.js         # Point d'entrée
├── package.json     # Dépendances
├── commands/        # Commandes slash
└── events/          # Événements
                        
                    

package.json

                        
{
  "name": "my-discord-bot",
  "version": "1.0.0",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "discord.js": "^14.0.0",
    "dotenv": "^16.0.0"
  }
}
                        
                    

Exemple de bot

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

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

client.on('ready', () => {
    console.log(`✅ Connecté en tant que ${client.user.tag}`);
});

client.on('messageCreate', async (message) => {
    if (message.content === '!ping') {
        await message.reply(`🏓 Pong! ${client.ws.ping}ms`);
    }
});

client.login(process.env.DISCORD_TOKEN);
                        
                    

Variables d'environnement

Les variables d'environnement permettent de stocker des données sensibles comme votre token Discord de manière sécurisée.

Ajouter des variables

Allez sur votre bot dans le dashboard.
Cliquez sur "Paramètres" puis "Variables d'environnement".
Ajoutez vos variables (clé/valeur).
Redéployez votre bot pour appliquer les changements.

Variables courantes

DISCORD_TOKEN - Token de votre bot Discord
PREFIX - Préfixe des commandes (!)
DATABASE_URL - URL de connexion à la BDD

Logs et monitoring

Surveillez l'activité de votre bot en temps réel grâce aux logs.

Accéder aux logs

Ouvrez le dashboard de votre bot.
Cliquez sur l'onglet "Logs".
Les logs s'affichent en temps réel.

Bonnes pratiques

Utilisez print() en Python ou console.log() en JS pour débugger.
Évitez de logger des informations sensibles (tokens, mots de passe).
Utilisez des préfixes pour différencier les types de logs ([INFO], [ERROR], etc.).

Dépannage

Voici les problèmes les plus courants et leurs solutions :

❌ Mon bot ne démarre pas

Vérifiez que le fichier principal est bien nommé (main.py ou index.js).
Vérifiez que le DISCORD_TOKEN est configuré dans les variables d'environnement.
Consultez les logs pour identifier l'erreur.

❌ Erreur "Token invalid"

Vérifiez que le token est correct et complet.
Régénérez le token sur le Discord Developer Portal si nécessaire.
Assurez-vous qu'il n'y a pas d'espaces ou de caractères supplémentaires.

❌ Le bot se déconnecte régulièrement

Vérifiez que vous n'avez pas dépassé les limites de ressources de votre plan.
Optimisez votre code pour réduire la consommation mémoire.
Considérez un upgrade vers un plan supérieur.

❌ Les dépendances ne s'installent pas

Vérifiez la syntaxe de votre requirements.txt ou package.json.
Assurez-vous que les versions sont compatibles.
Essayez de spécifier des versions exactes.

Besoin d'aide ?

Si vous ne trouvez pas la solution à votre problème, n'hésitez pas à contacter notre support ou à rejoindre notre serveur Discord.