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

# Aggiungere Vetox al tuo server

> Invita Vetox, posiziona correttamente il suo ruolo e completa la configurazione iniziale in pochi minuti.

<Steps>
  <Step title="Invita il bot">
    <Card title="Aggiungi Vetox a Discord" icon="discord" horizontal href="https://discord.com/oauth2/authorize?client_id=707333425685856316&permissions=8&integration_type=0&scope=bot">
      Apre la schermata di autorizzazione di Discord.
    </Card>

    Ti serve il permesso **Gestire Server** nel server dove lo aggiungi. Scegli il server dal menu a tendina e conferma.

    L'invito richiede **Amministratore**. Vetox copre moderazione, ruoli, canali, webhook ed emoji, e un unico permesso li copre tutti senza concederli uno alla volta. Se preferisci permessi più stretti, modifica il ruolo Vetox in **Impostazioni Server → Ruoli** dopo l'invito — le funzioni di cui rimuovi i permessi smetteranno di funzionare.
  </Step>

  <Step title="Sposta in alto il ruolo di Vetox">
    Vai su **Impostazioni Server → Ruoli** e trascina **Vetox** vicino alla cima della lista.

    Discord non consentirà a nessun bot di agire su un membro il cui ruolo più alto è **sopra** il ruolo del bot stesso. Se Vetox è sotto i tuoi ruoli moderatore non può bannarli, silenziarli o assegnare loro ruoli — e il fallimento sembrerà un bug invece che un problema di permessi. È l'errore di setup più comune.
  </Step>

  <Step title="Apri la dashboard">
    Vai su [vetox.io/dashboard](https://vetox.io/dashboard) e accedi con Discord. I tuoi server appaiono automaticamente. Seleziona quello a cui hai appena aggiunto Vetox.
  </Step>

  <Step title="Attiva le funzioni che vuoi">
    Apri la pagina **Setup**. Ogni funzione è elencata lì con il proprio interruttore, e **la maggior parte è disattivata di default**. Nulla succede finché non le abiliti qui.

    Vedi [Configurazione del server](/it/server-management/setup).
  </Step>

  <Step title="Configura ciò che hai attivato">
    Ogni funzione attivata ottiene la propria pagina nella sidebar. Lavora attraverso quelle che hai attivato — ogni opzione è documentata in questo sito.
  </Step>
</Steps>

<Warning>
  Posizionare il ruolo Vetox troppo in basso nella lista dei ruoli è la causa più comune di "il bot non funziona". Discord rifiuta silenziosamente le azioni contro membri classificati sopra il bot.
</Warning>

## Cosa configurare per primo

Non devi configurare tutto. Un ordine sensato per un nuovo server:

<CardGroup cols={2}>
  <Card title="1. Log" icon="scroll" href="/it/moderation/logs">
    Gratuito, e registra cosa è successo prima che tu abbia bisogno di consultarlo.
  </Card>

  <Card title="2. Auto-Mod" icon="filter" href="/it/moderation/auto-mod">
    Gratuito. Abilita le regole che corrispondono ai problemi della tua community.
  </Card>

  <Card title="3. Welcomer" icon="door-open" href="/it/utility/welcomer">
    Saluta i nuovi membri così il server sembra vivo dal primo minuto.
  </Card>

  <Card title="4. Livelli" icon="chart-line" href="/it/engagement/leveling">
    Premia l'attività e dà ai membri un motivo per tornare.
  </Card>
</CardGroup>

## Verificare che funzioni

Esegui `/ping` in qualsiasi canale. Se Vetox risponde, è connesso e attivo.

<AccordionGroup>
  <Accordion title="I comandi non appaiono">
    Discord può impiegare alcuni minuti a sincronizzare i comandi con un bot appena aggiunto. Uscire completamente e riaprire Discord di solito forza un refresh.

    Conferma anche che Vetox abbia il permesso **Usa Comandi Applicazione** nel canale in cui stai testando.
  </Accordion>

  <Accordion title="Vetox è offline">
    Controlla [vetox.io/status](https://vetox.io/status). Se tutto è operativo lì, rimuovi e reinvita il bot.
  </Accordion>

  <Accordion title="Un comando risponde che non ho i permessi">
    Vetox controlla i permessi da solo invece di affidarsi alla visibilità dei comandi di Discord, quindi ogni comando è visibile a tutti ma viene eseguito solo per gli autorizzati.

    Proprietari del server e membri con Amministratore passano sempre. Puoi anche concedere l'accesso a ruoli specifici per comando — vedi [gestione dei comandi](/it/server-management/command-management).
  </Accordion>
</AccordionGroup>

<Note>
  Tutti i comandi di Vetox sono **solo per server**. Nessuno funziona nei messaggi diretti.
</Note>

## Avanti

<CardGroup cols={2}>
  <Card title="Panoramica della dashboard" icon="gauge" href="/it/dashboard">
    Come è organizzata la dashboard e cosa si trova dove.
  </Card>

  <Card title="Permessi" icon="user-lock" href="/it/permissions">
    Chi può eseguire i comandi e chi può modificare le impostazioni.
  </Card>
</CardGroup>
