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

# Adicionando o Vetox ao seu servidor

> Convide o Vetox, posicione o cargo dele corretamente e conclua a configuração inicial em poucos minutos.

<Steps>
  <Step title="Convide o bot">
    <Card title="Adicionar Vetox ao Discord" icon="discord" horizontal href="https://discord.com/oauth2/authorize?client_id=707333425685856316&permissions=8&integration_type=0&scope=bot">
      Abre a tela de autorização do Discord.
    </Card>

    Você precisa da permissão **Gerenciar Servidor** no servidor onde vai adicioná-lo. Escolha seu servidor no menu suspenso e confirme.

    O convite pede permissão de **Administrador**. O Vetox abrange moderação, cargos, canais, webhooks e emojis, e uma única permissão cobre tudo isso sem que você precise concedê-las uma a uma. Se preferir permissões mais restritas, edite o cargo Vetox em **Configurações do Servidor → Cargos** após o convite — recursos cujas permissões forem removidas deixarão de funcionar.
  </Step>

  <Step title="Suba o cargo Vetox">
    Vá em **Configurações do Servidor → Cargos** e arraste o cargo **Vetox** para perto do topo da lista.

    O Discord não permite que nenhum bot aja sobre um membro cujo cargo mais alto fique **acima** do cargo do próprio bot. Se o Vetox estiver abaixo dos cargos de moderadores, ele não conseguirá banir, silenciar nem atribuir cargos a eles — e a falha parece um bug em vez de um problema de permissão. Este é, de longe, o erro de configuração mais comum.
  </Step>

  <Step title="Abra o painel">
    Acesse [vetox.io/dashboard](https://vetox.io/dashboard) e entre com o Discord. Seus servidores aparecem automaticamente. Selecione aquele em que você acabou de adicionar o Vetox.
  </Step>

  <Step title="Ative os recursos que quiser">
    Abra a página **Configuração**. Todos os recursos estão listados ali, cada um com seu próprio interruptor, e **a maioria vem desativada por padrão**. Nada acontece até que você habilite aqui.

    Consulte [Configuração do servidor](/pt/server-management/setup).
  </Step>

  <Step title="Configure o que você ativou">
    Cada recurso ativado ganha sua própria página na barra lateral. Percorra os que você ligou — cada opção está documentada neste site.
  </Step>
</Steps>

<Warning>
  Colocar o cargo Vetox muito abaixo na sua lista de cargos é a causa mais comum de "o bot não está funcionando". O Discord recusa silenciosamente ações contra membros posicionados acima do bot.
</Warning>

## O que configurar primeiro

Você não precisa configurar tudo. Uma ordem sensata para um servidor novo:

<CardGroup cols={2}>
  <Card title="1. Logs" icon="scroll" href="/pt/moderation/logs">
    Gratuito, e registra o que aconteceu antes que você precise consultar.
  </Card>

  <Card title="2. Auto-Mod" icon="filter" href="/pt/moderation/auto-mod">
    Gratuito. Ative as regras que se encaixam nos problemas da sua comunidade.
  </Card>

  <Card title="3. Boas-vindas" icon="door-open" href="/pt/utility/welcomer">
    Cumprimente novos membros para que o servidor pareça vivo desde o primeiro minuto.
  </Card>

  <Card title="4. Níveis" icon="chart-line" href="/pt/engagement/leveling">
    Recompensa a atividade e dá aos membros um motivo para voltar.
  </Card>
</CardGroup>

## Verificando se funciona

Execute `/ping` em qualquer canal. Se o Vetox responder, ele está conectado e ativo.

<AccordionGroup>
  <Accordion title="Os comandos não aparecem">
    O Discord pode levar alguns minutos para sincronizar os comandos de um bot recém-adicionado. Fechar e reabrir totalmente o Discord costuma forçar uma atualização.

    Confirme também que o Vetox tem a permissão **Usar Comandos de Aplicativo** no canal em que você está testando.
  </Accordion>

  <Accordion title="O Vetox está offline">
    Verifique [vetox.io/status](https://vetox.io/status). Se estiver tudo operacional lá, remova e convide o bot novamente.
  </Accordion>

  <Accordion title="Um comando responde que eu não tenho permissão">
    O Vetox verifica as permissões por conta própria em vez de depender da visibilidade de comandos do Discord, então todo comando fica visível para todos, mas só é executado por quem está autorizado.

    Donos do servidor e membros com Administrador sempre passam. Você também pode conceder acesso a cargos específicos por comando — veja [gerenciamento de comandos](/pt/server-management/command-management).
  </Accordion>
</AccordionGroup>

<Note>
  Todos os comandos do Vetox funcionam **somente em servidores**. Nenhum deles funciona em mensagens diretas.
</Note>

## A seguir

<CardGroup cols={2}>
  <Card title="Visão geral do painel" icon="gauge" href="/pt/dashboard">
    Como o painel é organizado e o que fica em cada lugar.
  </Card>

  <Card title="Permissões" icon="user-lock" href="/pt/permissions">
    Quem pode executar comandos e quem pode alterar configurações.
  </Card>
</CardGroup>
