Telegram (community wrapper)

Descrizione

Wrapper enterprise high-level per il modulo integration_telegram_send (Telegram Bot API ufficiale) che unifica i pattern di messaggistica più usati in workflow business sotto un'unica interfaccia coerente con il pattern community_* del dataset AI scaffold FlowForge. Telegram è la piattaforma di messaging con 900M+ MAU usata massivamente in Italia/Russia/Iran/Brasile per community real-time, alert ops/devops team, bot di customer service, channel broadcast verso audience grosse (broadcast unidirezionale al canale, nessun limite di destinatari come WhatsApp Business — è il use case principale del Telegram bot in contesto enterprise EU). Operations supportate via Bot API: invio di messaggio testuale (sendMessage), invio di foto (sendPhoto con file upload o URL remoto), invio di documento (sendDocument per PDF/XLS allegati), invio di location (sendLocation per geolocation point), invio di voice/audio (sendVoice). Supporto pieno per parse mode MarkdownV2 (l'incarnazione moderna di Telegram con escape stringente di tutti i caratteri speciali *_~`>#+-=|{}.!() per evitare 400 BadRequest, gestito automaticamente dal nodo) e HTML (subset sicuro <b><i><u><s><code><pre><a> più <span class="tg-spoiler"> per spoiler effect). Caption support per foto/video: testo descrittivo che appare sotto il media con stesso parse mode + formatting + emoji. Notifiche silenziose via disable_notification: il messaggio arriva nella chat ma NON triggera la notifica push del dispositivo destinatario, utile per low-priority updates che vuoi tracciare ma non disturbare l'utente di notte ("backup completato OK alle 03:00", "report generato"). Auth via Bot Token (formato 123456789:AAExxxxxxx) ottenuto da @BotFather di Telegram quando si crea il bot. Token stored nel vault integration FlowForge. Multi-bot supportato (un tenant FlowForge che orchestra 5 bot Telegram diversi via integrationLabel). Target chat_id: numerico univoco identificante una chat 1-to-1 con uno user, oppure un group, oppure un channel. Per chat 1-to-1 l'utente DEVE prima aver scritto al bot (limite anti-spam di Telegram, non possiamo iniziare la conversazione cold), per group/channel il bot DEVE essere stato aggiunto come member dall'admin. Rate limit Telegram Bot API: 30 messaggi al secondo per bot in totale, 1 messaggio al secondo per chat individuale, 20 messaggi al minuto per group (cap automatic gestito dal nodo con 429 + retry exponential). Use case: broadcast alert critici a canale ops/sre quando workflow di produzione falliscono o sentinel rileva attacco (formato MarkdownV2 con bot icon custom); notifica end-user su esito ordine e-commerce ("✅ Il tuo ordine #12345 è stato spedito con tracking GLS 9871234567"); invio quotidiano alle 08:00 di report metrico aziendale con foto chart embedded (generata da generateChart upstream) + caption con i top KPI del giorno precedente; notify silent al manager per low-priority updates senza il bip notifica che disturba durante una call ("processo notturno OK alle 02:30, no anomalie"); customer support bidirezionale dove il cliente scrive al bot e un workflow risponde con knowledge base AI suggested + fallback handoff umano via human_review_decision.

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

⬆️ Output del nodo

Campi disponibili nei nodi successivi via $node.<alias>.json.<field>:

• ok
• messageId
• chatId
• date
• mode

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-community_telegram-1",
  "defId": "community_telegram",
  "label": "Telegram (community wrapper)",
  "config": {
    "chatId": "<chatId>",
    "parseMode": "MarkdownV2",
    "disableNotification": false,
    "disableWebPagePreview": false
  }
}

🔗 Nodi correlati nella stessa categoria