Comment héberger un bot Discord 24/7

​

Introduction

​

Prérequis

• Compte Square Cloud : Inscrivez-vous via la page d’inscription en utilisant votre adresse e-mail.
• Plan actif : Garantit des ressources dédiées et des performances optimisées pour votre application. Consultez nos plans disponibles et choisissez celui qui convient le mieux à vos besoins.

​

Créer le projet

​

Application bot sur Discord

Créer l'application

Accédez au Developer Portal et cliquez sur « New Application ». Définissez un nom pour votre bot et cliquez sur « Create » pour créer l’application.

Générer le token

Après avoir créé l’application, accédez à l’onglet « Bot » et cliquez sur « Reset Token » pour générer le token d’authentification. Copiez-le : vous le définirez comme variable d’environnement sur Square Cloud, jamais dans votre code.

Activer les intents privilégiés

Le bot d’exemple lit le texte des messages : il a donc besoin du Message Content Intent. Restez dans l’onglet « Bot », faites défiler jusqu’à « Privileged Gateway Intents » et activez Message Content Intent. Cet exemple n’a pas besoin des deux autres intents privilégiés (Presence et Server Members).

​

Développer le bot

npm init -y

npm install discord.js

const { Client, Events, GatewayIntentBits } = require("discord.js");

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    // Privileged: turn on "Message Content Intent" in the Developer Portal
    GatewayIntentBits.MessageContent,
  ],
});

client.once(Events.ClientReady, (readyClient) => {
  console.log(`Logged in as ${readyClient.user.tag}`);
});

client.on(Events.MessageCreate, (message) => {
  if (message.author.bot) return;
  if (message.content === "!hello") {
    message.reply("Hello!");
  }
});

// The token comes from the DISCORD_TOKEN environment variable
client.login(process.env.DISCORD_TOKEN);

pip install discord.py

import os

import discord
from discord.ext import commands

intents = discord.Intents.default()
# Privileged: turn on "Message Content Intent" in the Developer Portal
intents.message_content = True

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


@bot.event
async def on_ready():
    print(f"Logged in as {bot.user}")


@bot.command()
async def hello(ctx):
    await ctx.reply("Hello!")


# The token comes from the DISCORD_TOKEN environment variable
bot.run(os.environ["DISCORD_TOKEN"])

discord.py

​

Configurer Square Cloud

DISPLAY_NAME=My Discord Bot
MAIN=index.js
MEMORY=512
VERSION=recommended
AUTORESTART=true

DISPLAY_NAME=My Discord Bot
MAIN=main.py
MEMORY=512
VERSION=recommended
AUTORESTART=true

• MAIN est le fichier que Square Cloud exécute, et MEMORY la RAM du bot en Mo. Les bots ont besoin d’au moins 256 Mo ; 512 Mo laissent de la marge pour évoluer.
• AUTORESTART=true redémarre le bot s’il plante. Consultez le fonctionnement du redémarrage automatique.
• Il n’y a pas de SUBDOMAIN : un bot ne sert pas de pages web.

​

Définir le token du bot

• Tableau de bord : sur la page d’envoi, ouvrez Configuration avancée et ajoutez une variable nommée DISCORD_TOKEN avec votre token comme valeur. Pour un bot déjà déployé, ajoutez-la sur la page Variables d’environnement de l’application et redémarrez le bot.
• CLI : juste après avoir envoyé le bot (voir Déployer et vérifier), définissez-la avec squarecloud app env set et redémarrez le bot :

squarecloud app env set DISCORD_TOKEN=your_token_here
squarecloud app restart

​

Contenu du ZIP

• Votre fichier principal (index.js ou main.py) et vos autres fichiers source.
• package.json ou requirements.txt.
• squarecloud.app.

​

Déployer et vérifier

​

Via le tableau de bord

1

Accéder à la page d'upload

Accédez à la page d’upload et téléversez le fichier zip de votre projet.

2

Configurer votre environnement

Après avoir téléversé votre zip, vous devrez configurer le nom, le fichier principal ou l’environnement d’exécution ainsi que d’autres paramètres de votre projet.
Si vous téléversez un projet web, veillez à sélectionner « Publication Web » et à définir un sous-domaine pour votre projet.

3

Déployer votre projet

Enfin, cliquez sur le bouton « Deploy » pour héberger votre projet sur Square Cloud.
Une fois le déploiement effectué, vous pouvez suivre l’état et les logs de votre projet depuis le tableau de bord.

4

Confirmez que votre application est en ligne

Votre premier déploiement prend généralement moins d’une minute. Dans le tableau de bord, attendez que le statut de votre application affiche « en cours d’exécution » et vérifiez les logs pour détecter d’éventuelles erreurs de démarrage.
Si vous avez déployé un site web ou une API, ouvrez https://<votre-sous-domaine>.squareweb.app dans votre navigateur, vous devriez voir votre application répondre. Si vous avez déployé un bot, envoyez-lui une commande pour confirmer qu’il est en ligne.

Votre application ne démarre pas ? Consultez le guide de dépannage pour les causes les plus courantes et leurs solutions.

​

Via la CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

Inviter le bot sur votre serveur

1. Accédez au Developer Portal et sélectionnez votre bot.
2. Accédez à l’onglet « OAuth2 » puis à « OAuth2 URL Generator ».
3. Sous « Scopes », cochez l’option « bot ».
4. Sous « Bot Permissions », cochez uniquement ce dont l’exemple a besoin : View Channels, Send Messages et Read Message History. Évitez Administrator : les bots en ont rarement besoin, et un token divulgué contrôlerait alors tout votre serveur.
5. Copiez l’URL générée, ouvrez-la dans votre navigateur et ajoutez le bot à votre serveur. L’URL ressemble à ceci :

https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=68608&scope=bot

​

Erreurs courantes

​

An invalid token was provided

​

Used disallowed intents

​

Le bot est en ligne mais ne répond pas à !hello

​

Prochaines étapes

​

Contactez-nous