# Moderation

## Automatic Moderation Settings

### General

{% hint style="info" %}
Each filter has its own settings.
{% endhint %}

### Punishments for Violations

You have three types of punishments to choose from: **Timeout**, **Kick**, **Ban**.

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FydH4hilDZaTjbEtZMh3u%2Fopera_cEOjeR4wFd.gif?alt=media&#x26;token=1029d151-a98a-47f8-b874-cdbea7fde78d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can only set a duration for the "Timeout" type of punishment.
{% endhint %}

{% hint style="warning" %}
Time Format: \
d - days \
h - hours \
m - minutes \
s - seconds

Example: 21d15h9m20s \
The punishment will be applied for 21 days, 15 hours, 9 minutes, 20 seconds.
{% endhint %}

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FHq0LoYOl0TaTZexA3sIU%2Fopera_RIxoc8pPAo.gif?alt=media&#x26;token=1717d351-5cea-40df-adbe-7cabd08788ae" alt=""><figcaption></figcaption></figure>

#### Result:

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FDSfwRGuUvo4SzaeBfC8d%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5_2023-11-12_111354530.png?alt=media&#x26;token=bf517d89-15ab-44d5-a6d8-836aab95902a" alt=""><figcaption></figcaption></figure>

### Ignoring Channels

Imagine you have a dedicated text channel for sending links, and you don't want to apply any sanctions to users in that channel.

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2Fmy24XxHltmarGj6lbudH%2Fopera_FPSOdGGTJN.gif?alt=media&#x26;token=44b75b17-bfcb-4f8f-80af-62e2febf1b20" alt=""><figcaption></figcaption></figure>

### Ignoring Roles

Imagine you have members with certain roles who should be allowed to send links, and you don't want to apply any sanctions to them.

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2Fcsy84Wd2ya8yMx6glKeJ%2Fopera_wSMFcu5sFf.gif?alt=media&#x26;token=2b6829a1-8cde-4dd3-b16c-78dd9127d46f" alt=""><figcaption></figcaption></figure>

### Notify Member about Violation

Members may not understand what happened, so we recommend notifying them about violations they may not be aware of.

{% hint style="info" %}
There are two notification options:&#x20;

* The channel where the violation occurred.
* Direct messages.
  {% endhint %}

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FpoedkF3qaquHeGQZUrkK%2Fopera_WNWnhsMV0P.png?alt=media&#x26;token=cee9fea8-70ea-44c0-9ae1-38ca8c6f69ed" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
There is no default violation message, so you need to specify the text yourself.&#x20;

Both plain text and [JSON ](https://docs.asagi.xyz/guides/json-builder-in-the-asagi-bot)code are supported.&#x20;

[Variables](https://docs.asagi.xyz/other/message-templates/variables) are also available.
{% endhint %}

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2F5R7Oh0ldTn8kNb8eL9vC%2Fopera_uDwNWTaEMl.gif?alt=media&#x26;token=bb778e60-a2e2-4181-9d2a-ecfac3a67247" alt=""><figcaption></figcaption></figure>

## Automatic Moderation Filters

### Links

The default penalty type is "<mark style="color:yellow;">Timeout</mark>" for <mark style="color:yellow;">15 minutes</mark> when any link is found.

#### How does it work?

This filter reacts to messages containing any links.

You can configure: message deletion, punishment type, notifying the member, ignoring channels, and ignoring roles.

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2F6KMSELwsAocqlNNdazUu%2Fopera_oKG3Bn0UKu.gif?alt=media&#x26;token=55ee7815-66ae-4fe4-a755-9b08171b25c4" alt=""><figcaption></figcaption></figure>

#### How do I enable this filter?

To enable this filter, type the command <mark style="color:blue;">`/settings`</mark> and choose *Moderation*.&#x20;

In the dropdown menu, select "<mark style="color:yellow;">Links</mark>".

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FYdUY8UdohVOIbMWKBV8N%2Fopera_bPw6vBa6LD.gif?alt=media&#x26;token=80943d48-9645-4fca-94f3-bf946a5f06b1" alt=""><figcaption></figcaption></figure>

### Invitations

The default penalty type is "<mark style="color:yellow;">Timeout</mark>" for <mark style="color:yellow;">15 minutes</mark> when any Discord invitation found.

#### How does it work?

This filter reacts to messages containing any Discord invitation.

You can configure: message deletion, punishment type, notifying the member, ignoring channels, and ignoring roles.

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FDPOtmUaEeFcjmqMzLVwS%2FXrHjhQHtIu.gif?alt=media&#x26;token=eb2e8e4c-6469-4b7a-90f0-7ccf383cb61a" alt=""><figcaption></figcaption></figure>

#### How do I enable this filter?

To enable this filter, type the command <mark style="color:blue;">`/settings`</mark> and choose *Moderation*.&#x20;

In the dropdown menu, select "<mark style="color:yellow;">Invitations</mark>".

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FWpR0PlfFexjJatrHmZ7c%2Fopera_pCoZAlApNV.gif?alt=media&#x26;token=17805453-18d9-43c3-af50-329c1be564fa" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.asagi.xyz/guides/configuring-bot-features/moderation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.