Documentation
Learning Centre

Maîtrisez Telegram Bot App grâce à des guides, tutoriels et ressources documentaires complets

Liens rapides

Avertissements, signalements et journal de modération

Introduction

Toutes les décisions de modération ne doivent pas forcément mener à un bannissement immédiat. Un membre qui enfreint une règle une seule fois a peut-être simplement besoin d’un rappel ; un membre qui continue à enfreindre les règles doit, lui, faire face à une conséquence claire et prévisible. Cet ensemble de fonctionnalités donne aux administrateurs une manière progressive de gérer les comportements : une échelle d’avertissements qui ne mène à un bannissement qu’après plusieurs écarts, un moyen pour les membres ordinaires de signaler les messages problématiques aux administrateurs, et un journal privé qui enregistre les actions effectuées par le système de modération.

Chaque fonctionnalité est désactivée par défaut et n’effectue aucune action tant qu’un administrateur ne l’a pas activée dans le tableau de bord du groupe. Activer le bot ne déclenche pas discrètement l’envoi d’avertissements ou le bannissement de membres.

L’échelle d’avertissements

L’échelle d’avertissements permet aux administrateurs d’attribuer des avertissements à un membre. Lorsque le nombre d’avertissements atteint une limite configurée, le membre est automatiquement banni et son compteur est réinitialisé. Elle est contrôlée par deux paramètres :

  • set_warnings_enabled — l’interrupteur d’activation/désactivation. Désactivé par défaut.
  • set_warn_limit — le nombre d’avertissements qui déclenche un bannissement. Par défaut : 3.

Trois commandes réservées aux administrateurs permettent de gérer les avertissements :

  • /warn — attribuer un avertissement. Répondez au message du membre, ou indiquez son identifiant numérique ou son @handle. Vous pouvez ajouter une raison facultative, par exemple /warn @user spamming links.
  • /unwarn — retirer un avertissement à un membre, au cas où il aurait été attribué par erreur.
  • /warns — vérifier combien d’avertissements un membre a actuellement, par rapport à la limite.

Lorsqu’un /warn fait atteindre la limite à un membre — par exemple son troisième avertissement avec la limite par défaut de 3 — le bot le bannit et remet son compteur d’avertissements à zéro. En dessous de la limite, le bot enregistre le nouvel avertissement et répond avec le compteur actuel, afin que l’administrateur comme le membre sachent où en est la situation. Le message de commande lui-même est supprimé après traitement, ce qui permet de garder la discussion lisible.

Ces trois commandes sont réservées aux administrateurs. Un membre ordinaire qui tente de les utiliser se voit refuser l’action, et personne ne peut s’avertir soi-même.

Signalements par les membres

Les signalements permettent aux membres ordinaires d’attirer l’attention des administrateurs sur un message. Il s’agit volontairement d’une fonctionnalité destinée aux membres, et non aux administrateurs : les personnes qui lisent la discussion sont souvent les premières à remarquer un problème. Elle est contrôlée par un seul paramètre :

  • set_reports_enabled — l’interrupteur d’activation/désactivation. Désactivé par défaut.

Pour signaler un message, un membre y répond et envoie /report, éventuellement avec une courte raison. Le bot publie une notification dans le groupe afin que les administrateurs puissent voir quel message a été signalé et par qui, puis enregistre le signalement dans le journal de modération si celui-ci est configuré.

Deux règles empêchent les signalements de devenir gênants :

  • Limitation du rythme. Chaque membre ne peut effectuer qu’un signalement toutes les 30 secondes. Les signalements répétés pendant cet intervalle sont ignorés discrètement, afin que personne ne puisse spammer les administrateurs avec des notifications de signalement.
  • Discussion propre. Le message de commande /report est toujours supprimé après traitement, que le signalement soit accepté ou non, afin que la conversation signalée ne soit pas encombrée par des commandes de signalement.

Un signalement ne sanctionne personne à lui seul. C’est un signal envoyé aux administrateurs, qui décident ensuite d’avertir, de restreindre, de bannir ou de ne rien faire.

Le journal de modération

Le journal de modération réplique les actions du système de modération dans un canal séparé, afin que les administrateurs disposent d’un historique continu sans devoir surveiller le groupe en temps réel. Il est contrôlé par un paramètre :

  • set_modlog_channel_id — l’identifiant numérique du canal qui reçoit le journal. Définissez-le dans le tableau de bord d’administration du groupe, dans la section Modération automatique. Le laisser vide (valeur par défaut) désactive le journal.

Lorsqu’un identifiant de canal est défini, le bot publie une entrée d’une ligne pour les événements de modération au moment où ils se produisent. Cela inclut les avertissements émis, les bannissements (aussi bien ceux déclenchés par la limite d’avertissements que d’autres bannissements automatisés, comme celui d’un abuseur connu), les signalements de membres et les verrouillages anti-raid. Chaque entrée indique l’action, le membre concerné, ainsi que l’administrateur ou le système à l’origine de l’action.

Pour que le journal fonctionne, le bot doit être administrateur du canal cible — c’est ce qui lui permet d’y publier des messages. Si le bot n’est pas administrateur du canal, les entrées du journal ne peuvent pas être envoyées. Le journal fonctionne au mieux : l’échec de publication d’une entrée ne bloque jamais l’action de modération elle-même, qui est tout de même appliquée dans le groupe.

Comment ces fonctionnalités s’articulent

Ces trois fonctionnalités se complètent. Les signalements permettent aux membres de faire remonter les problèmes. L’échelle d’avertissements permet aux administrateurs de répondre de manière proportionnée, avec une escalade seulement lorsqu’un membre ne s’arrête pas. Le journal de modération enregistre les deux, offrant à l’équipe d’administration un historique commun de ce qui s’est passé et de qui est intervenu. Une configuration courante consiste à activer les trois : les membres signalent, les administrateurs avertissent, et tout arrive dans le canal de journal pour examen.

Bonnes pratiques

  • Définissez la limite d’avertissements selon le niveau de tolérance de votre communauté. Une limite de 3 donne aux membres deux chances avant un bannissement ; augmentez-la pour un groupe plus indulgent, réduisez-la pour un groupe plus strict.
  • Privilégiez l’utilisation de /warn en réponse au message fautif — cela cible le bon membre avec un risque minimal d’erreur de saisie d’identifiant.
  • Utilisez /warns avant une décision de bannissement pour vérifier si un membre est récidiviste ou s’il s’agit d’une première infraction.
  • Créez un canal privé pour le journal de modération, ajoutez-y le bot comme administrateur, puis définissez son identifiant dans le tableau de bord afin que votre équipe dispose d’une piste d’audit.
  • Activez les signalements dans les grands groupes où les administrateurs ne peuvent pas lire tous les messages ; les membres deviennent alors une paire d’yeux supplémentaire.

Résumé

Les avertissements, les signalements et le journal de modération transforment la modération, en la faisant passer d’une série de bannissements ponctuels à un véritable système. Les membres signalent les problèmes avec /report, les administrateurs attribuent des avertissements progressifs avec /warn, /unwarn et /warns, un membre n’est automatiquement banni qu’après avoir atteint la limite configurée, et chaque action est répliquée dans un canal de journal lorsqu’il est configuré. Tout reste désactivé tant qu’un administrateur ne l’active pas, et les commandes d’avertissement sont réservées aux administrateurs.

Rédigé par Telegram Bot App team · Dernière mise à jour : June 2026

Articles associés

Bloquer les bots porno Telegram : guide du filtre de contenu NSFW

Stoppez les bots porno et les contenus adultes dans votre groupe Telegram. Guide complet du filtrage NSFW, de la détection de contenu adulte et de la protection de votre communauté contre les images inappropriées.

Analyse des sentiments et détection de la toxicité

Détection automatique des comportements toxiques, grossièretés, insultes et menaces

AI Spam Intelligence et évaluation du risque utilisateur

Analyse comportementale automatisée et prévention intelligente du spam avec score de risque