Come creare un bot Telegram
Come creare un bot Telegram con @BotFather: il comando /newbot, il nome e un username che finisce in bot, il token e come proteggerlo, i comandi, i pulsanti e dove far girare il codice del bot.
Un bot Telegram si crea in una chat con il bot ufficiale @BotFather: inviagli /newbot, dai un nome al bot e scegli un username che finisce in bot. BotFather risponde con un token, la chiave con cui il tuo programma controlla il bot. Creare un bot non costa nulla: Telegram non fa pagare né gli utenti né gli sviluppatori per la piattaforma dei bot. Ma BotFather si limita a registrare il bot. Perché risponda a qualcuno serve un programma in esecuzione sul tuo computer o su un server.
Come creare un bot in BotFather
- Apri @BotFather e tocca Avvia.
- Invia il comando
/newbot. - Inserisci il nome del bot, cioè il nome che viene mostrato.
- Inserisci lo username, l'indirizzo del bot, come
@mio_negozio_bot. Deve avere da 5 a 32 caratteri, solo lettere latine, cifre e trattini bassi, e finire inbot. - BotFather ti invia il token. Ora il bot esiste.
Il nome si può cambiare in seguito con /setname, ma secondo la documentazione di Telegram lo username non si può cambiare dopo la creazione: sceglilo con cura.
Il token: cos'è e come tenerlo al sicuro
Un token è fatto di cifre e lettere separate da due punti. Chi lo possiede controlla completamente il bot, quindi il consiglio di Telegram è di conservarlo in un posto sicuro e di condividerlo solo con chi ha bisogno di un accesso diretto.
- Non mettere mai il token in codice pubblico, su GitHub o nelle chat.
- Se trapela, la documentazione di Telegram indica il comando
/tokenin BotFather per generarne uno nuovo. Poi aggiornalo ovunque lo usi il tuo programma. - Il token è solo per i bot.
api_ideapi_hashsono chiavi diverse, per i programmi che accedono come utente.
Cosa configurare in BotFather
/mybots apre un menu interattivo con le impostazioni dei tuoi bot; lo stesso è disponibile nella Mini App di BotFather. L'aspetto del bot si può impostare anche con comandi separati:
/setname— il nome del bot./setdescription— la descrizione del bot, un breve testo fino a 512 caratteri./setabouttext— le informazioni «Info», un testo più breve fino a 120 caratteri./setuserpic— l'immagine del profilo del bot./setcommands— l'elenco dei comandi; Telegram li suggerisce quando qualcuno digita/./setjoingroups— se il bot può essere aggiunto ai gruppi./setprivacy— quali messaggi riceve il bot nei gruppi./deletebot— elimina il bot e libera il suo username.
Far rispondere il bot
Un bot è un programma che parla con Telegram tramite la Bot API. Ogni richiesta va a https://api.telegram.org/bot<token>/METHOD. Ci sono due modi per ricevere i messaggi, e si escludono a vicenda:
- getUpdates (long polling): il tuo programma chiede a Telegram i nuovi messaggi. È il modo più facile per iniziare: non serve un indirizzo pubblico.
- Webhook: Telegram invia i messaggi al tuo server. Servono HTTPS e una delle porte 443, 80, 88 o 8443.
Il codice si può scrivere in qualsiasi linguaggio che sappia fare richieste HTTP. Tra le librerie più diffuse ci sono aiogram e python-telegram-bot per Python, grammY e Telegraf per JavaScript. Il tutorial ufficiale percorre un bot in Java: da BotFather a «Hello World». Puoi far girare il bot sul tuo computer finché è acceso, oppure su un VPS perché funzioni giorno e notte.
Pulsanti e comandi in un bot
- I comandi sono parole come
/startche il bot gestisce; l'elenco dei suggerimenti si imposta con/setcommands. - I pulsanti inline sotto un messaggio non inviano testo alla chat: inviano al bot una pressione o aprono un link.
- Le tastiere di risposta mostrano risposte già pronte al posto della tastiera abituale.
- Le Mini App sono interfacce complete che si aprono dentro Telegram.
Maggiori informazioni nella panoramica delle funzioni dei bot.
I pagamenti in un bot
I beni e i servizi digitali nei bot si pagano con le Stelle di Telegram: la fattura usa la valuta XTR e non serve alcun fornitore di pagamenti. Le Stelle raccolte dal bot si prelevano tramite Fragment: come prelevare le Stelle da un bot.
Ti serve che il tuo programma acquisti Stelle o Premium per i suoi utenti? Il bot Shiba Bank ha un'API apposta: documentazione dell'API.
Domande frequenti
Come creo un bot Telegram senza programmare?
Puoi registrare un bot in un minuto con @BotFather, ma per fargli fare qualcosa serve del codice. Lo stesso Telegram osserva che creare un bot richiede almeno qualche competenza di programmazione.
Quanto costa creare un bot Telegram?
Niente: Telegram non fa pagare né gli utenti né gli sviluppatori per la piattaforma dei bot. Paghi solo il tuo server, se ci ospiti il bot.
Cos'è BotFather?
Il bot ufficiale di Telegram per creare i bot e gestirli: nome, descrizione, immagine, comandi e token.
Come ottengo il token di BotFather?
Il token arriva subito dopo /newbot. Se trapela, il comando /token in BotFather ne emette uno nuovo.
Che username può avere un bot?
Da 5 a 32 caratteri: lettere latine, cifre e trattini bassi, e deve finire in bot, per esempio mio_negozio_bot.
Come aggiungo i pulsanti a un bot Telegram?
I pulsanti si definiscono nel codice del bot: pulsanti inline sotto un messaggio e tastiere di risposta. L'elenco dei comandi per il menu / si imposta in BotFather con /setcommands.
