Come ospitare un bot Discord 24/7

​

Introduzione

​

Prerequisiti

• Account Square Cloud: Registrati tramite la pagina di registrazione usando la tua email.
• Piano attivo: Garantisce risorse dedicate e prestazioni ottimizzate per la tua applicazione. Consulta i nostri piani disponibili e scegli quello più adatto alle tue esigenze.

​

Creare il progetto

​

Applicazione bot su Discord

Crea l'applicazione

Accedi al Developer Portal e clicca su “New Application”. Definisci un nome per il tuo bot e clicca su “Create” per creare l’applicazione.

Genera il token

Dopo aver creato l’applicazione, vai alla scheda “Bot” e clicca su “Reset Token” per generare il token di autenticazione. Copialo: lo imposterai come variabile d’ambiente su Square Cloud, mai nel tuo codice.

Attiva i privileged intent

Il bot di esempio legge il testo dei messaggi, quindi ha bisogno del Message Content Intent. Rimani nella scheda “Bot”, scorri verso il basso fino a “Privileged Gateway Intents” e attiva Message Content Intent. Questo esempio non ha bisogno degli altri due privileged intent (Presence e Server Members).

​

Sviluppare il bot

npm init -y

npm install discord.js

const { Client, Events, GatewayIntentBits } = require("discord.js");

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    // Privileged: turn on "Message Content Intent" in the Developer Portal
    GatewayIntentBits.MessageContent,
  ],
});

client.once(Events.ClientReady, (readyClient) => {
  console.log(`Logged in as ${readyClient.user.tag}`);
});

client.on(Events.MessageCreate, (message) => {
  if (message.author.bot) return;
  if (message.content === "!hello") {
    message.reply("Hello!");
  }
});

// The token comes from the DISCORD_TOKEN environment variable
client.login(process.env.DISCORD_TOKEN);

pip install discord.py

import os

import discord
from discord.ext import commands

intents = discord.Intents.default()
# Privileged: turn on "Message Content Intent" in the Developer Portal
intents.message_content = True

bot = commands.Bot(command_prefix="!", intents=intents)


@bot.event
async def on_ready():
    print(f"Logged in as {bot.user}")


@bot.command()
async def hello(ctx):
    await ctx.reply("Hello!")


# The token comes from the DISCORD_TOKEN environment variable
bot.run(os.environ["DISCORD_TOKEN"])

discord.py

​

Configurare Square Cloud

DISPLAY_NAME=My Discord Bot
MAIN=index.js
MEMORY=512
VERSION=recommended
AUTORESTART=true

DISPLAY_NAME=My Discord Bot
MAIN=main.py
MEMORY=512
VERSION=recommended
AUTORESTART=true

• MAIN è il file che Square Cloud esegue, e MEMORY è la RAM del bot in MB. I bot richiedono almeno 256 MB; 512 MB lasciano spazio per crescere.
• AUTORESTART=true riavvia il bot se va in crash. Consulta come funziona il riavvio automatico.
• Non c’è SUBDOMAIN: un bot non serve pagine web.

​

Impostare il token del bot

• Dashboard: nella pagina di upload, apri Configurazione avanzata e aggiungi una variabile chiamata DISCORD_TOKEN con il tuo token come valore. Per un bot già pubblicato, aggiungila nella pagina Variabili d’ambiente dell’applicazione e riavvia il bot.
• CLI: subito dopo aver caricato il bot (vedi Deploy e verifica), impostala con squarecloud app env set e riavvia il bot:

squarecloud app env set DISCORD_TOKEN=your_token_here
squarecloud app restart

​

Cosa mettere nello ZIP

• Il file principale (index.js o main.py) e gli altri file sorgente.
• package.json o requirements.txt.
• squarecloud.app.

​

Deploy e verifica

​

Tramite dashboard

1

Accedi alla pagina di upload

Accedi alla pagina di upload e carica il file zip del tuo progetto.

2

Configura il tuo ambiente

Dopo aver caricato il tuo zip, dovrai configurare il nome, il file principale o il runtime environment e altre impostazioni per il tuo progetto.
Se stai caricando un progetto web, assicurati di selezionare “Web Publication” e di impostare un sottodominio per il tuo progetto.

3

Esegui il deploy del tuo progetto

Infine, clicca sul pulsante “Deploy” per ospitare il tuo progetto su Square Cloud.
Dopo il deploy, puoi monitorare lo stato e i log del tuo progetto dalla dashboard.

4

Conferma che la tua app sia online

Il primo deploy richiede di solito meno di un minuto. Nella dashboard, attendi che lo stato della tua applicazione mostri “in esecuzione” e controlla i log per eventuali errori di avvio.
Se hai fatto il deploy di un sito web o di un’API, apri https://<tuo-sottodominio>.squareweb.app nel tuo browser: dovresti vedere la tua applicazione rispondere. Se hai fatto il deploy di un bot, invia un comando per confermare che sia online.

La tua app non si avvia? Consulta la guida alla risoluzione dei problemi per le cause più comuni e le relative soluzioni.

​

Tramite CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

Invitare il bot nel tuo server

1. Accedi al Developer Portal e seleziona il tuo bot.
2. Vai alla scheda “OAuth2” e poi su “OAuth2 URL Generator”.
3. In “Scopes”, seleziona l’opzione “bot”.
4. In “Bot Permissions”, seleziona solo ciò che serve all’esempio: View Channels, Send Messages e Read Message History. Evita Administrator: i bot ne hanno bisogno raramente, e un token trapelato controllerebbe allora l’intero server.
5. Copia l’URL generato, aprilo nel browser e aggiungi il bot al tuo server. L’URL assomiglia a questo:

https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=68608&scope=bot

​

Errori comuni

​

An invalid token was provided

​

Used disallowed intents

​

Il bot è online ma non risponde a !hello

​

Prossimi passi

​

Contattaci