🇮🇹 IT

✈️ Telegram Message

Invia un messaggio a una chat, gruppo o canale Telegram utilizzando la Telegram Bot API. Richiede un token bot creato tramite BotFather e il chat ID della conversazione di destinazione.

Categoria: Notifiche e Messaggistica · Identificatore tipo: telegram_message

Panoramica

Il nodo Telegram Message chiama l'endpoint sendMessage della Telegram Bot API per consegnare un messaggio di testo a qualsiasi chat, gruppo o canale a cui il tuo bot è stato aggiunto. I messaggi possono essere in testo semplice o formattati utilizzando la sintassi HTML o Markdown supportata nativamente da Telegram.

Hai bisogno di due informazioni prima di usare questo nodo: un token bot da BotFather e il chat ID della conversazione di destinazione. Il bot deve essere membro del gruppo o canale di destinazione prima di poter pubblicare lì.

Configurazione

Campo	Stato	Descrizione
Bot Token	Obbligatorio	Il token della Telegram Bot API da BotFather, es. `123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11`.
Chat ID	Obbligatorio	L'ID della chat, gruppo o canale a cui inviare il messaggio. Per le chat private, è l'ID numerico dell'utente. Per gruppi e canali, è un numero negativo o `@username`.
Message	Obbligatorio	Il testo del messaggio. Supporta i riferimenti `{{ variable }}`. Supporta la formattazione HTML o Markdown in base al Parse Mode.
Parse Mode	Opzionale	`HTML`, `Markdown` o `MarkdownV2`. Controlla come viene interpretata la formattazione nel messaggio. Predefinito: `HTML`.
Disable Notification	Opzionale	Interruttore. Quando attivo, il messaggio viene inviato silenziosamente — il destinatario non riceve alcun suono o avviso di vibrazione. Predefinito: disattivato.
Disable Link Preview	Opzionale	Interruttore. Quando attivo, sopprime la scheda di anteprima link che Telegram normalmente mostra per gli URL nei messaggi. Predefinito: disattivato.

Dati di Output

Dopo l'invio del messaggio, i seguenti campi sono disponibili nell'output del passaggio:

Campo	Tipo	Descrizione
`message_id`	number	ID del messaggio Telegram inviato.
`chat_id`	string	Chat ID a cui il messaggio è stato inviato.
`success`	boolean	True se il messaggio è stato accettato dall'API Telegram.

Esempio di Utilizzo

Aggiungi un nodo Schedule Trigger impostato per eseguire ogni giorno alle 08:00.
Aggiungi un nodo Agent (step key: summarise) che interroga le tue sorgenti dati e produce un testo riassuntivo giornaliero in output.text.
Aggiungi un nodo Telegram Message. Imposta Bot Token sul token del tuo bot, Chat ID sull'ID del gruppo di destinazione e Message su:
<b>Riepilogo Giornaliero</b> {{ summarise.output.text }}
Imposta Parse Mode su HTML.

Suggerimenti e Note

Mantieni privato il tuo token bot. Chiunque abbia il token può inviare messaggi come il tuo bot e leggere gli aggiornamenti che riceve. Conservalo in modo sicuro e non inserirlo mai nel controllo di versione.
Appartenenza del bot. Il bot deve essere membro del gruppo o canale di destinazione prima di poter inviare messaggi. Per i canali, il bot deve avere il permesso di pubblicare messaggi.
Escape HTML. Se usi il parse mode HTML, i valori delle variabili dinamiche contenenti <, > o & devono essere HTML-escaped, altrimenti Telegram rifiuterà il messaggio o lo renderizzerà in modo errato.
Lunghezza del messaggio. La lunghezza massima del messaggio è 4096 caratteri. Dividi contenuti più lunghi su più nodi Telegram Message o riassumi prima dell'invio.
Trovare il chat ID. Invia un messaggio alla chat di destinazione, poi chiama https://api.telegram.org/bot<TOKEN>/getUpdates e cerca il valore chat.id nella risposta.

Nodi Correlati

Discord Message — pubblica su un canale Discord tramite webhook.
Slack Message — pubblica su un canale Slack.
Email Notification — invia tramite email in alternativa.