Permissões
Nomes de permissões aceitos nos links de convite e nas rotas da API, com o rótulo exibido no app.
Os nomes abaixo valem no parâmetro permissions do link de convite e nos campos de permissões de cargos e canais. Para entender como as permissões do bot são limitadas às de quem o adiciona, veja OAuth2 e permissões.
| Nome na API | Rótulo no app |
|---|---|
VIEW_CHANNEL | Ver canais (implícito; aceito e ignorado, o bot vê os canais conforme as regras de cada canal) |
ADMINISTRATOR | Administrador |
MANAGE_GUILD | Gerenciar servidor |
MANAGE_ROLES | Gerenciar cargos |
MANAGE_CHANNELS | Gerenciar canais |
CREATE_INVITE | Criar convite |
CHANGE_NICKNAME | Alterar apelido |
MANAGE_NICKNAMES | Gerenciar apelidos |
KICK_MEMBERS | Expulsar membros |
BAN_MEMBERS | Banir membros |
SEND_MESSAGES | Enviar mensagens |
ATTACH_FILES | Anexar imagens (vale para qualquer arquivo; exigida junto de SEND_MESSAGES para o bot enviar anexos) |
ADD_REACTIONS | Adicionar reações |
MANAGE_MESSAGES | Gerenciar mensagens (apagar mensagens de outros, fixar, ignorar o modo lento) |
MENTION_EVERYONE | Mencionar @everyone e @here |
CONNECT | Conectar (voz) |
MUTE_MEMBERS | Silenciar membros |
MOVE_MEMBERS | Desconectar membros |
VIEW_AUDIT_LOG | Ver registro de auditoria |
Um nome desconhecido faz a API recusar o convite com 400 Permissões inválidas.
Permissões de canal e hierarquia#
A hierarquia de cargos não limita as permissões de canal (PUT /guilds/:g/channels/:c/overwrites): o bot só não pode liberar uma permissão que ele mesmo não tem. Já a gestão de cargos e membros respeita a hierarquia. Detalhes em Gerenciamento de servidores e canais.