Integrazione Telegram | Botpress Hub

L'integrazione Telegram consente ai chatbot e agli agenti AI di Botpress di comunicare con gli utenti su Telegram tramite l'API ufficiale Telegram Bot. Permette una messaggistica bidirezionale in tempo reale, supportando testo, media, pulsanti e comandi interattivi sia nelle chat private che nei gruppi.

A livello tecnico, l'integrazione utilizza Telegraf, un solido framework Node.js, per gestire l'instradamento dei messaggi, i comandi e gli eventi provenienti da Telegram. I messaggi inviati dal tuo agente AI vengono automaticamente convertiti dal formato Markdown alla sintassi HTML supportata da Telegram, garantendo una visualizzazione perfetta di testo, link e formattazione.

Grazie a strumenti integrati per la sanitizzazione dei messaggi e gli indicatori di digitazione, questa integrazione assicura comunicazioni pulite, sicure e reattive per gli utenti finali. Gli sviluppatori possono utilizzarla per automatizzare aggiornamenti, gestire ticket o estendere i propri chatbot nelle community Telegram con una configurazione minima.

The Telegram integration allows your AI-powered chatbot to seamlessly interact with Telegram, a popular messaging platform with a large user base. Connect your chatbot to Telegram and engage with your audience in real-time conversations. With this integration, you can automate customer support, provide personalized recommendations, send notifications, and handle inquiries directly within Telegram. Leverage Telegram's rich features, including text messages, inline buttons, media files, and more, to create dynamic and interactive chatbot experiences. Empower your chatbot to deliver exceptional user experiences on Telegram with the Telegram Integration for Botpress.

## Migrating from version `0.x.x` to `1.x.x`

### Removal of proactive conversations (and proactive users)

- Telegram does not currently support proactive conversations, so any bots using this feature will need to be updated to use the normal conversation flow.

### Removal of dedicated Markdown messages type

- The `markdown` channel message type is being deprecated in favor of integrating this behavior into the base `text` message type.
- This new Markdown behavior (commonmark spec) will allow image Markdown. However, since Telegram does not support mixed message types, it will split the message into multiple messages with images sent in between text messages.

### Addition of message limits

- Telegram has a message length limit of 4096 characters, so that limit has been added to the text parameter in the `text` message payload. Going over this limit will result in the message being rejected.

Domande frequenti

Cos'è l'integrazione Telegram di Botpress e come funziona?

L'integrazione Telegram di Botpress collega un chatbot o agente AI di Botpress all'API ufficiale Telegram Bot, così le conversazioni possono avvenire direttamente nelle chat di Telegram. In background, l'integrazione utilizza il Botpress SDK insieme al framework Telegraf per ricevere aggiornamenti da Telegram e inviare risposte in tempo reale. I messaggi in arrivo da Telegram vengono normalizzati in eventi Botpress, così l'agente può applicare policy, recupero di conoscenza e flussi di lavoro come su qualsiasi altro canale. I messaggi in uscita vengono convertiti dal formato interno di Botpress in payload compatibili con Telegram, inclusi testo, pulsanti inline e media dove previsto. Una volta configurata con un Bot Token e una Webhook URL, l'integrazione gestisce le chiamate API di basso livello e i tentativi di invio, permettendo ai team di concentrarsi sulla progettazione delle conversazioni senza preoccuparsi delle richieste HTTP.

Come si configura l'integrazione Telegram in Botpress dall'inizio alla fine?

La configurazione dell'integrazione parte da Telegram, creando un bot tramite BotFather che genera un Bot Token per accedere all'API Telegram Bot. In Botpress Studio, l'integrazione Telegram viene installata dall'Hub e poi configurata inserendo questo Bot Token nelle impostazioni dell'integrazione. La schermata di configurazione offre opzioni semplici come Abilitato (per attivare o disattivare la comunicazione), Webhook URL (dove Telegram invia gli aggiornamenti) e il campo token che autorizza l'integrazione. Una volta salvata la configurazione, Botpress registra il webhook e inizia ad ascoltare i nuovi aggiornamenti, così ogni messaggio inviato al bot Telegram appare come evento di conversazione nel progetto Botpress. Da quel momento, flussi, policy e agenti AI operano sulle conversazioni Telegram esattamente come su webchat o altri canali, garantendo un'architettura coerente su tutta la piattaforma.

Quali funzionalità e tipi di messaggi supporta l'integrazione Telegram per chatbot e agenti AI?

L'integrazione Telegram supporta i messaggi di testo standard insieme a molte delle funzionalità avanzate tipiche di Telegram, come pulsanti inline e allegati multimediali. I messaggi generati da un agente AI di Botpress vengono mappati nei tipi di messaggi di Telegram, così possono includere pulsanti interattivi, flussi in stile risposta rapida e link che rispettano le regole di formattazione di Telegram. Gli indicatori di digitazione sono disponibili tramite Card specifiche dell'integrazione, permettendo al bot di segnalare che sta scrivendo una risposta e offrire un'esperienza chat più naturale agli utenti. L'integrazione espone anche tag su conversazioni e utenti, come l'ID conversazione o utente Telegram, così gli sviluppatori avanzati possono collegare le identità Telegram a record CRM o sistemi interni. Insieme, queste funzionalità rendono l'integrazione Telegram adatta a supporto clienti, notifiche proattive (nei limiti di Telegram), gestione di community e scenari di recupero automatico di informazioni.

Come gestisce l'integrazione Telegram di Botpress Markdown, HTML e la formattazione dei messaggi in modo sicuro?

Telegram supporta modalità di formattazione specifiche come HTML e Markdown, ma è molto restrittivo su quali tag e caratteri sono consentiti. Per garantire una formattazione affidabile, l'integrazione utilizza una pipeline di elaborazione Markdown basata su markdown-it per trasformare i contenuti Botpress in HTML compatibile con Telegram, e si affida a sanitize-html per rimuovere o escludere tag e attributi non sicuri prima dell'invio. Questo approccio assicura che titoli, testo in grassetto, link ed elenchi vengano visualizzati correttamente senza rompere i messaggi o esporre gli utenti a HTML non attendibile. Inoltre, l'integrazione rispetta i limiti di Telegram su contenuti misti e lunghezza dei messaggi, suddividendo testo e immagini in più messaggi quando necessario, così anche i contenuti complessi di un agente AI appaiono ordinati nel client Telegram. In questo modo, i team possono progettare contenuti ricchi in Markdown su Botpress mentre l'integrazione gestisce tutte le particolarità di formattazione richieste da Telegram.

Quali sono gli utilizzi più comuni di un chatbot o agente AI Botpress su Telegram?

Un agente AI collegato a Telegram viene solitamente utilizzato per supporto clienti, coinvolgimento della community o messaggistica transazionale in canali dove Telegram ha già una forte base utenti. Molti team usano l'integrazione per offrire supporto self-service immediato, automazione delle FAQ e smistamento dei ticket direttamente nelle chat Telegram, riducendo la necessità di portali web o app mobili separati. Altri la utilizzano per inviare aggiornamenti sugli ordini, notifiche di account o annunci di prodotto agli iscritti che preferiscono Telegram come canale principale. Poiché Telegram supporta gruppi e supergruppi, l'integrazione è efficace anche per moderare community, indirizzare domande complesse ad agenti umani tramite policy Botpress e raccogliere feedback dagli utenti più attivi in tempo reale. In combinazione con funzionalità Botpress come recupero di conoscenza, policy e human-in-the-loop, l'integrazione Telegram diventa un punto di ingresso flessibile per qualsiasi organizzazione che voglia portare il proprio chatbot o agente AI su un pubblico Telegram già esistente.

Gestito da

Botpress Team

tag

Agente AI

Chatbot

Chat dal vivo

Social

SMS

Notifiche

Messaggistica

Telegram

Domande frequenti

Scopri le integrazioni più popolari