> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.petto.sbs/llms.txt
> Use this file to discover all available pages before exploring further.

# Permissões e hierarquia de cargos

> Por que às vezes o Petto não consegue agir: a hierarquia de cargos, as permissões do servidor e do canal, a permissão do próprio membro e os níveis de comandos opcionais.

## A regra que explica a maioria dos problemas de permissão

O Discord impõe uma regra rígida para todo bot, incluindo o Petto: **um bot nunca consegue agir sobre um membro cujo cargo mais alto está acima do cargo do próprio bot** na lista de cargos do servidor, e nenhuma permissão ou configuração de administrador passa por cima disso. Isso vale para `!ban`, `!kick`, `!mute`, `!role` e qualquer outra coisa que mexa diretamente com um membro. O Petto usa o prefixo do servidor; `!` é só o padrão.

> [!WARNING]
>
> Isso significa que o Petto também não consegue moderar membros com um cargo posicionado acima do dele, mesmo que esse membro não tenha nenhuma permissão especial: a hierarquia é só sobre a **posição** do cargo, não sobre o que o cargo concede.

![kira tenta banir PartnerBot e o Petto diz que não pode banir esse membro porque o cargo mais alto dele está acima ou no mesmo nível do seu](https://mintcdn.com/wikipetto/LoL7QuPJ71yd9F_N/images/discord/concepts/pt-br/hierarchy.webp?fit=max\&auto=format\&n=LoL7QuPJ71yd9F_N\&q=85\&s=76a647810e9388075547a16e58a960c3)

No Discord: um banimento recusado porque o cargo mais alto do membro está acima do cargo do Petto.

O Petto confere o seu lugar também: você não pode usar uma sanção em alguém cujo cargo mais alto esteja na sua altura ou acima do seu, a não ser que você seja o dono do servidor.

![kira tenta advertir chu, que tem o mesmo cargo de moderação, e o Petto diz que não dá para usar isso em alguém com cargo igual ou mais alto](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/concepts/pt-br/permissions-moderator-hierarchy.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=28ffae10eb04d8750b59410c505fc437)

No Discord: o seu próprio cargo também precisa estar acima do membro.

## Como resolver

Configurações do servidor → Cargos, arraste o cargo do Petto para cima até ele ficar acima de todos os cargos sobre os quais você quer que ele consiga agir. Ele não precisa estar no topo, só acima dos alvos.

## Permissões do bot vs. permissões de canal

Duas coisas separadas precisam ser verdadeiras ao mesmo tempo:

1. **Permissões do servidor todo**: o que o cargo do Petto recebe em geral (Gerenciar cargos, Banir membros, Gerenciar canais etc.), definido uma vez em Configurações do servidor → Cargos.
2. **Substituições específicas de canal**: um canal pode negar ao Petto algo que ele tem no servidor todo; as permissões sobrescritas de um canal específico sempre vencem a concessão do cargo.

![kira tenta banir drama\_llama e o Petto diz que precisa da permissão Banir membros para isso](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/concepts/pt-br/permissions-bot-permission.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=226df5941b38b7078eb655e4e7dad914)

No Discord: o cargo do Petto não tem Banir membros.

Um comando que falha em exatamente um canal, mas funciona em todos os outros, quase sempre é o nº 2, não o nº 1.

![kira usa lock no anuncios e o Petto diz que precisa da permissão Gerenciar canais naquele canal](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/concepts/pt-br/permissions-channel-override.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=c246cb35a431b6fa939f39b9840e40cc)

No Discord: o Petto tem Gerenciar canais no servidor, mas uma permissão do canal tira isso lá.

## Permissões exigidas por comando

Além do que o próprio Petto precisa, a maioria dos comandos de configuração também exige que o **membro que os usa** tenha **Gerenciar servidor** (ou uma permissão mais específica, como Banir membros para `!ban`). Esse é o sistema de permissões do próprio Discord, verificado pelo Petto nos comandos com prefixo.

![Chillet, do cargo Ajudantes, tenta banir drama\_llama e o Petto diz que falta a permissão ban\_members](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/concepts/pt-br/permissions-member-permission.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=ea48a0efdbdcbcc766a6222e022a7363)

No Discord: um Ajudante sem Banir membros tenta !ban.

## Níveis de comando do Petto

A página **Permissões** do dashboard e o `!permission` oferecem uma camada extra opcional. Crie grupos do nível 0 ao 100, atribua usuários ou cargos e depois defina um nível exigido em um comando. O nível do grupo mais alto que corresponder vence. Essa camada nunca substitui as permissões nem a hierarquia do Discord; ela só adiciona uma barreira configurável para a equipe.

O dono do servidor e os membros com **Administrador** nunca são barrados por um nível.

![kira usa nuke e o Petto diz que falta o nível de permissão necessário para nuke](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/concepts/pt-br/permissions-command-level.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=5ed0cc26982d10d3499bf51bb87c314e)

No Discord: nuke precisa de nível 80 e o grupo Moderadores é nível 50.

Veja [Permissões de comandos](https://wiki.petto.sbs/pt-br/setup/permissions.md) para a referência completa dos comandos, que só funcionam com prefixo.

## Onde isso aparece

> [card] [Moderação](https://wiki.petto.sbs/pt-br/moderation/moderation.md)
>
> Todo comando de sanção está sujeito à hierarquia.

> [card] [Problemas de permissão](https://wiki.petto.sbs/pt-br/common-issues/permissions.md)
>
> Solução de problemas passo a passo quando algo não está funcionando.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.