Skip to content

Advanced Permissions System Guide

The advanced permissions system allows flexible distribution of responsibilities among moderators: some only issue warnings, others manage reports, and others configure the bot.

When You Need the Advanced System

Use the standard system if:

  • You have a small chat
  • All moderators have equal rights
  • No need to restrict access to features

Use the advanced system if:

  • You have many moderators with different tasks
  • Need to separate access to settings, reports, and punishments
  • Control over who can do what is required

Enabling the Advanced System

  1. Open /settings
  2. Go to the "Permissions" section
  3. Enable "Advanced Administrator System"

✅ Now permission groups and moderator assignments are available!

Creating Permission Groups

Permission groups are sets of permissions you assign to moderators.

Step 1: Create a Group

  1. Go to the "Permission Groups" section
  2. Click "Create Group"
  3. Enter the group name (e.g., "Junior Moderators")

Step 2: Set Priority

Priority is a number for sorting groups in the list. The lower the number, the higher the group in the list.

Example:

  • A group with priority 1 will be above a group with priority 5
  • Use for convenient list organization

Step 3: Select Permissions

Mark the needed permissions for the group:

User Moderation:

  • Manage Restrictions — issuing bans, mutes, warnings
  • Remove Restrictions — revoking punishments
  • Ban — right to ban users
  • Mute — right to mute users
  • Warnings — right to issue warns
  • Delete Messages — right to delete messages

Working with Reports:

  • Reports — access to processing user complaints

Management:

  • Settings — access to bot settings

Step 4: Confirm Creation

Check the selected permissions and click "Create"

Example Groups

Junior Moderators

  • Warnings ✅
  • Delete Messages ✅
  • Everything else ❌

Middle Moderators

  • Manage Restrictions ✅
  • Warnings ✅
  • Mute ✅
  • Delete Messages ✅
  • Reports ✅

Senior Moderators

  • All moderation rights ✅
  • Remove Restrictions ✅
  • Reports ✅
  • Settings ❌ (remains only for administrators)

Settings Administrators

  • Settings ✅
  • Manage Restrictions ✅ (optional)

Assigning Moderators

After creating groups, assign moderators:

  1. Go to the "Chat Moderators" section
  2. Click "Add Administrators"
  3. Select from 1 to 10 users
  4. Choose the group you want to assign to them
  5. Confirm addition

Changing a Moderator's Group

To change a moderator's permissions:

  1. Open "Chat Moderators"
  2. Find the needed moderator in the list
  3. Click on their card
  4. Select a new group or remove from the list

Configuring Permissions for Anonymous Administrators

If administrators in your chat post on behalf of the chat, configure separate permissions:

  1. Open "Permissions for Anonymous Administrators"
  2. Enable or disable needed permissions
  3. Save changes

Important: These permissions apply only to anonymous administrators and don't depend on permission groups

How the System Works

With the standard system:

  • All added moderators can use moderation commands
  • Only the chat owner and administrators with "Manage Chat" permission can change settings

With the advanced system:

  • A moderator can only do what their group allows
  • The chat owner retains full access to everything
  • A moderator without a group will have no access to bot commands

Configuration Tips

  1. Start simple — create 2-3 basic groups
  2. Grant minimal permissions — you can always add permissions later
  3. Test — check the system's operation with a test moderator
  4. Document — write down which group is for what
  5. Review regularly — remove inactive moderators