Ban appeals

The Ban appeals module lets users banned from your Discord server apply online to be let back in. The system handles Discord OAuth2 authentication, real-time ban verification and automated decision-making by your staff.

The four tabs on the page

Queue: the requests still being handled, with their count in brackets.
History: the files already decided.
Blacklist: the accounts barred from the form, with their count in brackets.
Configuration: the settings described below.

Every request carries a status: Pending, Accepted, Denied, Permanently denied or Awaiting info.

How does it work?

A banned user visits your public ban appeal URL (for example https://appeals.kotbo.fr/your-server).
They sign in with Discord. Kotbo automatically checks that they really are on your Discord server’s ban list and retrieves the original ban reason.
The user fills in your custom question form.
An interactive notification (embed) is sent to your staff’s Discord channel.
Moderators click the Discord buttons to accept, deny or ask for more details.

Configuring the module

In the dashboard’s configuration tab, set up the following:

1. Form settings

Enable the module: turns the public portal on or off.
Appeal form: pick the question form. The questions and the visual theme are edited in Forms → Builder, so you must create that form beforehand (which is where you define your own questions, add your logo or banner and apply your custom CSS).

2. Discord integration

Staff channel (inbox): your team’s private Discord channel, where Kotbo posts the appeal request card with its action buttons.
Invite channel: the channel used as the anchor for generating a single-use invite link when an appeal is accepted.

3. Rules and cooldown

Delay before re-appealing (in days): how many days a user must wait after a denial before submitting a new appeal (default: 30 days).

4. Custom text

Adapt how you communicate with users:

Welcome text: the explanation or rules shown at the top of the public sign-in page.
Acceptance message (DM): the private message Kotbo sends automatically when the user is let back in. Tip: use the {invite} variable to include the generated single-use invite automatically.
Denial message (DM): the private message sent to the user when their request is rejected.

Handling requests (staff side, on Discord)

When an appeal is submitted, Kotbo posts a full card in your staff channel:

New Ban Appeal - @Username (ID: 123456)
-----------------------------------------------------------
Ban reason (Discord): "Using cheats"

[Form questions & answers]
Q: Why should we unban you?
A: I understand what I did wrong and I removed my third-party software...

-----------------------------------------------------------
[ Accept ]  [ Deny ]  [ Deny Permanently ]  [ Request Info ]

Your team has four quick actions available as interactive buttons:

1. Accept

Automatically lifts the player’s ban on your Discord server.
Generates a unique, temporary Discord invite link (one use, expires within 24 hours).
Sends the user a DM containing your custom acceptance message and the invite link.
Marks the request as Accepted.

2. Deny

Sends the user a DM telling them their request was denied.
Blocks the user from submitting a new appeal for the number of days set in your cooldown configuration (for example 30 days).
Marks the request as Denied.

3. Deny permanently

Sends the user a DM telling them their request was denied.
Blocks that Discord account for life from the appeal portal. The user will never be able to submit another appeal for this server.
Marks the request as Permanently denied.

4. Request more info

If the player’s reasoning is unclear, you can ask them to elaborate:

Click Request Info.
A dialog (modal) opens on Discord so you can type your question (for example “Can you provide evidence, or the username of the person involved?”).
The user receives a notification and their public appeal page shows your question with an answer field.
As soon as they answer online, Kotbo updates the Discord staff message to notify you and display their extra explanation.
Temporarily marks the request as Awaiting info.

Management and blacklist

From the Kotbo dashboard you have access to the full history of appeal files:

Filter and search: review requests that are pending, accepted, denied or awaiting information.
Check the reasoning: read the decision logs with the name of the moderator who ruled and the reason given.
Appeal blacklist: lets you manually add Discord user IDs to immediately bar them from the ban appeal form, without them having to submit one first. This is ideal for excluding serious troublemakers from the reinstatement process ahead of time.