The permissions given to members is an important part in the configuration of a server. The same is also true for bots. This page is intended to show you each of the permissions necessary for the bot, as well as explain why they are necessary. All this in order to avoid putting unnecessary permissions on the bot, which it turn will keep your server clean and safe.
Never never never NEVER never (yes, 5 times never) put a bot with administration permissions. It has already happened once that the bot’s security key is stolen, which allows the thief to take full control of the bot, such as deleting your channels or banning your members. Even though safety has been completely redesigned since this incident, zero risk is not possible. See this official note from Discord for more information.
Grant every possible permission in the server. Someone with this permission will not have any restriction, except deleting the server and editing the roles above them. Not recommended to anyone, even a bot.
View Audit Log¶
Allows the bot to read server logs (adding roles, changing names, editing channels…). Not necessary for the moment
Allows the bot to change the name, image and region of the server, or get the list of all invites. Used for: invite
Allows the bot to create invitations to any visible room, without being able to modify or delete them. Not used.
Allows the bot to change your own nickname. Not used at this moment.
Allows the bot to change the nickname of any member hierarchically equal or inferior to you. Example of use: unhoist command
Allows the bot to add, rename or delete emojis from the server. Example of use: emoji
Read Text Channels & See Voice Channels¶
Allows the bot to see chats and voice channels. This permission does not allow you to write in these chats or connect to the voice channels. Required for the bot.
Read Messages/See channel¶
Allows the bot to read messages from a chat, but not the history. In other words, the bot will react to your messages but will not be able to read them again. Remove this permission in a channel to prevent the bot from being there.
Allows the bot you to write messages in text channels. Required for almost all functionalities, but not necessarily for all channels.
Send TTS Messages¶
Allows the bot to send a TTS message, i.e. a message that will be read aloud by your application. No need for the bot.
Read Message History¶
Mention @veryone, @here and @All Roles¶
Allows the bot to mention any role including @everyone (which results in sending a notification to all members with access to the channel) and @here (sends a notification to all online members with access to the channel). Zbot uses a great Discord protection to avoid unwanted mentions, so you should be safe granting it. Example of use: rss follows with mentions
Use External Emojis¶
Allows the bot to use emojis from any other server. The bot uses them in many situations to diversify emotions, so it is strongly recommended to keep it activated.
Use Slash Commands¶
Allows the user to use bots slash commands. Obviously has no effect on bots.
Allows the bot to speak in a voice chat room. No use for the moment.
Allows users to share their screen or their camera. Bots cannot use that for now.
Allows users to mute other users in voice channels. Not used.
Allows users to deafen other users in voice channels. Not used.
Allows the bot to move members from a voice channel to another. The bot needs to have access to that other channel, but not necessarily the affected member. Example of use: voice channels automation
Use Voice Activity¶
Allows users to use voice detection instead of push-to-talk. Makes no sense for bots.
Allows users to have their volume higher than the other members in a voice channel. Bots cannot use that for now.
Request To Speak¶
Allows users to raise their hands in stage channels. Not used by Zbot.