Programmare un bot Discord personalizzato con discord.py

Q: Il bot è offline: cosa devo controllare per prima cosa?

Controlla che il token sia configurato correttamente nella variabile d'ambiente DISCORD_TOKEN e verifica se nei log del servizio compare un messaggio di errore.

Q: I comandi slash non vengono visualizzati: perché?

Dopo tree.sync(), i comandi registrati globalmente possono impiegare fino a un'ora per comparire su Discord. Per testarli, puoi sincronizzarli direttamente con un singolo server: saranno subito disponibili.

Crea passo dopo passo il tuo bot Discord con Python e discord.py e distribuiscilo su ZapX.

10 novembre 20263 min di lettura0 Visualizzazioni0 utile

Introduzione

In questa guida creerai da zero il tuo bot Discord con Python e la libreria discord.py. Registrerai l'applicazione del bot nel Discord Developer Portal, scriverai una struttura di base funzionante con un comando slash personalizzato e infine distribuirai il bot su ZapX Discord Bot Hosting. Conoscere le basi di Python può essere utile, ma non è indispensabile.

Preparazione

Prima di iniziare a scrivere il codice, ti serve un'applicazione bot su Discord:

Apri il Discord Developer Portal e fai clic su New Application. Scegli un nome per il bot.
Nel menu a sinistra, vai alla scheda Bot. Qui trovi il token del bot facendo clic su Reset Token. Copialo e conservalo in un luogo sicuro: consente l'accesso completo al bot e non deve mai essere condiviso pubblicamente né inserito nel codice.
Nella stessa pagina, sotto Privileged Gateway Intents, attiva Message Content Intent se il bot deve reagire al contenuto dei messaggi (ad esempio, per i comandi testuali).
Vai alla scheda OAuth2 → URL Generator. Seleziona lo scope bot e anche applications.commands (per i comandi slash), quindi imposta le autorizzazioni necessarie al bot e apri il link generato per invitarlo sul tuo server Discord.

Scrivere il bot in Python

Per prima cosa, installa discord.py nel tuo ambiente di sviluppo:

bash

pip install -U discord.py

Crea un file main.py e imposta la struttura di base del bot:

python

import os
import discord
from discord import app_commands

intents = discord.Intents.default()
intents.message_content = True

client = discord.Client(intents=intents)
tree = app_commands.CommandTree(client)


@client.event
async def on_ready():
    await tree.sync()
    print(f"Bot ist online als {client.user}")


@tree.command(name="hallo", description="Begrüßt dich mit einer kurzen Nachricht")
async def hallo(interaction: discord.Interaction):
    await interaction.response.send_message(f"Hallo {interaction.user.mention}!")


client.run(os.environ["DISCORD_TOKEN"])

In questo esempio, il token non viene inserito direttamente nel codice, ma viene letto dalla variabile d'ambiente DISCORD_TOKEN (os.environ["DISCORD_TOKEN"]). In questo modo il token resta fuori dal codice, ed è possibile procedere con la distribuzione descritta più avanti.

Se vuoi anche reagire all'ingresso di nuovi membri nel server, ad esempio inviando un messaggio di benvenuto, aggiungi un altro gestore di eventi:

python

@client.event
async def on_member_join(member: discord.Member):
    channel = discord.utils.get(member.guild.text_channels, name="willkommen")
    if channel:
        await channel.send(f"Willkommen auf dem Server, {member.mention}!")

Distribuire il bot su ZapX Discord Bot Hosting

Crea un nuovo servizio Discord Bot nel pannello clienti ZapX, se non l'hai già fatto.
Durante la configurazione, seleziona Python 3.12 come runtime.
Carica main.py (e, se disponibile, un file requirements.txt con eventuali pacchetti aggiuntivi) nella directory del servizio tramite il file manager integrato o caricando il file.

Inserisci il token del bot che hai creato in precedenza nella scheda Impostazioni, alla voce Configurazione bot → Discord Bot Token, e salva le impostazioni. In questo modo il token resta separato dal codice e non dovrai modificarlo quando carichi di nuovo i file. Nel codice, il valore sarà comunque disponibile come variabile d'ambiente DISCORD_TOKEN.

Impostazioni di ZapX Discord Bot con il campo del token

5. Avvia il servizio. Se tutto funziona correttamente, nei log vedrai il messaggio Bot ist online als ... e il bot risulterà "Online" sul tuo server Discord.

Risoluzione dei problemi

Il bot risulta offline: controlla che il token sia configurato correttamente nella variabile d'ambiente DISCORD_TOKEN e verifica se nei log del servizio compare un messaggio di errore.

I comandi slash non vengono visualizzati: dopo tree.sync(), i comandi registrati globalmente possono impiegare fino a un'ora per comparire su Discord. Per testarli, puoi sincronizzarli direttamente con un singolo server: saranno subito disponibili.

Errore "Missing Access" o altri errori di autorizzazione: il bot non dispone delle autorizzazioni necessarie sul server. Controlla i permessi dei ruoli del bot e verifica di aver selezionato le autorizzazioni corrette nell'URL Generator di OAuth2 durante l'invito.

Conclusione

Ora hai creato un bot Discord funzionante con discord.py, lo hai dotato di un comando slash personalizzato e lo hai distribuito su ZapX Discord Bot Hosting. Da qui puoi ampliarlo con altri comandi, funzioni di moderazione o integrazioni.

FAQ

Domande frequenti

Un'applicazione bot nel Discord Developer Portal: crea una New Application, recupera il token nella scheda Bot con 'Reset Token' e genera il link d'invito nel generatore di URL OAuth2 selezionando gli scope 'bot' e 'applications.commands'.

Il token non va inserito direttamente nel codice: viene letto dalla variabile d'ambiente DISCORD_TOKEN ('os.environ["DISCORD_TOKEN"]'). Su ZapX Discord Bot Hosting, inseriscilo nella scheda Impostazioni, alla voce Configurazione bot -> Discord Bot Token.

Python 3.12.

Feedback

Questo articolo ti è stato utile?

Il tuo feedback ci aiuta a definire le priorità e a migliorare i contenuti.

0 di 0 I feedback hanno giudicato utile questo articolo.

Assistenza personale

Le istruzioni non sono sufficienti?

Il supporto ZAP conosce il tuo prodotto: descrivi brevemente la tua richiesta e ti aiuteremo personalmente.

Quali 🍪 cookie desideri consentire?

Programmare un bot Discord personalizzato con discord.py

Introduzione

Preparazione

Scrivere il bot in Python

Distribuire il bot su ZapX Discord Bot Hosting

Risoluzione dei problemi

Conclusione

Domande frequenti

Bot Discord

Preparazione

Scrivere il bot in Python

Distribuire il bot su ZapX Discord Bot Hosting

Risoluzione dei problemi

Conclusione

Server di gioco

Server e hosting

ZAPX

Risorse

ZAP-Hosting