Bot Discord offline: errore gateway 4004/4014 risolto

Un bot Discord va offline per uno di pochi motivi prevedibili: un token reimpostato, un intent privilegiato disattivato, una finestra di voto scaduta su un bot ospitato, o il bot rimosso dal server da cui dipende. Il gateway di Discord ti dice quale con un codice di chiusura; i codici 4004 e 4013/4014 sono i due che vedrai più spesso, e ciascuno ha una correzione specifica e meccanica invece del solito «riavvialo e spera».

Inizia da qui: prima la causa più probabile

In ordine di frequenza con cui succede davvero:

1. Il token è stato reimpostato. Qualcuno ha premuto Reset Token nel Portale per sviluppatori, di proposito o per sbaglio, e il vecchio token usato dal bot ora non è più valido.
2. Un intent privilegiato è stato disattivato. Server Members Intent o Message Content Intent sono stati spenti dopo che il bot era già configurato.
3. Una finestra di voto o di abbonamento è scaduta. Su un bot ospitato come il Custom Bot di Noxyr, il tempo di esecuzione è legato a un voto su Top.gg, e la finestra più il suo periodo di tolleranza sono scaduti.
4. Il bot è stato rimosso dal server, o lo è un bot da cui dipende. Custom Bot dipende nello specifico dalla presenza di Noxyr; espellere Noxyr ferma il bot personalizzato su quel server.
5. Un vero disservizio. Discord stesso sta attraversando una brutta giornata. Succede raramente, ma controlla discordstatus.com prima di pensare che il problema sia nella tua configurazione.

Cosa significano davvero i codici di chiusura del gateway

Codice	Significato	Causa tipica
4004	Autenticazione non riuscita	Il token è sbagliato o è stato reimpostato nel Portale per sviluppatori
4013	Intent non validi	Il codice del bot richiede un intent che non esiste, o una combinazione che Discord rifiuta
4014	Intent non consentiti	Il bot richiede un intent privilegiato (Server Members o Message Content) che non è attivo per l'applicazione

In pratica, 4013 e 4014 compaiono per la stessa causa di fondo sulla maggior parte dei bot: un intent privilegiato di cui il codice ha bisogno è disattivato nel portale. Discord.js e librerie simili a volte segnalano questo nei log come errore «disallowed intents» invece del codice numerico grezzo, ma il problema è lo stesso. La nostra guida agli intent privilegiati del gateway spiega più nel dettaglio cosa controlla ciascun intent e cosa si rompe senza di esso.

Come risolvere ciascun caso su Noxyr Custom Bot

Gateway 4004, o «Discord ha rifiutato questo token»

Il token con cui il bot ha effettuato l'ultimo accesso non esiste più. Succede quando il token viene reimpostato nel Portale per sviluppatori, che sia stato fatto apposta (per ruotarlo per sicurezza) o per errore (premere Reset Token mentre si guarda la scheda Bot).

1. Apri il Portale per sviluppatori Discord, seleziona l'applicazione e vai alla scheda Bot.
2. Premi di nuovo Reset Token: questo genera un nuovo token; copialo subito, perché Discord lo mostra una sola volta.
3. Apri la pagina Custom Bot sulla dashboard di Noxyr e incolla il nuovo token.
4. Riattiva il bot. I nodi di Noxyr spengono automaticamente un bot con token non valido, così non resta bloccato in un ciclo di riconnessione senza fine; incollare un token funzionante e riattivarlo è ciò che lo fa ripartire.

Gateway 4013/4014, o «Discord ha rifiutato la connessione»

Un intent privilegiato attivo durante la configurazione è stato disattivato più tardi, di solito mentre qualcuno stava cliccando nella scheda Bot per un motivo non correlato.

1. Nel Portale per sviluppatori, vai su Bot → Privileged Gateway Intents.
2. Riattiva Server Members Intent e Message Content Intent. Sono entrambi obbligatori: le funzioni di Noxyr (messaggi di benvenuto, conteggio dei membri, chat AI, risposte automatiche, trascrizioni dei ticket) ne richiedono entrambi.
3. Salva, poi riattiva il bot dalla pagina Custom Bot della dashboard. Poiché Discord applica le modifiche agli intent solo al login successivo, riattivare semplicemente l'interruttore non basta da solo: il bot deve riconnettersi.

Finestra di voto e periodo di tolleranza scaduti

Custom Bot funziona grazie a un voto su Top.gg. Un voto lo sblocca per 12 ore; dopo, un periodo di tolleranza di 74 ore mantiene il bot in esecuzione mentre la pagina della dashboard si blocca. Se entrambi scadono, il bot va offline, anche se nulla della tua configurazione viene eliminato.

1. Vota Noxyr su Top.gg.
2. Torna alla pagina Custom Bot: si sblocca subito dopo che il voto è stato registrato.
3. Il bot si riavvia da solo, usando lo stesso token e le stesse impostazioni di prima.

Un promemoria via DM arriva 24 ore dopo il tuo ultimo voto (12 ore dentro il periodo di tolleranza) proprio per evitare questo problema. Se lo stato del bot mostra «sospeso», la pagina stessa indicherà se la causa è il voto, il periodo di tolleranza o il problema successivo qui sotto.

Noxyr è stato rimosso dal server

Custom Bot funziona con le impostazioni e il database di Noxyr per quel server, quindi dipende dal fatto che Noxyr sia ancora un membro. Se Noxyr viene espulso, il bot personalizzato smette di servire quel server entro circa un minuto, e invia un DM a chi ha rimosso Noxyr (e al proprietario del bot, se è un'altra persona) con un link di invito.

1. Invita di nuovo Noxyr usando il link del DM, o dalla homepage di Noxyr.
2. Il bot personalizzato riprende da solo non appena Noxyr torna nel server; non serve toccare token o intent.

Mentre è fermo per questo motivo specifico, la finestra di voto è in pausa invece di essere consumata, quindi reinvitare Noxyr subito non ti fa perdere tempo dal conteggio.

Se nessuna delle soluzioni sopra lo risolve

Controlla prima il messaggio di stato nella pagina Custom Bot: i nodi di Noxyr scrivono un motivo in linguaggio semplice (token non valido, intent non validi, sospeso, oppure un messaggio generico di nuovo tentativo per tutto il resto) invece di un semplice codice di errore. Se il messaggio di stato non corrisponde a nessuno dei casi sopra, o se il bot resta offline dopo una correzione che avrebbe dovuto funzionare, il Centro assistenza è il modo più rapido per far esaminare il server specifico. I passaggi completi di configurazione e risoluzione dei problemi si trovano anche nella documentazione sui Custom Bot.

Domande frequenti

Perché il mio bot è andato offline proprio mentre non avevo fatto nulla? «Non ho fatto nulla» di solito significa che qualcun altro con accesso al portale o al server ha cambiato qualcosa: un reset del token, un interruttore di un intent, un'espulsione. Controlla prima il messaggio di stato della pagina Custom Bot; indica la causa.

Perdo i dati se il bot va offline? No. Token, impostazioni, ticket, prodotti, fatture e trascrizioni vengono conservati in ogni caso, qualunque sia il motivo per cui il bot si è fermato. Risolvere la causa riporta tutto esattamente com'era.

Posso evitare del tutto il caso offline legato al voto? Vota circa ogni tre giorni e mezzo (prima che scadano la finestra di 12 ore e il periodo di tolleranza di 74 ore) e il bot non va mai giù per quel motivo.

Devo riattivare gli intent ogni volta che riavvio il bot? No. Gli intent sono un'impostazione dell'applicazione Discord stessa, non qualcosa che si reimposta. Una volta attivati entrambi e salvati, restano attivi finché qualcuno non li disattiva.

Pronto a rimetterlo online? Risolvi la causa qui sopra, poi avvia il bot dalla pagina Custom Bot, oppure aggiungi Noxyr gratis se lo stai configurando per la prima volta.