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

# Auto-Mod

> Filtragem de mensagens por regras: palavras proibidas, convites, links, caixa alta, spoilers, menções em massa e spam, com punição escalonada.

A Auto-Moderação inspeciona as mensagens conforme são enviadas e age sobre as que quebram uma regra habilitada por você. É gratuita em todo tier.

<Warning>
  **Todas as oito regras vêm desabilitadas.** A Auto-Moderação não faz nada até você ligar as regras que quer.
</Warning>

<Warning>
  **Membros com Administrator nunca são filtrados.** Toda regra é pulada para eles, independentemente da sua configuração. Isso não é mostrado em nenhum lugar da interface.

  Se você está testando regras como administrador, elas parecerão não funcionar. Teste com uma conta comum.
</Warning>

## As oito regras

<AccordionGroup>
  <Accordion title="Bad Words" icon="comment-slash">
    Bloqueia mensagens contendo palavras da sua lista. Cada entrada pode ter até 60 caracteres.
  </Accordion>

  <Accordion title="Repeated Text" icon="repeat">
    Pega caracteres repetidos e uso excessivo de emojis.
  </Accordion>

  <Accordion title="Discord Invites" icon="link-slash">
    Bloqueia links e códigos de convite do Discord.

    <Note>
      Esta regra **não tem tela de configuração**. Está ligada ou desligada — não há como permitir servidores específicos pelo painel.
    </Note>
  </Accordion>

  <Accordion title="External Links" icon="globe">
    Filtra links para sites fora do Discord, com uma lista de domínios permitidos.

    <Warning>
      **Uma lista de domínios permitidos vazia bloqueia todo link externo.** Se você habilitar esta regra sem adicionar domínios, todos os links são filtrados. Adicione seus domínios permitidos primeiro.
    </Warning>
  </Accordion>

  <Accordion title="Excessive Caps" icon="font">
    Dispara em mensagens que são majoritariamente em maiúsculas. Só se aplica a mensagens de pelo menos sete caracteres, e emojis são excluídos do cálculo.
  </Accordion>

  <Accordion title="Excessive Spoilers" icon="eye-slash">
    Limita quantas tags de spoiler uma mensagem pode ter.
  </Accordion>

  <Accordion title="Mass Mentions" icon="at">
    Limita quantos usuários ou cargos uma mensagem pode mencionar.

    <Warning>
      O limite é **inclusivo** — uma mensagem que menciona exatamente o máximo configurado já viola a regra. Ajuste um a mais que o número que você quer permitir.

      `@everyone` e `@here` sempre violam esta regra independentemente do número.
    </Warning>
  </Accordion>

  <Accordion title="Anti-Spam" icon="gauge-high">
    Limita a taxa de mensagens por membro.

    <Warning>
      **O campo "Interval (seconds)" não faz nada.** Ele salva, mas o bot lê um valor armazenado diferente e o intervalo que você definir nunca é aplicado. Só o limite de mensagens tem efeito.
    </Warning>
  </Accordion>
</AccordionGroup>

## Apenas uma regra dispara por mensagem

<Warning>
  As regras são avaliadas em ordem e **a primeira correspondência vence**. Uma mensagem quebrando três regras dispara uma — a primeira da lista.

  Você não verá três ações separadas para uma única mensagem.
</Warning>

## Ações

| Ação               | Efeito                                        |
| ------------------ | --------------------------------------------- |
| **Block Message**  | Deleta a mensagem infratora                   |
| **Send Alert**     | Posta um aviso em um canal escolhido          |
| **Timeout Member** | Aplica timeout ao membro por uma duração fixa |

As durações de timeout são um conjunto fixo: 60 segundos, 5 minutos, 10 minutos, 1 hora, 1 dia ou 1 semana.

<Warning>
  Dois comportamentos silenciosos que vale conhecer:

  * **Send Alert não faz nada em Repeated Text nem Anti-Spam.** O interruptor salva, mas o alerta nunca é postado.
  * **Timeout é suprimido em toda regra no momento em que você tem qualquer Automated Action configurada.** O interruptor fica ligado e a duração preenchida, mas o timeout nunca dispara — as Automated Actions assumem completamente a punição.
</Warning>

Uma regra não age no mesmo membro duas vezes em cerca de um minuto, então uma rajada de mensagens produz uma ação em vez de dez.

## Exclusões

Toda regra tem seu próprio **Disabled Channels** e **Disabled Roles**. Uma regra é totalmente pulada para um membro com um cargo excluído, ou em um canal excluído.

<Tip>
  Exclua seus cargos de moderador das regras de links e convites — do contrário, moderadores postando um link de referência legítimo são filtrados pelas próprias regras do servidor.
</Tip>

## Configurações exclusivas

Separadas das oito regras, elas controlam o que um canal aceita:

| Configuração         | Efeito                                                           |
| -------------------- | ---------------------------------------------------------------- |
| **Only Commands**    | O canal aceita apenas comandos                                   |
| **No Commands**      | O canal rejeita comandos, com uma lista de prefixos configurável |
| **Only Attachments** | O canal aceita apenas mensagens com um anexo                     |

Cada uma tem sua lista **Allowed Roles** para membros que devem ignorá-la. Deixar a lista de prefixos bloqueados vazia bloqueia os padrões comuns `/`, `!`, `#`, `+` e `$`.

## Automated Actions

Punição escalonada com base na contagem de infrações do membro em várias regras, e não em uma só.

Para cada ação você define a punição, a contagem de infrações que a dispara, a janela de tempo em que as infrações são contadas e, opcionalmente, qual regra específica contar.

<Warning>
  **Warn não faz nada.** Selecioná-la registra uma linha no log do bot e não toma ação alguma — nenhum warning é emitido ao membro e nada aparece no histórico de warnings dele.

  Use Timeout ou Mute para uma consequência real.
</Warning>

<Note>
  **Mute é aplicado como um timeout do Discord**, não como cargo de mute. Mute e Timeout se comportam de forma idêntica.
</Note>

As ações são avaliadas **da maior contagem de infrações para baixo**, e a primeira que qualifica dispara. Uma vez que uma ação dispara, todo o histórico de violações do membro é limpo, então a escalada reinicia do zero.

<Info>
  Automated Actions são a única parte da Auto-Moderação limitada por tier: **1 no Starter**, **50** em todo tier pago. No limite o botão de adicionar fica desabilitado — não há link de upgrade nele.
</Info>

## Salvamento

<Warning>
  **Os interruptores de regra são salvos um por vez.** Se um falhar no meio, os interruptores já aplicados ficam aplicados e o restante não. Reabra a página para ver o estado real em vez de supor que todo o salvamento foi revertido.
</Warning>

Listas vazias de configurações exclusivas são armazenadas como "unset" em vez de lista vazia — isso é normal e não é uma configuração perdida.

## Configurações que existem mas não podem ser acessadas

Várias configurações armazenadas são lidas pelo bot mas **não têm controle no painel**: listas de permissão e bloqueio de convites, a lista de bloqueio de external-links, se palavras proibidas casam dentro de palavras maiores e as contagens de escalada para mute por regra.

Elas mantêm o valor que têm e não podem ser alteradas por aqui.

## Solução de problemas

<AccordionGroup>
  <Accordion title="Nada é filtrado quando testo">
    Quase certamente você está testando como administrador. Administradores são isentos de toda regra.
  </Accordion>

  <Accordion title="Uma regra está ligada mas nunca dispara">
    Verifique os canais e cargos desabilitados dela, e lembre-se: só a primeira regra correspondente dispara por mensagem.
  </Accordion>

  <Accordion title="Timeout está configurado mas ninguém é silenciado">
    Você tem pelo menos uma Automated Action. Isso desabilita timeouts em nível de regra em todo lugar.
  </Accordion>

  <Accordion title="Alertas não são postados para spam ou texto repetido">
    Essas duas regras não suportam alertas, apesar do interruptor.
  </Accordion>

  <Accordion title="Todo link está sendo bloqueado">
    Sua lista de domínios permitidos está vazia. Adicione os domínios que quer permitir.
  </Accordion>

  <Accordion title="Uma alteração foi salva mas não teve efeito">
    Normalmente a configuração chega ao bot em cerca de 30 segundos, mas até 10 minutos se a notificação for perdida. Aguarde antes de salvar de novo.
  </Accordion>
</AccordionGroup>

## Relacionados

<CardGroup cols={2}>
  <Card title="AI Auto-Mod" icon="sparkles" href="/pt/moderation/ai-auto-mod">
    Pega intenção em vez do texto exato.
  </Card>

  <Card title="Logs" icon="scroll" href="/pt/moderation/logs">
    Registre ações da Auto-Moderação para revisão.
  </Card>
</CardGroup>
