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

# Risoluzione dei problemi

> Diagnostica i problemi in ordine — i controlli che risolvono la stragrande maggioranza delle segnalazioni Vetox.

Segui questi in ordine. I primi tre risolvono la maggior parte delle segnalazioni.

## I primi tre controlli

<Steps>
  <Step title="Il modulo è attivato?">
    La maggior parte delle funzionalità è **disattivata per impostazione predefinita**. Configurare la pagina di una funzionalità non fa nulla finché il suo interruttore non è attivo in [Server Setup](/it/server-management/setup).

    Questa è la causa singolarmente più comune di "l'ho configurato e non è successo nulla".
  </Step>

  <Step title="Il ruolo Vetox è abbastanza in alto?">
    Per qualsiasi cosa che tocca ruoli o membri, **il ruolo Vetox deve essere sopra il ruolo più alto del bersaglio**. Trascinalo in alto in Impostazioni Server → Ruoli.

    Discord rifiuta queste azioni indipendentemente dai permessi, e diverse parti di Vetox falliscono **silenziosamente** quando ciò è sbagliato — in particolare Tickets non dà alcun errore.
  </Step>

  <Step title="Vetox ha il permesso di canale?">
    Controlla i permessi *effettivi* del bot nel canale specifico, non il suo ruolo a livello di server. **Embed Links** è quello che manca più spesso.
  </Step>
</Steps>

## Per sintomo

<AccordionGroup>
  <Accordion title="Auto-Moderation non filtra nulla" icon="filter">
    1. Tutte le otto regole vengono fornite **disabilitate** — attiva quelle che vuoi
    2. **Gli amministratori non vengono mai filtrati.** Testa con un account normale
    3. Solo la prima regola corrispondente scatta per messaggio
    4. Controlla i canali e i ruoli disabilitati della regola stessa
    5. Se esiste una Automated Action, i timeout a livello di regola vengono soppressi ovunque
  </Accordion>

  <Accordion title="Le notifiche non arrivano mai" icon="bell">
    1. Il toggle della piattaforma in **Server Setup** — disattivato per impostazione predefinita, e la pagina delle notifiche non ne mostra lo stato
    2. Premium **Basic** o superiore attivo
    3. **Embed Links** nel canale di destinazione
    4. Su Twitch e Kick, aggiungere uno streamer che è già live non annuncia nulla fino al suo prossimo stream
    5. Qualsiasi cosa pubblicata mentre il premium era scaduto è marcata come vista e non verrà riprodotta
  </Accordion>

  <Accordion title="I ruoli non vengono assegnati" icon="user-tag">
    1. Il ruolo deve essere **sotto** il ruolo Vetox
    2. Vetox necessita di **Manage Roles**
    3. Vetox rifiuta di concedere come ricompensa qualsiasi ruolo che ha Administrator, Manage Server o Manage Roles — ciò non può essere sovrascritto
    4. Su una riga di reward-role senza ruolo selezionato, la riga viene silenziosamente scartata al salvataggio
  </Accordion>

  <Accordion title="Lo staff non può vedere o agire nei ticket" icon="ticket">
    Quasi sempre **gerarchia dei ruoli**. Sposta il ruolo Vetox sopra ogni ruolo di supporto.

    I fallimenti dei permessi ticket non producono alcun errore, alcuna voce di log e alcun sintomo visibile diverso dallo staff non in grado di agire.
  </Accordion>

  <Accordion title="Un campo embed continua a sparire" icon="rectangle-list">
    Il suo titolo o valore si è risolto in vuoto, e i campi vuoti vengono scartati. Quasi sempre una variabile scritta male o inesistente per quella funzionalità — controlla [Variabili](/it/help/variables).
  </Accordion>

  <Accordion title="Un'impostazione è stata salvata ma non ha avuto effetto" icon="floppy-disk">
    La configurazione normalmente raggiunge il bot entro secondi. Se la notifica viene persa, il bot mantiene il vecchio valore finché la sua cache non scade — **fino a circa 10 minuti**.

    Aspetta dieci minuti prima di ri-salvare.
  </Accordion>

  <Accordion title="I membri non guadagnano XP" icon="chart-line">
    1. Leveling attivato in Server Setup
    2. Il canale non è escluso, e il membro non ha un ruolo escluso
    3. Su **Starter**, gli interruttori on-off text/voice/reaction non hanno effetto — il bot usa comunque tassi standard
  </Accordion>

  <Accordion title="I messaggi di benvenuto non vengono pubblicati" icon="hand-wave">
    1. Welcomer attivo in Server Setup, un canale impostato, l'interruttore del messaggio attivo
    2. **Attach Files** per l'immagine
    3. Se `[Server]` appare letteralmente, cambialo in `[ServerName]`
    4. Se il tuo embed continua a tornare indietro, il tipo di messaggio deve essere impostato su **Embed** quando salvi
  </Accordion>

  <Accordion title="Un'application non può essere inviata" icon="clipboard-list">
    Un form dialog con più di 5 domande in cui una successiva è obbligatoria non può **mai** essere inviato — Discord mostra 5 campi ma il 6° viene comunque validato.

    Passa al flusso Private Message, o rendi facoltative le domande 6+.
  </Accordion>

  <Accordion title="Un comando non appare" icon="terminal">
    1. Ogni comando è **solo per guild** — nessuno funziona nei DM
    2. Potrebbe essere disabilitato o limitato nella pagina [Comandi](/it/server-management/command-management)
    3. Riavvia il client Discord per aggiornare l'elenco dei comandi
  </Accordion>

  <Accordion title="Le funzionalità AI hanno smesso di funzionare" icon="sparkles">
    Controlla il saldo di token in [Utilizzo AI](/it/moderation/ai-usage).

    Auto-Mod si ferma sotto i 3.000 token; Server Control declina sotto i 30.000. Auto-Mod è fail-closed — se non può confermare il budget, non scansiona.
  </Accordion>

  <Accordion title="AI Server Control mi ignora completamente" icon="wand-magic-sparkles">
    Il silenzio è la risposta normale a ogni fallimento di accesso. In ordine:

    1. Menziona il bot **direttamente** — un ping di ruolo o un ping di risposta non è un trigger
    2. AI Server Control attivo in Server Setup
    3. Il canale è nell'ambito
    4. Sei Administrator, **oppure** in una allowlist con *Allowlist bypasses Administrator* attivo — le allowlist da sole non fanno nulla
    5. Non sei rate-limited
  </Accordion>

  <Accordion title="Un acquisto non è stato applicato" icon="credit-card">
    Normalmente si applica entro un secondo. Aspetta circa 15 minuti, poi contatta il supporto — **non ricomprare**.
  </Accordion>

  <Accordion title="I dati sono spariti dopo il downgrade" icon="triangle-exclamation">
    Nove categorie vengono eliminate permanentemente piuttosto che disabilitate — in particolare **le domande delle application oltre il nuovo limite**. Vedi [Limiti delle funzionalità](/it/premium/feature-limits).
  </Accordion>

  <Accordion title="Una cosa programmata scatta all'orario sbagliato" icon="clock">
    Controlla il **Server Timezone** in Server Setup — governa streak, reset e azioni programmate.

    I reminder sono l'eccezione: catturano il fuso orario del browser in cui sono stati creati, e non c'è alcun controllo per esso.
  </Accordion>
</AccordionGroup>

## Cose che sembrano rotte ma non lo sono

<Note>
  | Comportamento                                                        | Perché                                             |
  | -------------------------------------------------------------------- | -------------------------------------------------- |
  | Gli amministratori bypassano Auto-Moderation                         | Per progettazione, e non mostrato nell'interfaccia |
  | Solo una regola Auto-Mod scatta per messaggio                        | Per progettazione — la prima corrispondenza vince  |
  | Uno streamer aggiunto a metà stream non produce nulla                | Il tracking live scatta sulla transizione          |
  | Il tuo rank Vito è in ritardo rispetto al saldo                      | Le classifiche ricalcolano ogni 12 ore             |
  | Un reminder una tantum resta nell'elenco dopo aver scattato          | Mantenuto come registro, marcato come completato   |
  | Sette schede Server Setup lampeggiano "Enabled" al primo caricamento | Cosmetico; lo stato Disabled è quello veritiero    |
  | `/move` senza user muove te                                          | L'opzione predefinita è il chiamante               |
</Note>

## Ancora bloccato

<CardGroup cols={2}>
  <Card title="Server di supporto" icon="discord" href="https://discord.gg/vetox">
    Chiedi nel Discord di Vetox.
  </Card>

  <Card title="I Need Help" icon="life-ring" href="/it/server-management/support-sessions">
    Lascia che un agente veda la tua dashboard in diretta.
  </Card>
</CardGroup>
