Home / Getting Started / Permissions

Bot Permissions

Understanding and configuring the correct permissions for GenBot {Engin} is essential for proper functionality.

Important

Only grant the permissions that you need for the features you plan to use. Granting unnecessary permissions can pose security risks.

Permission Overview

Required and recommended permissions for GenBot

Permission Description Required Recommended
Administrator Grants all permissions. Use with caution!
View Channels Allows the bot to see channels
Send Messages Allows the bot to send messages in text channels
Embed Links Allows the bot to send embedded messages
Attach Files Allows the bot to upload files and images
Read Message History Allows the bot to read message history
Manage Messages Allows the bot to delete or pin messages
Kick Members Allows the bot to kick members from the server
Ban Members Allows the bot to ban members from the server
Manage Roles Allows the bot to create and manage roles
Manage Channels Allows the bot to create and manage channels
Manage Webhooks Allows the bot to create and manage webhooks

Permission Categories

Permissions grouped by functionality

General

Basic permissions needed for the bot to function.

Text

Permissions related to text channels and messages.

Moderation

Permissions for moderation features like banning and kicking.

Management

Advanced permissions for server management features.

Feature-Specific Permissions

Permissions needed for specific bot features

Moderation System

Requires: Kick Members, Ban Members, Manage Messages

Welcome System

Requires: Send Messages, Embed Links, Attach Files

Role Management

Requires: Manage Roles

Logging System

Requires: View Channels, Send Messages, Read Message History

Setting Up Permissions

Method 1: During Bot Invitation

When you invite GenBot to your server using the invitation link, you'll be prompted to select the permissions you want to grant. You can select all recommended permissions or customize them based on your needs.

Tip

The invitation link already includes the minimum required permissions. You can modify these as needed.

Method 2: Server Settings

You can modify the bot's permissions after it has been added to your server:

  1. Go to your Server Settings
  2. Select "Roles" from the sidebar
  3. Find the GenBot role
  4. Adjust the permissions as needed
  5. Save your changes

Method 3: Channel-Specific Permissions

You can also set channel-specific permissions for the bot:

  1. Right-click on a channel and select "Edit Channel"
  2. Go to the "Permissions" tab
  3. Find the GenBot role or add it if it's not listed
  4. Adjust the permissions for that specific channel
  5. Save your changes

Note

Channel-specific permissions override server-wide role permissions.

Best Practices

1

Follow the principle of least privilege

Only grant the permissions that are necessary for the features you plan to use.

2

Avoid granting Administrator

The Administrator permission grants all permissions, which is rarely necessary and poses security risks.

3

Use channel-specific permissions

Restrict the bot's access to sensitive channels where its functionality isn't needed.

4

Regularly audit permissions

Periodically review the bot's permissions to ensure they align with your current needs.