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

# Custom Bot

> Esegui Vetox sotto il tuo nome, avatar e profilo del bot. Un add-on per Max e Black.

Ogni funzionalità Vetox, in esecuzione sotto il **tuo** account bot — il tuo nome, il tuo avatar, il tuo stato.

<Info>
  Disponibile su **Max** e **Black** come add-on: **Max+** e **Black+**. Vedi [Server Premium](/it/premium/overview) per i prezzi.
</Info>

<Warning>
  **Custom Bot non concede l'accesso all'AI.** È un flag separato dal tuo tier, e l'AI è vincolata solo al tier. **Max+ non ha AI.** Solo Black e Black+ ce l'hanno.
</Warning>

## Cosa cambia

|                           | Effetto                                                                                             |
| ------------------------- | --------------------------------------------------------------------------------------------------- |
| **Nome, avatar, banner**  | Quelli del tuo bot                                                                                  |
| **Descrizione**           | Fino a 400 caratteri                                                                                |
| **Stato**                 | Playing, Watching, Listening o Competing                                                            |
| **Comandi slash**         | Registrati sulla tua applicazione                                                                   |
| **Il bot Vetox pubblico** | **Diventa silenzioso in quel server** — smette di rispondere così i due non rispondono mai entrambi |

<Note>
  Discord non consente ai bot di usare uno stato personalizzato semplice. Il tuo stato deve essere uno dei quattro tipi di attività.
</Note>

<Note>
  Gli aggiornamenti di identità sono additivi. Svuotare un campo lascia il valore precedente piuttosto che rimuoverlo — imposta invece un ricambio.
</Note>

## Un server per bot

<Warning>
  Un Custom Bot serve **un server**. All'avvio lascia qualsiasi altro server a cui è stato aggiunto.

  Non usare la stessa applicazione bot su diverse community.
</Warning>

## Configurazione

<Steps>
  <Step title="Crea un'applicazione Discord">
    Nel Discord Developer Portal, crea un'applicazione e aggiungi un bot ad essa.
  </Step>

  <Step title="Abilita gli intent privilegiati">
    **Server Members**, **Presence** e **Message Content** sono tutti obbligatori. Senza di essi il bot non può avviarsi.
  </Step>

  <Step title="Copia il token e invialo">
    Incollalo nella dashboard. Vetox lo convalida con Discord prima di accettarlo.

    <Warning>
      **Il token è a sola scrittura.** Una volta inviato non puoi rileggerlo da Vetox. Salva prima la tua copia — se la perdi dovrai rigenerarlo nel Developer Portal e inviare quello nuovo.
    </Warning>
  </Step>

  <Step title="Invita il tuo bot nel tuo server">
    Usando il link di invito della tua applicazione, con i permessi di cui Vetox ha bisogno.
  </Step>

  <Step title="Attendi che venga online">
    Si avvia in pochi istanti. Il bot Vetox pubblico smette poi di rispondere in quel server.
  </Step>
</Steps>

<Note>
  Il tuo token è crittografato a riposo. Vetox convalida il formato, conferma che appartiene a un account bot, controlla l'applicazione e verifica i tre intent richiesti prima di accettarlo.
</Note>

## Trasferire a un altro server

Spostare un Custom Bot è una conferma in due passaggi, e la richiesta scade dopo **30 minuti**.

<Warning>
  Un trasferimento è definitivo una volta confermato. Il bot lascia il vecchio server e il bot Vetox pubblico riprende lì.
</Warning>

## Disattivazione

Disattivare ferma il bot e **cancella il token memorizzato**. Le impostazioni di branding e il registro di audit vengono mantenuti.

Per riattivare, invia di nuovo il token.

## Se va in crash

Un bot che va in crash tre volte entro un minuto viene fermato automaticamente per proteggere la piattaforma. Correggi la causa — di solito un token revocato o intent mancanti — poi riattivalo.

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Il bot non viene online">
    Tutti e tre gli intent privilegiati devono essere abilitati nel Developer Portal: Server Members, Presence e Message Content. Questa è la causa più comune.
  </Accordion>

  <Accordion title="Entrambi i bot rispondono a tutto">
    Il bot pubblico diventa silenzioso solo nel server che il Custom Bot serve. Se vedi entrambi, il Custom Bot potrebbe non essersi avviato — controlla il suo stato nella dashboard.
  </Accordion>

  <Accordion title="Ho perso il mio token">
    Vetox non può mostrartelo. Rigeneralo nel Developer Portal e invia quello nuovo.
  </Accordion>

  <Accordion title="Il mio bot ha lasciato un server da solo">
    Previsto — un Custom Bot serve un server e lascia gli altri all'avvio.
  </Accordion>

  <Accordion title="Sono su Max+ e l'AI è bloccata">
    Corretto. Custom Bot non è un cambio di tier; l'AI richiede Black.
  </Accordion>

  <Accordion title="Ho cambiato l'avatar e il vecchio viene ancora mostrato">
    Discord memorizza aggressivamente in cache gli avatar dei bot. Dagli tempo prima di rinviare.
  </Accordion>
</AccordionGroup>

<Card title="Gestione Bot" icon="gauge" horizontal href="/it/account/manage-bots">
  La pagina dashboard dove questo viene configurato.
</Card>