Contextual complaints

This module provides a full-featured system for submitting and reviewing complaints about users and messages.

For users

How to file a complaint?

You can report a violation in three convenient ways:

1. Via the command /report user:

   • Start typing the command /report user in any text channel.

   • A modal window will appear where you can select a user from the list and describe the situation.

2. Via the user menu (right click):

   • Right-click on the user's nickname.

   • In the menu that appears, select Applications -> Report the user.

3. Via the message menu:

   • Click the three dots (...) to the right of the message that violates the rules.

   • In the menu choose Applications -> Report message.

Filling out the complaint form

After choosing one of the methods, a modal window will appear where you need to specify:

• Reason: Briefly describe the essence of the violation (for example, "Insult", "Spam").

• Detailed description: Describe the situation in detail. The more details, the faster moderators can make a decision.

• Attachments (optional): You can attach up to 5 images (screenshots) as evidence.

What happens after submission?

Your complaint will be confidentially sent to a private channel for moderators. After a moderator reviews your complaint and issues a verdict, you will receive a direct message (DM) from the bot with the results of the review and the moderator's comment.

---

For administrators

⚙️ Initial setup

For the system to work, you need to specify where to send complaints.

1. Use the command /settings reports. You must have administrator rights or access level 5.

2. A control panel will open. Click the dropdown menu and select "Reports channel".

3. In the menu that appears, choose a text channel that will be accessible only to moderators.

Additional settings:

• Role for notifications: You can specify a role that the bot will mention (ping) when a new complaint arrives.

• Moderator roles: If you do not use the access levels system, you can specify roles here that will be able to review complaints.

Complaint review process

1. New complaint: When a new complaint arrives, a message in a modern format with full information is posted to the configured channel:

   • Unique ID of the complaint.

   • Who filed the complaint and against whom.

   • Reason and detailed description.

   • Gallery of attached images.

   • Button "Review".

2. Review:

   • The moderator clicks the button "Review".

   • A modal window opens where you need to:

     • Issue a verdict: Choose one of the options (✅ Confirmed, ❌ Not found, 🗑️ Spam).

     • Write a reply: Leave a comment that will be sent to the user who filed the complaint.

3. Completion:

   • After submitting the form the original complaint message in the moderators' channel is updated: it shows the issued verdict, the moderator's name and their response. The "Review" button disappears.

   • The user who filed the complaint receives a DM with the results.

Command to change the verdict

Sometimes it is necessary to review an already closed complaint. There is a special command for this.

• Command: /report change

• Parameter: complaint-id (the unique ID of the complaint shown in the header).

• Access: Moderators with access level 3 and above.

This command will reopen the modal window for issuing a verdict, allowing you to change the decision and update the complaint information.

Reset settings

In the panel /settings reports there is a trash button that allows you to completely reset all module settings for your server (channel, roles, etc.). Complaints themselves are not deleted.