Come fare un bot su Telegram con n8n: guida tecnica completa

Creare un bot per Telegram con n8n è un processo estremamente efficiente e ben documentato. A differenza di altre piattaforme, Telegram offre un’API per bot estremamente semplice e ben supportata da n8n tramite nodi nativi.

Ecco una guida tecnica completa per integrare Telegram e n8n, ottimizzando la comunicazione aziendale e i flussi di data.

Architettura di base e Requisiti Tecnici

Per avviare un’automazione su Telegram con n8n, hai bisogno di pochi e chiari elementi:

Un account Telegram Per creare e gestire il bot in totale sicurezza.

Un Bot Telegram Creato tramite il @BotFather, che ti fornirà un Access Token univoco.

n8n La piattaforma di automazione che fungerà da “cervello” del bot.

Credenziali in n8n Un nodo di autenticazione che utilizza l’Access Token per permettere a n8n di parlare con Telegram.

Un Webhook (consigliato) Per ricevere messaggi in tempo reale, il bot deve inviare gli aggiornamenti a un URL pubblico di n8n.

Infrastruttura Cloud/Server La tua istanza n8n deve essere raggiungibile pubblicamente via HTTPS.

Come configurare n8n (Passo dopo passo)

1. Ottenere le credenziali da Telegram (lato BotFather)

Apri Telegram e cerca l’utente @BotFather.
Avvia una chat e invia il comando /newbot.
Scegli un Nome per il bot (come apparirà ai contatti) e un Username (che deve terminare in bot, ad esempio MioAssistenteBot).
Una volta creato, @BotFather ti fornirà un token di accesso (es. 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11). Conservalo in un luogo sicuro, è la chiave del tuo bot.
(Opzionale) Per inviare messaggi a un gruppo o canale, avrai bisogno del suo Chat ID. Puoi ottenerlo inviando un messaggio al bot e poi chiamando l’API getUpdates o usando bot come @getmyid_bot.

2. Configurare le credenziali in n8n

Apri la dashboard di n8n.
Vai su Credenziali > Nuovo e cerca Telegram API (o Telegram).
Inserisci l’Access Token che hai ottenuto da @BotFather nel campo Access Token (o Bot Token).
Salva la credenziale. Ora n8n è autorizzato ad agire per conto del tuo bot.

3. Costruire il workflow in n8n

L’integrazione si basa su due nodi principali:

Flusso A: Ricevere messaggi (Trigger)
Per far sì che il tuo workflow parta quando un utente scrive al bot, usi il nodo Telegram Trigger.

Aggiungi un nodo Telegram Trigger al tuo workflow.
Seleziona la Credenziale Telegram che hai appena creato.
Scegli l’Evento che attiverà il workflow. L’evento più comune è Message, che si attiva per qualsiasi nuovo messaggio (testo, foto, sticker, ecc.).
Nota sulla pubblicazione: Telegram permette di registrare un solo webhook per bot. Per testare, n8n fornisce un URL di test. Quando il workflow è in produzione, assicurati di aver pubblicato il workflow per usare l’URL di produzione.

Flusso B: Inviare messaggi (Azione)
Per inviare un messaggio (testo, foto, audio, ecc.) da n8n a un utente, usi il nodo Telegram.

Aggiungi un nodo Telegram al tuo workflow.
Seleziona la stessa Credenziale Telegram.
Scegli l’Operazione. Le più comuni sono Send Message (per inviare testo) o Send Photo.
Nel campo Chat ID, inserisci l’ID della chat a cui inviare il messaggio. Puoi ottenerlo dal nodo di trigger (es. {{ $json.message.chat.id }}) o inserirlo manualmente.
Compila il campo Text o altri campi in base al tipo di messaggio che vuoi inviare.

Tabella delle Operazioni Principali

Nodo	Funzione	Operazioni Chiave
Telegram Trigger	Ricevere eventi da Telegram	Message (testo, foto, ecc.), Edited Message, Channel Post, Callback Query
Telegram (Azione)	Eseguire azioni su Telegram	Send Message, Send Photo, Send Audio, Send Animation, Edit Message, Delete Message, Pin Message

Esempi di Automazione e Strategie Avanzate

1. Assistente Clienti AI (Text & Voice)

Flusso:

Telegram Trigger (messaggio) → Switch (per distinguere testo da voce) → Per voce: Telegram (Get File) → OpenAI (trascrizione) → Per testo: passa direttamente → AI Agent (LangChain o OpenAI) per generare risposta → Telegram (Send Message) per rispondere.

Vantaggio:

L’utente può scrivere o inviare un vocale, e il sistema risponde in modo intelligente e contestuale.

2. Sistema di Allerta e Notifiche Aziendali

Flusso:

Webhook (da un sistema esterno come un monitoraggio server) → Set (per formattare il messaggio) → Telegram (Send Message) → Respond to Webhook (per confermare la ricezione).

Vantaggio:

Centralizza gli alert di CI/CD, monitoraggio, CRM o qualsiasi altro strumento in un’unica chat di gruppo.

3. Bot di Gestione Lead e Ordini

Flusso:

Telegram Trigger (messaggio) → IF (verifica se il messaggio contiene parole chiave come “ordine” o “preventivo”) → Google Sheets o CRM (per salvare i dati) → Telegram (Send Message) (per confermare la ricezione all’utente).

Vantaggio:

Automatizza la raccolta dati e il primo contatto, riducendo i tempi di risposta a zero.

Punti critici e considerazioni sulla sicurezza

Webhook HTTPS: Telegram richiede che l’URL del webhook sia servito su HTTPS. Se la tua istanza n8n è in locale, devi esporla con un tunnel (come ngrok) che fornisca un URL HTTPS.
Variabile WEBHOOK_URL: Se n8n è dietro un reverse proxy (es. Nginx), devi configurare la variabile d’ambiente WEBHOOK_URL con l’URL pubblico della tua istanza per far funzionare correttamente i webhook.
Websocket: Per il testing del nodo Telegram Trigger, assicurati che il tuo reverse proxy supporti i websocket, altrimenti il nodo potrebbe rimanere in attesa.
Un webhook per bot: Telegram permette un solo webhook per bot. Per testare in sicurezza senza interrompere la produzione, crea un bot di test separato con @BotFather o metti in pausa il workflow di produzione durante i test.
Gestione dei Token: L’Access Token è la chiave del tuo bot. Non condividerlo mai pubblicamente (es. su GitHub) e utilizza le credenziali sicure di n8n per gestirlo.

Non riesci a configurare il tuo bot?

L’automazione può sembrare complessa all’inizio, ma non devi farlo da solo. Il nostro team di esperti può progettare, sviluppare e mantenere il tuo assistente virtuale su misura per la tua azienda.

Contattaci su WhatsApp