Vai al contenuto

Pronto a creare con AnyBot?

Documentazione AnyBot
Canali

Telegram

Collega Telegram incollando un bot token da @BotFather, il bot ufficiale di Telegram. Il tuo agente ottiene la propria identità bot e funziona nei gruppi quando viene menzionato con @mention.

Telegram è l'unico canale in cui il tuo agente ottiene una propria identità, un account bot dedicato con il suo @username, non un account che possiedi già. Quel bot lo crei con @BotFather, il bot ufficiale di Telegram. Copi il bot token che ti consegna e lo incolli in AnyBot. Non c'è OAuth né alcuna revisione da parte di Meta. AnyBot convalida il token, registra per te il webhook in entrata al momento dell'installazione e memorizza lo username del bot così da capire quando viene menzionato in un gruppo, quindi, una volta salvato il token, non c'è nient'altro da ospitare o configurare.

Prima di iniziare

  • Un account Telegram per parlare con @BotFather (va bene qualsiasi account personale, serve solo a creare il bot).
  • Decidi quale agente deve rispondere prima di collegarti, così le risposte partono subito.
  • Puoi collegare più di un bot Telegram a uno spazio, ognuno è un canale a sé.

Collega

  1. In Telegram, apri una chat con @BotFather e invia /newbot. Dagli un nome visualizzato e uno @username univoco (deve terminare con bot).

  2. @BotFather risponde con un token HTTP API (una lunga stringa number:letters). Copialo.

  3. Nel tuo spazio, apri Canali → Telegram, incolla il token in Bot Token e salva. AnyBot chiama Telegram per verificare il token e legge il nome e lo username del tuo bot.

  4. Al salvataggio, AnyBot registra automaticamente il webhook (con un secret privato) e il canale passa a Connected. Il tuo agente è attivo su quel bot.

Questa è tutta la configurazione, non devi mai ospitare un webhook né fare polling degli aggiornamenti da solo.

Su questo canale

Il tuo agente gestisce i tipi di messaggio quotidiani di Telegram in entrambe le direzioni:

TipoRicevutoInviato
TestoSìSì (formattato, con citazione della risposta)
FotoSì (con didascalia)Sì (con didascalia)
Note vocaliSì (trascritte)Sì (come audio)
File audioSìSì
DocumentiSìSì
  • Indicatore di digitazione: l'agente mostra l'azione "sta scrivendo…" di Telegram mentre compone una risposta.
  • Citazione della risposta: cita il messaggio specifico a cui sta rispondendo quando un thread ha bisogno di restare chiaro.
  • Le didascalie su foto e documenti in entrata vengono lette come testo del messaggio.
  • Sticker, contatti, posizioni e pulsanti inline/callback non vengono elaborati come input dell'agente.

Gruppi

Aggiungi il tuo bot a un gruppo Telegram e resterà in silenzio durante le normali conversazioni. Risponde solo quando viene menzionato con @mention (con il suo username esatto) oppure quando qualcuno risponde a uno dei suoi messaggi, così non parla mai sopra la conversazione. Questo rispecchia il comportamento di privacy dei bot di Telegram nei gruppi.

Impostazioni del canale

Telegram usa il blocco standard di impostazioni del canale, messaggio di benvenuto, risposta automatica, orari di lavoro, un messaggio fuori orario e un limite di frequenza delle risposte, applicato a ogni messaggio su questo canale. Vedi Impostazioni del canale per l'elenco completo e cosa fa ciascun controllo.

Risoluzione dei problemi

  • "Invalid bot token" al salvataggio, il token è stato digitato male o revocato. Ricopialo da @BotFather (usa /mybots → API Token), oppure fai /revoke e incolla quello nuovo.
  • Bot silenzioso in un gruppo, risponde solo su @mention o come risposta a un suo messaggio. Verifica di aver usato il suo @username esatto.
  • Il canale mostra Disconnected, il token è stato revocato o rigenerato in @BotFather; incolla il token attuale per riconnetterti.
  • Le risposte arrivano senza formattazione, se la formattazione avanzata di una risposta è malformata, AnyBot la reinvia come testo semplice così ricevi comunque il messaggio; il contenuto non viene mai perso.

FAQ

Dove ottengo il token? Da @BotFather dentro Telegram, /newbot per uno nuovo, /mybots per un bot esistente.

Funziona nei gruppi? Sì, su @mention o come risposta al bot.

Quali media? Testo, foto, note vocali, audio e documenti, in entrambe le direzioni.

Posso collegare più di un bot? Sì, ogni bot Telegram è un canale a sé nello spazio.

Prossimi passi

  • Impostazioni del canale, messaggio di benvenuto, orari di lavoro e controlli sulla frequenza delle risposte.
  • Web chat, il canale a zero credenziali per partire nel modo più rapido.
  • Tutti i canali, collega WhatsApp, Slack, email e altro in un'unica casella di posta.