# Appeal system

## Overview

With an interactive appeal system you can easily create the possibility for your users to appeal a moderation action. It is currently possible to create an appeal for:

* Bans
* Timeouts
* Warns

## Configuration

You can configure the appeal system with the `/appeal-config` command. Then an interactive settings menu opens where you can fine tune the appeal config.

<figure><img src="https://2698551802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fygxz5wK8GMHeFZaC065x%2Fuploads%2FfLrIQJroVGrlvOu5LFwo%2FScreenshot%202024-10-01%20154812.png?alt=media&#x26;token=739791f5-716e-4a6a-92fc-19e79063cc1e" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
You must configure the main server at first. Without it users can't create an appeal!
{% endhint %}

{% hint style="warning" %}
We strongly recommend to NOT configure the main server as an appeal server because then banned and timeouted users won't be able to create an appeal
{% endhint %}

After it you can send a panel with a button where users can create an appeal in a channel of your choice

<figure><img src="https://2698551802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fygxz5wK8GMHeFZaC065x%2Fuploads%2FUxOerZ2okiJaZIr7qWZw%2FScreenshot%202024-10-01%20154823.png?alt=media&#x26;token=28e3fda1-57bd-4d22-acb4-053e15dd04e2" alt=""><figcaption></figcaption></figure>

## Submitting an appeal

To submit an appeal you need to click on the `Create appeal` button and enter the report ID of your report. You get a DM from the bot after you get moderated with an invite link for the appeal server and the corresponding report ID.

<figure><img src="https://2698551802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fygxz5wK8GMHeFZaC065x%2Fuploads%2FbZngaRcP1nrqgyDPva5p%2FScreenshot%202024-10-01%20155156.png?alt=media&#x26;token=77818402-b783-420b-9f51-65ccc1d9e4c2" alt=""><figcaption></figcaption></figure>

## Approving/Denying appeals

After the appeal is created, a channel with the user is created. In this appeal channel the bot also creates a private thread for the staff (if a staff role is configured) so the staff can privately discuss the appeal.

{% hint style="warning" %}
If you mention the user who created the appeal in the private staff thread the user is automatically added to the thread and can read all messages!
{% endhint %}

Once the staff has decided if the appeal should be approved/denied they can easily use the `Approve appeal` or `Deny appeal` button. To get further information the staff can view the report details and old denied appeals of the user.

<figure><img src="https://2698551802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fygxz5wK8GMHeFZaC065x%2Fuploads%2Fhazj4C5QSTuNruamPBS6%2FScreenshot%202024-10-01%20155259.png?alt=media&#x26;token=897d5060-2228-4f27-aeb8-fe1c3497be4d" alt=""><figcaption></figcaption></figure>

After the staff decided of the appeal the channel can be deleted. A transcript will be sent to the user who created the appeal and in the transcript channel if configured.

<figure><img src="https://2698551802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fygxz5wK8GMHeFZaC065x%2Fuploads%2FJcTqWdZQkVeJGnKDv8CC%2FScreenshot%202024-10-01%20155358.png?alt=media&#x26;token=b1c38179-2753-436d-a2c9-f132e49dc56e" alt=""><figcaption></figcaption></figure>
