Hierarquia de Cargos do Discord Impede Moderação do Bot: Como Corrigir

Seu bot de moderação do Discord parou de expulsar, banir ou mutar certos membros. Você verifica as permissões do bot e elas parecem corretas. O problema não são as permissões em si, mas o sistema de hierarquia de cargos do Discord. Este artigo explica por que a hierarquia de cargos bloqueia ações de moderação do bot e como corrigir ajustando as posições dos cargos.

Por que a Hierarquia de Cargos do Discord Bloqueia a Moderação do Bot

O Discord usa uma hierarquia de cargos rigorosa para controlar quem pode moderar quem. Cada cargo em um servidor é posicionado em uma lista vertical. Um cargo que aparece mais acima na lista pode gerenciar cargos e membros que estão abaixo dele. Essa regra se aplica a bots exatamente como se aplica a usuários humanos.

Quando um bot de moderação tenta expulsar um membro, o Discord verifica duas coisas. Primeiro, verifica se o bot tem a permissão necessária, como Expulsar Membros. Segundo, verifica se o cargo mais alto do bot está posicionado acima do cargo mais alto do membro alvo. Se o cargo do bot estiver abaixo ou igual na lista, a ação falha silenciosamente ou retorna um erro.

A causa raiz técnica é que o Discord aplica a hierarquia de cargos no nível da API. O bot recebe uma resposta HTTP 403 Proibido quando tenta uma ação contra um membro com cargo superior ou igual. A maioria dos bots registra esse erro como permissão ausente, mesmo quando a permissão está atribuída corretamente.

Como a Posição do Cargo é Determinada

A posição do cargo é a ordem numérica de um cargo na lista de cargos do servidor. O cargo mais alto tem posição 1, o próximo tem posição 2 e assim por diante. O Discord exibe os cargos do mais alto para o mais baixo em Configurações do Servidor > Cargos. Você pode arrastar os cargos para cima ou para baixo para alterar sua posição.

A Armadilha do Cargo @everyone

O cargo @everyone está sempre na parte inferior da hierarquia. Você não pode movê-lo para cima. Se o cargo de um bot estiver abaixo de @everyone, ele não pode moderar ninguém. Sempre garanta que o cargo do bot esteja acima de @everyone na lista.

Passos para Corrigir a Moderação do Bot Bloqueada pela Hierarquia de Cargos

1. Abra as Configurações do Servidor
   Clique com o botão direito no ícone do seu servidor na lista de canais e selecione Configurações do Servidor. Se você não vir esta opção, não tem a permissão Gerenciar Servidor.
2. Vá para a aba Cargos
   Na barra lateral esquerda, clique em Cargos. Você verá uma lista de todos os cargos do seu servidor, ordenados do mais alto para o mais baixo.
3. Identifique o cargo do bot
   Encontre o cargo atribuído ao seu bot de moderação. Se o bot tiver vários cargos, anote o mais alto na lista. A hierarquia efetiva do bot é determinada pelo seu cargo de posição mais alta.
4. Identifique o cargo mais alto do membro alvo
   Clique em um membro que o bot não consegue moderar. No pop-up do membro, veja os cargos listados abaixo do nome. O cargo que aparece primeiro é o mais alto.
5. Arraste o cargo do bot para cima do cargo do alvo
   Volte para a aba Cargos. Clique e segure o ícone de seis pontos à esquerda do nome do cargo do bot. Arraste-o para cima até que apareça acima do cargo mais alto do membro alvo. Solte o mouse para salvar a nova posição.
6. Teste a ação de moderação do bot
   Peça ao bot para expulsar ou mutar o membro alvo em um canal de teste. Se a ação for bem-sucedida, a correção da hierarquia está completa. Se ainda falhar, repita a verificação para outros cargos que o bot ou o membro alvo possam ter.

Alternativa: Crie um Cargo Dedicado para o Bot

Alguns administradores de servidor criam um novo cargo chamado Moderação do Bot e o posicionam logo abaixo do cargo de administrador. Eles atribuem esse cargo ao bot e removem todos os outros cargos do bot. Essa abordagem simplifica o gerenciamento da hierarquia, pois você só precisa acompanhar um cargo por bot.

Alternativa: Conceda a Permissão de Administrador

A permissão de Administrador ignora completamente a hierarquia de cargos. Um bot com Administrador pode moderar qualquer membro, independentemente da posição do cargo. Não use esta opção a menos que confie totalmente no bot. Um bot comprometido com Administrador pode destruir seu servidor.

Se o Bot Ainda Não Consegue Moderar Após Reordenar os Cargos

Bot Tem Vários Cargos e Um Ainda Está Muito Baixo

O Discord usa o cargo mais alto do bot para verificações de hierarquia. Se o bot tiver vários cargos, verifique aquele que aparece mais alto na lista. Mova esse cargo para cima do cargo mais alto do membro alvo. Os outros cargos do bot não importam para fins de hierarquia.

Membro Alvo Tem um Cargo que Não Pode Ser Movido

Alguns cargos, como o cargo do proprietário do servidor, são fixos no topo. O proprietário do servidor está sempre acima de todos os cargos. Nenhum bot pode moderar o proprietário do servidor. Se você precisar moderar um administrador, peça ao proprietário do servidor para rebaixar esse administrador temporariamente.

A Permissão do Bot Foi Removida Durante o Reordenamento

Ao arrastar um cargo, o Discord não altera suas permissões. No entanto, se você editou acidentalmente o cargo durante o reordenamento, o bot pode ter perdido uma permissão necessária. Vá até o cargo do bot e verifique se Expulsar Membros, Banir Membros ou Mutar Membros está ativado.

Item	Correção da Hierarquia de Cargos	Permissão de Administrador
Risco de segurança	Baixo — afeta apenas o escopo da moderação	Alto — dá controle total do servidor ao bot
Complexidade de configuração	Moderada — requer arrastar cargos	Baixa — uma caixa de seleção nas configurações do cargo
Escopo da moderação	Pode moderar membros abaixo do cargo do bot	Pode moderar todos os membros, incluindo o proprietário
Melhor para	Servidores com hierarquia de cargos clara	Apenas bots auto-hospedados confiáveis

Agora você entende como a hierarquia de cargos do Discord afeta a moderação do bot. Comece movendo o cargo do bot acima dos cargos dos membros que ele precisa moderar. Evite conceder Administrador a menos que seja absolutamente necessário. Para manutenção contínua, revise sua lista de cargos sempre que adicionar novos cargos ao servidor.