BotFather: creare un bot Telegram per le notifiche

Dalla creazione del bot con BotFather all'integrazione delle notifiche in una qualsiasi applicazione, script o automazione.

1. Crea il bot con BotFather

Apri Telegram e cerca @BotFather (bot ufficiale, verificato con la spunta blu).
Avvia la chat e scrivi /start.
Scrivi /newbot.
BotFather chiede due cose: il nome del bot (può contenere spazi, es. "Il Mio Assistente") e uno username univoco che termini in bot (es. mio_assistente_bot).
Se l'username è libero, BotFather restituisce il token API, nel formato:
```
123456789:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw
```

Attenzione. Il token è come una password: chiunque lo possieda può controllare il bot. Non condividerlo mai pubblicamente.

2. Personalizza il bot (opzionale)

Comando	Funzione
/setdescription	Descrizione mostrata prima che l'utente avvii il bot
/setabouttext	Testo visibile nel profilo del bot
/setuserpic	Immagine del profilo del bot
/setcommands	Lista di comandi disponibili

3. Ottieni il tuo Chat ID

Cerca il tuo bot su Telegram e clicca Avvia (/start).
Invia un messaggio qualsiasi al bot.
Apri nel browser il seguente indirizzo, sostituendo TOKEN con il tuo token:
```
https://api.telegram.org/botTOKEN/getUpdates
```
Nel JSON di risposta cerca "chat":{"id":123456789,...}, quel numero è il tuo chat_id.

4. Invia un messaggio di test

Con curl (riga di comando)

curl -X POST "https://api.telegram.org/botTOKEN/sendMessage" \
  -d chat_id=CHAT_ID \
  -d text="Ciao, sono il tuo bot!"

Con Python

import requests

TOKEN = "il_tuo_token"
CHAT_ID = "il_tuo_chat_id"

def invia_messaggio(testo):
    url = f"https://api.telegram.org/bot{TOKEN}/sendMessage"
    payload = {"chat_id": CHAT_ID, "text": testo}
    r = requests.post(url, data=payload)
    return r.json()

invia_messaggio("Notifica dalla mia applicazione!")

Risultato atteso. Se tutto funziona correttamente, riceverai immediatamente il messaggio.

5. Integrazione in una qualsiasi applicazione

L'API di Telegram è una semplice API REST via HTTP: qualunque linguaggio o piattaforma in grado di eseguire una richiesta POST può utilizzarla.

Esempi pratici

Script Python / Node.js / PHP, basta una chiamata HTTP.
Applicazioni web, la chiamata va fatta dal backend.
Automazioni (Zapier, n8n, Make, IFTTT), molte hanno un connettore Telegram.
Server e monitoraggio, script bash con curl per notifiche di sistema.
App mobile, la chiamata HTTP va fatta dal backend.

Endpoint principali

Endpoint	Uso
sendMessage	Invia un messaggio di testo
sendPhoto	Invia un'immagine
sendDocument	Invia un file/documento
sendMessage + parse_mode	Testo formattato (Markdown o HTML)

Checklist prima di andare in produzione
Il token non è esposto nel codice frontend
Il chat_id è configurato correttamente
Le chiamate HTTP gestiscono gli errori

6. Webhook: ricevere messaggi in tempo reale

Se il bot deve ricevere e rispondere a messaggi, puoi impostare un webhook:

https://api.telegram.org/botTOKEN/setWebhook?url=https://tuoserver.com/webhook

Nota. Se il caso d'uso è solo "invio notifiche", il webhook non è necessario.