Come creare un bot Discord: la guida completa per principianti

Se stai configurando un Beatra Custom Bot, la prima cosa di cui hai bisogno è un tuo bot Discord — un'applicazione con un token e gli intent corretti attivati. Questa guida ti accompagna in ogni passaggio. Preferisci guardare un video? Qui sotto trovi un tutorial video completo.

🎥 Tutorial video: https://www.youtube.com/watch?v=qddwRsNU2X8

Creare un bot Discord è gratuito e richiede solo pochi minuti. Segui i passaggi nell'ordine indicato.

Passo 1 — Apri il Discord Developer Portal

Vai al Discord Developer Portal all'indirizzo https://discord.com/developers/applications e accedi con il tuo account Discord. Questo è il luogo ufficiale dove tutti i bot Discord vengono creati e gestiti.

Passo 2 — Crea una nuova applicazione

Clicca su New Application in alto a destra. Dagli un nome — questo è il nome del progetto del tuo bot e può essere cambiato in seguito — accetta i termini e clicca Create. Ora hai un'applicazione.

Passo 3 — Apri la scheda Bot

Nella barra laterale sinistra, clicca sulla scheda Bot. Discord crea automaticamente un utente bot per la tua applicazione. Qui puoi impostare il nome utente e l'immagine del profilo del bot, ovvero ciò che la tua community vedrà.

Passo 4 — Attiva i Privileged Gateway Intents

Questo è il passaggio più importante, ed è quello che viene saltato più spesso. Scorri fino a Privileged Gateway Intents e attiva tutti e tre:

• Presence Intent
• Server Members Intent
• Message Content Intent

Beatra ha bisogno del Message Content Intent per leggere i comandi, e degli altri due per funzionare correttamente sul tuo server. Se sono disattivati, il tuo bot non si avvierà o non risponderà. Clicca su Save Changes dopo averli attivati.

Passo 5 — Rendi il bot pubblico

Sempre nella scheda Bot, trova l'impostazione Public Bot e assicurati che sia attivata. Questo permette a te — e al flusso di onboarding di Beatra — di aggiungere il bot al tuo server tramite un link di invito. Se è disattivata, solo tu potresti aggiungerlo, e la configurazione potrebbe fallire.

Passo 6 — Copia il tuo token

In cima alla scheda Bot, clicca su Reset Token e conferma. Discord mostra il token del tuo bot una sola volta — clicca su Copy.

⚠️ Mantieni il tuo token segreto. Chiunque possieda il tuo token ha il controllo completo del tuo bot. Non condividerlo né pubblicarlo mai. Se dovesse mai trapelare, torna qui e reimpostalo. Beatra memorizza il tuo token completamente crittografato e non lo mostra mai più.

Passo 7 — Incollalo in Beatra

Torna alla schermata di onboarding del Beatra Custom Bot e incolla il token nel campo apposito. Beatra verifica il token e controlla che il Message Content Intent sia attivato prima di proseguire. Se vedi un errore relativo agli intent, torna al Passo 4, attiva gli intent, salva e riprova.

Problemi comuni

• "Message Content Intent is disabled" — hai saltato il Passo 4. Attiva tutti e tre gli intent e salva.
• "Invalid token" — il token è stato copiato in modo errato oppure è stato reimpostato in seguito. Reimpostalo di nuovo e copia quello nuovo.
• Non riesci ad aggiungere il bot a un server — Public Bot è disattivato (Passo 5), oppure non hai il permesso "Manage Server" su quel server.

Hai finito

Una volta verificato il token, Beatra configura il tuo bot e ti fornisce un link di invito. Da quel momento, il tuo Custom Bot offre l'intera esperienza Beatra sotto il tuo nome. Per saperne di più su questa funzionalità, leggi Presentiamo Custom Bot.