Appels de bannissement (Ban Appeals)

Le module Appels de bannissement permet aux utilisateurs bannis de votre serveur Discord de postuler à une demande de réintégration en ligne. Ce système gère l’authentification Discord OAuth2, la vérification des bannissements en temps réel et la prise de décision automatisée par votre staff.

Les quatre onglets de la page

File d’attente : les demandes en cours de traitement, avec leur nombre entre parenthèses.
Historique : les dossiers déjà tranchés.
Blacklist : les comptes privés d’accès au formulaire, avec leur nombre entre parenthèses.
Configuration : les réglages décrits ci-dessous.

Chaque demande porte un statut : En attente, Accepté, Refusé, Refus définitif ou Attente d’infos.

Comment ça fonctionne ?

Un membre sanctionné se rend sur votre URL publique d’appel (ex: https://appeals.kotbo.fr/votre-serveur).
Il se connecte via Discord. Kotbo lit ses sanctions réellement contestables et récupère leur motif d’origine.
Il coche les sanctions qu’il conteste et rédige sa déclaration pour chacune, dans la limite du nombre de sanctions par demande.
Il remplit le formulaire de questions - celui du premier type coché s’il en a un, sinon le formulaire du module.
Une notification interactive (Embed) est envoyée dans le salon Discord de votre staff.
Les modérateurs tranchent sanction par sanction, depuis le dashboard ou les boutons Discord.

Configuration du module

Dans l’onglet de configuration du dashboard, paramétrez les éléments suivants :

1. Paramètres de formulaire

Activer le module : Active ou désactive le portail public.
Formulaire d’appel : Sélectionnez le formulaire de questions. Les questions et le thème visuel se modifient dans Formulaires → Builder. Vous devez donc créer ce formulaire au préalable (cela vous permet de définir vos propres questions, d’ajouter votre logo/bannière et d’y appliquer vos styles CSS personnalisés).

2. Intégration Discord

Salon Staff (Réception) : Le salon Discord privé de votre équipe dans lequel Kotbo enverra la fiche de demande d’appel avec les boutons d’action.
Salon d’invitation : Le salon qui servira de point de chute pour générer un lien d’invitation à usage unique lors de l’acceptation d’un appel.

3. Sanctions contestables

Le bloc Sanctions contestables active un par un les types que les membres peuvent contester : Avertissement, Exclusion temporaire, Expulsion, Softban, Bannissement temporaire et Bannissement.

Chaque type porte ses propres réglages :

Délai avant nouvelle demande (jours).
Formulaire dédié : contester un avertissement ne soulève pas les mêmes questions que contester un bannissement. Sans formulaire propre au type, la page publique retombe sur le formulaire du module.

4. Règles et Cooldown

Délai avant ré-appel (en jours) : Le nombre de jours qu’un utilisateur doit attendre après un refus avant de pouvoir soumettre un nouvel appel (par défaut : 30 jours).
Sanctions par demande (max) : le nombre de sanctions qu’un membre peut contester en une fois.
Contestable pendant (jours) : au-delà, une sanction n’est plus contestable. Sans limite laisse la contestation ouverte indéfiniment.
Prévenir le membre en message privé : à chaque sanction contestable, le membre reçoit le lien vers la page d’appel, déjà pointé sur la bonne sanction.
Interdire au modérateur de juger sa propre sanction : celui qui a prononcé la sanction ne peut pas trancher l’appel qui la vise.
Prévenir le modérateur émetteur : il reçoit un message privé quand une de ses sanctions est contestée, et peut apporter son contexte avant le verdict.
Sauvegarder l’empreinte de l’appareil : enregistre les détails du navigateur et du système pour détecter les doubles comptes.

5. Textes personnalisés

Adaptez la communication avec les utilisateurs :

Texte d’accueil : Le texte d’explication ou règlement affiché en haut de la page publique de connexion.
Message d’acceptation (DM) : Le message privé que Kotbo enverra automatiquement à l’utilisateur lors de sa réintégration. Astuce : utilisez la variable {invite} pour y inclure automatiquement l’invitation à usage unique générée.
Message de refus (DM) : Le message privé envoyé à l’utilisateur en cas de rejet de sa demande.

Traitement des demandes (Côté Staff sur Discord)

Lorsqu’une demande d’appel est soumise, Kotbo publie une fiche complète dans votre Salon Staff :

Nouvel Appel de Bannissement - @Pseudo (ID: 123456)
-----------------------------------------------------------
Raison du ban (Discord) : "Utilisation de cheats"

[Questions & Réponses du formulaire]
Q: Pourquoi devrions-nous vous débannir ?
R: J'ai compris mes erreurs et j'ai supprimé mes logiciels tiers...

-----------------------------------------------------------
[ Accepter ]  [ Refuser ]  [ Refuser Définitivement ]  [ Demander Infos ]

Votre équipe dispose de quatre actions rapides sous forme de boutons interactifs :

1. Accepter (Accept)

Retire automatiquement le bannissement du joueur sur votre serveur Discord.
Génère un lien d’invitation Discord unique et temporaire (1 utilisation, expire sous 24h).
Envoie un DM à l’utilisateur contenant votre message d’acceptation personnalisé et le lien d’invitation.
Marque la demande comme Accepté.

2. Refuser (Deny)

Envoie un DM à l’utilisateur l’informant du refus de sa demande.
Bloque la possibilité pour l’utilisateur de soumettre un nouvel appel pendant le nombre de jours défini dans votre configuration de cooldown (ex: 30 jours).
Marque la demande comme Refusé.

3. Refuser Définitivement (Permanently Deny)

Envoie un DM à l’utilisateur l’informant du refus.
Bloque à vie l’accès au portail d’appel pour ce compte Discord. L’utilisateur ne pourra plus jamais soumettre de demande de recours pour ce serveur.
Marque la demande comme Refus définitif.

4. Demander plus d’infos (Needs Info)

Si les motivations du joueur sont floues, vous pouvez lui demander des éclaircissements :

Cliquez sur Demander Infos.
Une boîte de dialogue (Modal) s’ouvre sur Discord pour vous permettre de saisir votre question (ex: « Pouvez-vous fournir des preuves ou le pseudonyme de votre complice ? »).
L’utilisateur reçoit une notification et sa page d’appel publique affiche votre question avec un champ de réponse.
Dès qu’il répond en ligne, Kotbo met à jour le message staff Discord pour vous notifier et afficher ses explications complémentaires.
Marque temporairement la demande comme Attente d’infos.

Gestion et Liste noire (Blacklist)

Depuis le dashboard de Kotbo, vous avez accès à l’historique complet des dossiers d’appels :

Filtrer et Rechercher : Visualisez les demandes en attente, acceptées, refusées ou nécessitant des informations.
Consulter les motifs : Lisez les logs de décision avec le nom du modérateur ayant statué et la raison associée.
Blacklist des Appels : Permet d’inscrire manuellement des identifiants Discord d’utilisateurs afin de leur interdire immédiatement l’accès au formulaire d’appel de ban, sans qu’ils aient besoin d’en soumettre un. C’est idéal pour exclure à l’avance les fauteurs de troubles majeurs du processus de réintégration.