Crea il tuo bot Discord
Guida completa per creare un bot Discord dal Developer Portal, ottenere il token, la public key e invitarlo nel tuo server con i permessi corretti.
Vai su Discord Developer Portal
Apri il browser e vai su:
discord.com/developers/applications →Clicca su New Application in alto a destra.
Puoi accedere al Developer Portal solo da browser — non dall'app Discord.
Crea l'applicazione
Inserisci il nome del tuo bot (es. MioServerBot) e clicca Create.
Verrai reindirizzato alla pagina General Information dell'applicazione.
Il nome dell'applicazione è quello che vedranno gli utenti quando autorizzano il bot. Sceglilo con cura.
Copia la Public Key
Nella pagina General Information trovi il campo Public Key.
Clicca su Copy e salvala — ti servirà durante il setup su NexusPass.
Esempio: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6... (64 caratteri)
La Public Key serve a NexusPass per verificare che i comandi slash vengano davvero da Discord e non da qualcun altro.
Crea il Bot e ottieni il Token
Nel menu laterale clicca su Bot.
Clicca su Reset Token → conferma → clicca Copy.
⚠️ Il token appare una sola volta. Salvalo subito in un posto sicuro.
Formato: MTIzNDU2Nzg5.XXXXXX.XXXXXXXXXXXXXXXXXXXXXXXX
Il Bot Token è come una password — non condividerlo mai. NexusPass lo cifra con AES-256 prima di salvarlo.
Configura i permessi del bot
Nella pagina Bot, scorri fino a Bot Permissions e spunta:
- Manage Roles — obbligatorio per assegnare ruoli
- Send Messages — opzionale, per messaggi DM
Nella sezione Privileged Gateway Intents lascia tutto disattivato — NexusPass usa HTTP, non WebSocket.
Il bot deve avere il ruolo più in alto nella gerarchia dei ruoli per poter assegnare ruoli agli utenti.
Invita il bot nel tuo server
Nel menu laterale clicca su OAuth2 → URL Generator.
Spunta questi scope:
botapplications.commands
Nelle Bot Permissions spunta Manage Roles.
Copia l'URL generato in fondo, aprilo nel browser, seleziona il tuo server e clicca Autorizza.
Usa sempre il link generato dal Developer Portal — non copiare link di invito da altre fonti.
Sistemare la gerarchia dei ruoli
Nel tuo server Discord:
- Vai su Impostazioni Server → Ruoli
- Trova il ruolo del tuo bot (ha lo stesso nome dell'applicazione)
- Trascinalo sopra tutti i ruoli che deve assegnare
- Salva le modifiche
Questo step è fondamentale. Se il ruolo del bot è più in basso del ruolo che deve assegnare, Discord restituirà un errore 403.
✓ Hai completato questo step! Ora hai:
- Bot Token (cifrato da NexusPass)
- Public Key Discord
- Bot invitato nel server con permesso Manage Roles
- Gerarchia ruoli configurata correttamente