Come creare un Bot Telegram

In questa guida vedremo insieme i passaggi per creare un bot Telegram personale, che potremo poi utilizzare per ricevere notifiche automatizzate, per esempio tramite UptimeKuma o Apprise.

Non è richiesta alcuna conoscenza di programmazione, seguiremo i passaggi per ottenere le credenziali necessarie e vedremo un semplice esempio pratico per inviare un messaggio.

1. Creare il bot con BotFather

• Aprite Telegram sul vostro dispositivo preferito.
• Cercate il bot @BotFather (come se fosse un normalissimo contatto) ed avviatelo.
• Aprite la mini-app premendo sul pulsante Open a sinistra della casella di testo.
• Selezionate Create a New Bot.

• Compilate i dati relativi al vostro bot in questa schermata:
  • (opzionale) caricate una foto da associare al bot.
  • in Bot Name indicate un nome da dare al bot. Questo verrà visualizzato in chat e sulle notifiche.
  • (opzionale) in About indicate una descrizione di cosa fa il bot.
  • nell'ultimo campo, accanto a t.me/ indicate l'username per il bot. Questo dovrà essere univoco, e dovrà terminare tassativamente in bot.

• BotFather vi comunicherà quindi il Bot Token da usare per inviare messaggi tramite questo bot. Copiatela tramite il pulsante apposito e tenetela da parte per quando ci servirà dopo.

Adesso che abbiamo un Bot Token, abbiamo un "account" di Telegram da cui inviare i messaggi. Tuttavia, abbiamo bisogno di un modo per comunicare a questo bot a chi deve inviare i messaggi. Per fare ciò, avremo bisogno del Chat ID dell'utente a cui vogliamo inviare il messaggio.

2. Ottenere il vostro Chat ID

Al momento della scrittura di questa guida, non è possibile ottenere il proprio Chat ID tramite strumenti ufficiali di Telegram. Utilizzeremo quindi un bot creato da sviluppatori di terze parti, al fine di ottenere questo dato.

• Cercate e scrivete al bot @RawDataBot
• Nel messaggio JSON che riceverete in risposta, copiate il valore di message → chat → id

Questo è l'ID univoco che identifica il vostro utente Telegram, e che dovrete indicare per dire al vostro bot che dovrà scrivere a voi.

3. Scrivere al bot la prima volta

Una volta creato il bot e ottenuto il vostro Chat ID, dobbiamo "attivare" il bot scrivendogli la prima volta. Questo perché per motivi di privacy, Telegram consente ai bot di inviare messaggi agli utenti solo se questi hanno avviato una conversazione con il bot.

Cercate quindi il vostro bot indicando "@" seguito dall'username che avete dato al bot e premete su "START".

Non riceverete nessuna risposta dal bot, perchè non c'è alcun programma che sta "ascoltando" i messaggi che vengono ricevuti, ma

4. Inviare un messaggio di prova

Ora che abbiamo tutte le informazioni necessarie (il Bot Token e il nostro Chat ID), possiamo finalmente inviare un messaggio di prova.

L'API dei bot di Telegram è basata su HTTP e può essere utilizzata con qualsiasi strumento in grado di effettuare richieste web. Per questo esempio, useremo curl, un comune strumento a riga di comando disponibile su quasi tutti i sistemi operativi.

Aprite un terminale e incollate il seguente comando, sostituendo <BOT_TOKEN> e <CHAT_ID> con i valori che avete ottenuto in precedenza:

curl -s -X POST https://api.telegram.org/bot<BOT_TOKEN>/sendMessage -d chat_id=<CHAT_ID> -d text="Ciao!"

Se tutto è stato configurato correttamente, riceverete immediatamente il messaggio "Ciao!" dal vostro bot su Telegram.

Analizziamo il comando:

• curl: è il programma che stiamo usando per la richiesta.
• -s: silenzia l'output di curl, mostrerà solo il risultato della richiesta.
• -X POST: specifica che stiamo effettuando una richiesta di tipo POST.
• https://api.telegram.org/bot<YOUR_BOT_TOKEN>/sendMessage: questo è l'indirizzo (endpoint) a cui inviamo la nostra richiesta. Come vedete, include il nostro token per autenticare il bot. sendMessage è il metodo specifico per inviare messaggi.
• -d chat_id=<YOUR_CHAT_ID>: con questo parametro indichiamo a chi deve essere inviato il messaggio.
• -d text="...": qui specifichiamo il testo del messaggio da inviare.

Conclusioni

Congratulazioni! Avete creato con successo un bot Telegram e avete inviato il vostro primo messaggio, ma questo è solo l'inizio.

Ora potete integrare questo sistema in script, applicazioni (come UptimeKuma) o sistemi di domotica (come Home Assistant) per ricevere notifiche personalizzate per qualsiasi evento desideriate.

L'API di Telegram è molto potente e supporta l'invio di immagini, documenti, la creazione di comandi personalizzati e molto altro.