Canale Telegram
Telegram è un canale di chat dal vivo: le conversazioni sono ricevute e gestite in tempo reale, ma il canale non supporta l'invio di campagne outbound né i template dedicati, a differenza di WhatsApp.
Prerequisiti
- Un bot Telegram creato tramite BotFather, con il relativo token.
- Permesso di amministrazione (sezione Integrazioni).
- Un chatbot configurato, per collegare il canale a un flusso automatico (vedi Creare e configurare un chatbot).
Configurare l'integrazione Telegram
Dal pannello Amministrazione › Integrazioni, aprire la tessera Telegram e impostare:
- lo username del bot creato su BotFather;
- il token generato da BotFather;
- i messaggi di benvenuto e di chiusura mostrati al contatto.

Collegare un chatbot a Telegram
Nell'editor del chatbot, nella tab Integrazioni (vedi Creare e configurare un chatbot), è possibile pubblicare il bot su Telegram indicando nome del bot e token BotFather, e associarlo alle categorie di chat su cui deve intervenire.
Instradamento e categorie
Come per il widget, ogni conversazione Telegram viene ricondotta a una categoria di chat prima di essere gestita: il canale non scavalca la categoria.
La categoria viene determinata all'avvio della conversazione, quando il contatto invia il comando iniziale:
- se al tenant è associata più di una categoria, il contatto sceglie quella desiderata da un elenco proposto insieme al messaggio di benvenuto;
- se è disponibile una sola categoria, questa viene usata automaticamente senza richiedere una scelta.
Individuata la categoria, il comportamento dipende dalla sua configurazione:
- se la categoria ha un chatbot attivo, la conversazione è condotta dal bot, con eventuale passaggio a un operatore quando il flusso lo prevede;
- se la categoria non ha un chatbot attivo, la conversazione entra direttamente nella coda degli operatori.
Che cosa supporta il canale
- Messaggi di testo in entrambe le direzioni.
- Gli allegati inviati dal contatto sono ricevuti con supporto limitato: la gestione dei documenti non è completa quanto sugli altri canali.
- Nessun invio massivo: Telegram non fa parte dei canali disponibili per le campagne outbound (vedi Campagne outbound: panoramica) e non dispone di template dedicati.
Problemi comuni
| Problema | Causa probabile | Soluzione |
|---|---|---|
| Il bot non risponde | Token non valido o bot non pubblicato correttamente | Rigenerare/verificare il token su BotFather e ripetere la pubblicazione nella tab Integrazioni |
| Le conversazioni non arrivano nella categoria attesa | Categoria non associata al chatbot, o nessun chatbot attivo sulla categoria scelta | Verificare l'associazione tra categoria e chatbot e che il bot sulla categoria sia attivo |
| Un allegato non viene ricevuto correttamente | Tipo di allegato non pienamente supportato dal canale | Chiedere al contatto di inviare il contenuto come testo o tramite un altro canale |