> ## 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.

# Solução de problemas

> Diagnostique problemas em ordem — as verificações que resolvem a esmagadora maioria dos problemas do Vetox.

Percorra estas em ordem. As três primeiras resolvem a maioria dos relatos.

## As três primeiras verificações

<Steps>
  <Step title="O módulo está ligado?">
    A maioria dos recursos vem **desligada por padrão**. Configurar a página do próprio recurso não faz nada até que seu interruptor esteja ligado em [Server Setup](/pt/server-management/setup).

    Essa é a causa mais comum de "configurei e nada aconteceu".
  </Step>

  <Step title="O cargo do Vetox está alto o suficiente?">
    Para qualquer coisa que envolva cargos ou membros, **o cargo do Vetox precisa estar acima do cargo mais alto do alvo**. Arraste-o para cima em Configurações do Servidor → Cargos.

    O Discord recusa essas ações independentemente das permissões, e várias partes do Vetox falham **silenciosamente** quando isso está errado — o de Tickets em particular não dá erro algum.
  </Step>

  <Step title="O Vetox tem a permissão do canal?">
    Verifique as permissões *efetivas* do bot no canal específico, não seu cargo em nível de servidor. **Embed Links** é a que mais costuma faltar.
  </Step>
</Steps>

## Por sintoma

<AccordionGroup>
  <Accordion title="O Auto-Moderation não está filtrando nada" icon="filter">
    1. Todas as oito regras vêm **desativadas** — ligue as que quiser
    2. **Administradores nunca são filtrados.** Teste com uma conta comum
    3. Apenas a primeira regra que corresponder dispara por mensagem
    4. Verifique os canais e cargos desabilitados da própria regra
    5. Se existir qualquer Automated Action, os timeouts em nível de regra são suprimidos em todo lugar
  </Accordion>

  <Accordion title="Notificações nunca chegam" icon="bell">
    1. O toggle da plataforma em **Server Setup** — desligado por padrão, e a página de notificações não mostra o estado
    2. Premium **Basic** ativo ou superior
    3. **Embed Links** no canal de destino
    4. No Twitch e Kick, adicionar um streamer que já está ao vivo não anuncia nada até a próxima stream
    5. Qualquer coisa publicada enquanto o premium estava expirado é marcada como vista e não será reproduzida
  </Accordion>

  <Accordion title="Cargos não estão sendo atribuídos" icon="user-tag">
    1. O cargo precisa estar **abaixo** do cargo do Vetox
    2. O Vetox precisa de **Manage Roles**
    3. O Vetox se recusa a conceder qualquer cargo com Administrator, Manage Server ou Manage Roles como recompensa — isso não pode ser sobreposto
    4. Numa linha de cargo-recompensa sem cargo selecionado, a linha é descartada silenciosamente ao salvar
  </Accordion>

  <Accordion title="A staff não consegue ver ou agir em tickets" icon="ticket">
    Quase sempre **hierarquia de cargos**. Mova o cargo do Vetox acima de todos os cargos de suporte.

    Falhas de permissão em ticket não produzem erro, registro de log nem sintoma visível além da staff não conseguir agir.
  </Accordion>

  <Accordion title="Um campo de embed continua desaparecendo" icon="rectangle-list">
    Seu título ou valor foi resolvido como vazio, e campos vazios são descartados. Quase sempre uma variável com erro de digitação ou uma que não existe para aquele recurso — veja [Variáveis](/pt/help/variables).
  </Accordion>

  <Accordion title="Uma configuração salvou mas não teve efeito" icon="floppy-disk">
    A configuração normalmente chega ao bot em segundos. Se a notificação é perdida, o bot mantém o valor antigo até o cache expirar — **até cerca de 10 minutos**.

    Espere dez minutos antes de salvar novamente.
  </Accordion>

  <Accordion title="Membros não estão ganhando XP" icon="chart-line">
    1. Leveling ligado em Server Setup
    2. O canal não está excluído, e o membro não tem um cargo excluído
    3. No **Starter**, os interruptores on-off de texto/voz/reação não têm efeito — o bot usa as taxas padrão de qualquer forma
  </Accordion>

  <Accordion title="Mensagens de boas-vindas não estão postando" icon="hand-wave">
    1. Welcomer ligado em Server Setup, um canal definido, o interruptor de mensagem ligado
    2. **Attach Files** para a imagem
    3. Se `[Server]` aparecer literalmente, troque para `[ServerName]`
    4. Se seu embed continua revertendo, o tipo de mensagem precisa estar definido como **Embed** ao salvar
  </Accordion>

  <Accordion title="Uma application não pode ser enviada" icon="clipboard-list">
    Um formulário em modal com mais de 5 perguntas onde uma posterior é obrigatória **nunca** pode ser enviado — o Discord mostra 5 campos mas o 6º ainda é validado.

    Mude para o fluxo Private Message, ou torne as perguntas 6+ opcionais.
  </Accordion>

  <Accordion title="Um comando não aparece" icon="terminal">
    1. Todo comando é **apenas para guildas** — nenhum funciona em DMs
    2. Pode estar desabilitado ou restrito na página [Commands](/pt/server-management/command-management)
    3. Reinicie seu cliente Discord para atualizar a lista de comandos
  </Accordion>

  <Accordion title="Recursos de IA pararam de funcionar" icon="sparkles">
    Verifique o saldo de tokens em [AI Usage](/pt/moderation/ai-usage).

    O Auto-Mod para abaixo de 3.000 tokens; o Server Control recusa abaixo de 30.000. O Auto-Mod é fail-closed — se não puder confirmar o orçamento, não escaneia.
  </Accordion>

  <Accordion title="O AI Server Control me ignora completamente" icon="wand-magic-sparkles">
    Silêncio é a resposta normal para toda falha de acesso. Em ordem:

    1. Mencione o bot **diretamente** — um ping de cargo ou de reply não é um gatilho
    2. AI Server Control ligado em Server Setup
    3. O canal está no escopo
    4. Você é Administrator, **ou** está em uma allowlist com *Allowlist bypasses Administrator* ligado — as allowlists sozinhas não fazem nada
    5. Você não está com rate-limit
  </Accordion>

  <Accordion title="Uma compra não foi aplicada" icon="credit-card">
    Normalmente é aplicada em um segundo. Espere cerca de 15 minutos, depois contate o suporte — **não compre de novo**.
  </Accordion>

  <Accordion title="Dados sumiram depois de fazer downgrade" icon="triangle-exclamation">
    Nove categorias são apagadas permanentemente em vez de desativadas — mais importante, **perguntas de application acima do novo limite**. Veja [Feature limits](/pt/premium/feature-limits).
  </Accordion>

  <Accordion title="Algo agendado dispara na hora errada" icon="clock">
    Verifique o **Server Timezone** em Server Setup — ele orienta streaks, resets e ações agendadas.

    Reminders são a exceção: capturam o timezone do navegador em que foram criados, e não há controle para isso.
  </Accordion>
</AccordionGroup>

## Coisas que parecem quebradas mas não estão

<Note>
  | Comportamento                                                | Por quê                                       |
  | ------------------------------------------------------------ | --------------------------------------------- |
  | Administradores passam pelo Auto-Moderation                  | Por design, e não mostrado na interface       |
  | Apenas uma regra de Auto-Mod dispara por mensagem            | Por design — a primeira correspondência vence |
  | Um streamer adicionado no meio da stream não produz nada     | O tracking ao vivo dispara na transição       |
  | Seu rank de Vito atrasa em relação ao seu saldo              | Rankings são recalculados a cada 12 horas     |
  | Um reminder único permanece na lista após disparar           | Mantido como registro, marcado como concluído |
  | Sete cards de Server Setup piscam "Enabled" no primeiro load | Cosmético; o estado Disabled é o correto      |
  | `/move` sem usuário move você                                | A opção faz padrão para quem chamou           |
</Note>

## Ainda com problemas

<CardGroup cols={2}>
  <Card title="Servidor de suporte" icon="discord" href="https://discord.gg/vetox">
    Pergunte no Discord do Vetox.
  </Card>

  <Card title="I Need Help" icon="life-ring" href="/pt/server-management/support-sessions">
    Deixe um agente ver seu dashboard ao vivo.
  </Card>
</CardGroup>
