Come ospitare un bot Telegram 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.

​

Creazione del progetto

​

Applicazione bot su Telegram

Per iniziare

Accedi a Telegram Web e cerca il bot ufficiale BotFather, responsabile della creazione e gestione dei bot sulla piattaforma.

Ottenimento del token di autenticazione

Avvia una conversazione con BotFather e digita /start. Poi, seleziona l’opzione /newbot per creare un nuovo bot. Il sistema ti chiederà un nome per il tuo bot e, dopo la conferma, genererà automaticamente il token di autenticazione necessario.

​

Sviluppo del progetto

npm init -y

npm install grammy

const { Bot } = require("grammy");

// The token comes from the TELEGRAM_BOT_TOKEN environment variable
const bot = new Bot(process.env.TELEGRAM_BOT_TOKEN);

// Reply to every text message with an echo
bot.on("message:text", async (ctx) => {
  await ctx.reply(`${ctx.me.username} responds: ${ctx.message.text}`);
});

// Long polling: the bot asks Telegram for new messages, so no public URL is needed
bot.start({
  onStart: (botInfo) => console.log(`Bot ${botInfo.username} started successfully!`),
});

pip install pyTelegramBotAPI

import os

import telebot

# The token comes from the TELEGRAM_BOT_TOKEN environment variable
bot = telebot.TeleBot(os.environ["TELEGRAM_BOT_TOKEN"])
bot_name = bot.get_me().username


# Echo every message that isn't a command
@bot.message_handler(func=lambda message: not message.text.startswith("/"))
def echo_handler(message):
    bot.reply_to(message, f"{bot_name} responds: {message.text}")


if __name__ == "__main__":
    print(f"Bot {bot_name} started successfully!")
    # Long polling: no public URL is needed
    bot.infinity_polling()

pyTelegramBotAPI

​

Configurare Square Cloud

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

DISPLAY_NAME=My Telegram 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: con il long polling, il bot non ha bisogno di un URL pubblico.

​

Impostare il token del bot

• Dashboard: nella pagina di upload, apri Advanced configuration e aggiungi una variabile chiamata TELEGRAM_BOT_TOKEN con il tuo token come valore. Per un bot già pubblicato, aggiungila nella pagina Environment Variables dell’applicazione e riavvia il bot.
• CLI: subito dopo aver caricato il bot (vedi Distribuzione), impostala con squarecloud app env set e riavvia il bot:

squarecloud app env set TELEGRAM_BOT_TOKEN=your_token_here
squarecloud app restart

​

Distribuzione

​

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

​

Test del bot

​

Risorse aggiuntive

​

Prossimi passi

​

Contattaci