Guide · 1 septembre 2026 · 4 min de lecture

« Le bot ne marche pas » : par quoi commencer

Un bot qui semble en panne fonctionne presque toujours : il lui manque un droit, ou on lui demande quelque chose qu'il n'a pas le droit de faire. Voici les causes réelles, classées par fréquence — pas par ordre technique.

1. Le module n'a jamais été activé

C'est la première cause, et de loin. Installer un bot ne configure rien : chaque module — bienvenue, niveaux, tickets, auto-modération — démarre éteint. Attendre un message de bienvenue sans avoir activé le module donne exactement l'impression d'un bot cassé.

Le réflexe : vérifier l'état du module avant tout le reste. Une page de configuration qui montre ce qui est éteint autant que ce qui est allumé règle cette question en dix secondes.

2. Une permission manque dans ce salon précis

Un bot peut avoir toutes les permissions au niveau du serveur et aucune dans un salon donné : les permissions de salon l'emportent. Le symptôme typique est déroutant — le bot répond partout sauf dans un salon.

Les quatre permissions à vérifier en premier : voir le salon, envoyer des messages, intégrer des liens (sans elle, aucun embed n'apparaît), joindre des fichiers (sans elle, aucune image générée).

3. Le rôle du bot est trop bas

Un bot ne peut agir que sur les rôles situés en dessous du sien, et ne peut pas sanctionner quelqu'un dont le rôle le plus haut dépasse le sien. Cette règle vient de Discord et aucune permission ne la contourne — un bot administrateur placé en bas de liste échoue tout autant.

Symptômes : le bot sanctionne certains membres et pas d'autres, ou n'attribue pas un rôle précis alors que les autres passent. Correction : remonter le rôle du bot au-dessus de tous les rôles qu'il doit gérer.

4. La commande n'est pas déployée

Les commandes en barre oblique sont déclarées auprès de Discord, pas envoyées à chaque usage. Une commande récemment ajoutée peut mettre du temps à apparaître dans le menu, ou ne pas apparaître du tout si le déploiement a échoué.

Deux vérifications : fermer et rouvrir complètement Discord — le client garde une liste en cache ; et vérifier que le bot a bien été invité avec la portée des commandes d'application. Un bot invité sans elle rejoint le serveur et n'expose aucune commande.

5. Une restriction que vous avez posée

Commande réservée à un rôle, limitée à un salon, désactivée, ou en temps de recharge. Ce sont des réglages volontaires qu'on oublie avoir faits, surtout quand ils datent de plusieurs mois ou d'un autre administrateur.

Un signe distinctif : le bot répond pour refuser. Une commande qui ne produit aucune réaction relève des causes précédentes ; une commande qui explique qu'elle est réservée fonctionne parfaitement.

6. Le salon configuré n'existe plus

Un salon de logs supprimé, une catégorie renommée, un salon de bienvenue archivé : le module reste actif, pointe vers un salon disparu, et n'envoie plus rien. Rien n'échoue visiblement, ce qui rend le cas long à trouver.

C'est la raison pour laquelle un contrôle de santé — qui vérifie que chaque salon configuré existe encore et reste accessible — vaut mieux qu'un long dépannage après coup.

7. Ce n'est pas ce bot

Sur un serveur avec plusieurs bots, deux d'entre eux répondent parfois à la même commande, ou l'un supprime le message avant que l'autre ne le traite. Le comportement paraît erratique : la commande marche une fois sur deux.

Le test : retirer temporairement la permission d'envoyer des messages à l'autre bot dans le salon concerné. Si le problème disparaît, il s'agissait d'un conflit, pas d'une panne.

Ce qu'il faut donner en signalant un problème

Un signalement utile contient quatre choses : la commande exacte, le salon, ce qui s'est passé, et ce qui était attendu. « Le bot bug » ne permet aucune vérification ; « /rank dans #général ne répond rien depuis hier » se diagnostique en deux minutes.

Questions fréquentes

Le bot est en ligne mais ne répond à rien

Vérifiez d'abord la permission d'envoyer des messages dans le salon, puis la portée des commandes d'application lors de l'invitation. Ces deux causes couvrent la plupart des cas.

Les commandes n'apparaissent pas dans le menu

Redémarrez complètement le client Discord. Si elles restent absentes, réinvitez le bot avec la bonne portée : cela ne le fait pas quitter le serveur et ne remet rien à zéro.

Le bot répond mais n'agit pas

C'est presque toujours la hiérarchie des rôles, ou une permission spécifique manquante pour l'action demandée — bannir, gérer les rôles, gérer les salons.

Tout a cessé d'un coup

Regardez le journal d'audit du serveur : un changement de permissions ou de rôle du bot y figure, avec son auteur et son horodatage.

À lire ensuite : le panneau web, restreindre les commandes par rôle, auditer les permissions.