Come ospitare bot Telegram

Introduzione

Per sviluppare e ospitare su Square Cloud, è essenziale seguire una sequenza strutturata di configurazioni e prerequisiti. Questa guida tecnica coprirà l’intero processo, dalla configurazione iniziale al deploy in produzione.

Prerequisiti

Account Square Cloud: Registrati tramite la pagina di registrazione usando la tua email.
Piano a pagamento 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

Un account Telegram è essenziale per testare e interagire con il tuo bot. Se non ne hai uno, visita il sito ufficiale di Telegram per creare gratuitamente il tuo account.

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.

Generazione del token del bot Telegram con BotFather

Sicurezza critica: mantieni il token del tuo bot assolutamente segreto. Questo token garantisce il controllo totale sul bot e deve essere trattato come un’informazione confidenziale.

Sviluppo del progetto

La scelta della libreria o del framework dipende dal linguaggio di programmazione che intendi usare. Di seguito trovi alcune delle opzioni più popolari:

Node.js - grammY
Python - telebot

Configurazione dell’ambiente

Verifica che Node.js sia installato sul tuo sistema. In caso contrario, scaricalo dal sito ufficiale di Node.js.
Inizializza un nuovo progetto Node.js:

Terminal

npm init -y

Installa la libreria grammY:

Terminal

npm install grammy

Implementazione di base

Crea il file principale (index.js) con la seguente struttura:

index.js

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

// Authentication token configuration
const token = "YOUR_TOKEN_HERE";

// Bot initialization
const bot = new Bot(token);

(async () => {
  // Get bot information
  const botInfo = await bot.api.getMe();
  const botName = botInfo.username;

  // Define handler for text messages
  bot.on("message:text", async (ctx) => {
    const userMsg = ctx.message.text;
    const responseMsg = `${botName} responds: ${userMsg}`;
    await ctx.reply(responseMsg);
  });

  // Start the bot
  bot.start();
  console.log(`Bot ${botName} started successfully!`);
})();

Configurazione dell’ambiente

Verifica che Python e pip siano installati. In caso contrario, scaricali dal sito ufficiale di Python.
Installa la libreria pyTelegramBotAPI:

Terminal

pip install pyTelegramBotAPI

Implementazione di base

Crea il file principale (main.py):

main.py

import telebot

# Authentication token configuration
TOKEN = "YOUR_TOKEN_HERE"

# Bot initialization
bot = telebot.TeleBot(TOKEN)

# Define handler for non-command messages
@bot.message_handler(func=lambda message: not message.text.startswith('/'))
def echo_handler(message):
    # Get bot information
    bot_info = bot.get_me()
    bot_name = bot_info.username
    # Format response message
    response_msg = f"{bot_name} responds: {message.text}"
    # Reply to the user
    bot.reply_to(message, response_msg)

# Main execution
if __name__ == '__main__':
    bot_info = bot.get_me()
    print(f"Bot {bot_info.username} started successfully!")
    # Start polling
    bot.infinity_polling()

Crea il file requirements.txt per gestire le dipendenze:

requirements.txt

pyTelegramBotAPI

Distribuzione

Dopo aver preparato i file del tuo progetto, puoi ora caricarli su Square Cloud e ospitare il tuo progetto. Per farlo, crea un file ZIP contenente tutti i file del tuo progetto.

Tramite dashboard

Accedi alla pagina di upload

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

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.

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.

Caricamento dell'applicazione su Square Cloud

Tramite CLI

Per utilizzare questo metodo, devi creare un file di configurazione chiamato squarecloud.app nella directory principale del tuo progetto. Questo file conterrà la configurazione necessaria per il tuo progetto.

Scopri di più su: come creare il file di configurazione per Square Cloud.

Il file squarecloud.app è un file di configurazione che verrà utilizzato per configurare la tua applicazione; verrà usato per definire il tuo ambiente.

Installa la CLI

Per prima cosa, devi avere la CLI installata nel tuo ambiente. Se non la hai ancora, esegui il seguente comando nel tuo terminale:

npm install -g @squarecloud/cli

Se la hai già, ti consigliamo di aggiornarla. Per farlo, esegui il seguente comando nel tuo terminale:

Windows
Linux, macOS e WSL

squarecloud update

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

Autenticati

Ora, per autenticarti e utilizzare gli altri comandi della CLI, troverai la tua chiave di autorizzazione qui cliccando su “Request API Key”. Dopo aver ottenuto la tua chiave di autorizzazione, esegui il seguente comando:

squarecloud auth login

Carica il tuo progetto

Infine, per eseguire il deploy della tua applicazione su Square Cloud tramite la CLI, devi eseguire il seguente comando:

squarecloud upload

Oppure, se hai creato lo zip manualmente, puoi usare:

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

Test del bot

Dopo una distribuzione riuscita, individua il tuo bot su Telegram e invia un messaggio di test. Il bot dovrebbe rispondere ripetendo il tuo messaggio, confermando il corretto funzionamento dell’implementazione.

Risorse aggiuntive

Per approfondire le tue conoscenze sullo sviluppo di bot Telegram, consulta la documentazione ufficiale di pyTelegramBotAPI. La documentazione offre guide dettagliate, tutorial avanzati e un riferimento completo alle API.

Contattaci

Se continui a riscontrare difficoltà tecniche, il nostro team di supporto specializzato è disponibile ad assisterti. Contattaci e saremo felici di aiutarti a risolvere qualsiasi problema.

​Introduzione

​Prerequisiti

​Creazione del progetto

​Applicazione bot su Telegram

​Sviluppo del progetto

​Distribuzione

​Tramite dashboard

​Tramite CLI

Scopri di più su: come creare il file di configurazione per Square Cloud.

​Test del bot

​Risorse aggiuntive

​Contattaci

Introduzione

Prerequisiti

Creazione del progetto

Applicazione bot su Telegram

Sviluppo del progetto

Distribuzione

Tramite dashboard

Tramite CLI

Test del bot

Risorse aggiuntive

Contattaci