Team Telegram Assistant

Se hai mai desiderato poter chattare con il tuo agente AI dal telefono, mandargli un memo vocale mentre porti a spasso il cane, o fargli osservare in silenzio una chat di gruppo e intervenire solo quando pronunci il suo nome — questo articolo fa per te.

Continuiamo la nostra serie su Hermes Agent, e oggi ci immergiamo nell’integrazione Telegram. Non è solo un bot “manda un messaggio, ricevi una risposta”. È un assistente conversazionale completo che vive dentro Telegram, pronto ad aiutarti da qualsiasi dispositivo, in qualsiasi momento.

Vediamo insieme la configurazione e le nuove fantastiche funzionalità che rendono questa integrazione un vero compagno di squadra.

Passo 1: Crea il tuo Bot (Più Facile di Quanto Pensi)

Prima di tutto, ti serve un token del bot. È come una chiave che permette a Hermes di controllare il tuo bot. Ecco come ottenerne uno:

Apri Telegram e cerca @BotFather (o visita t.me/BotFather)
Invia /newbot
Scegli un nome visualizzato — qualsiasi cosa ti piaccia, tipo “Hermes Agent”
Scegli uno username — deve essere unico e terminare con bot (es. my_hermes_bot)
BotFather ti risponderà con il tuo token API. Sembra così:

123456789:ABCdefGHIjklMNOpqrSTUvwxYZ

⚠️ Mantieni segreto questo token! Chiunque lo possieda può controllare il tuo bot. Se dovesse trapelare, revocalo immediatamente tramite /revoke in BotFather.

Passo 2: Rendi il tuo Bot Professionale (Opzionale)

Puoi personalizzare il profilo del tuo bot con alcuni semplici comandi di BotFather:

Comando	Scopo
`/setdescription`	Il testo “Cosa può fare questo bot?” mostrato prima che qualcuno inizi a chattare
`/setabouttext`	Breve testo nella pagina del profilo del bot
`/setuserpic`	Carica un avatar
`/setcommands`	Definisce il menu dei comandi (il pulsante `/` nella chat)
`/setprivacy`	Controlla la visibilità dei messaggi di gruppo (vedi Passo 3)

Per /setcommands, un buon set iniziale:

help - Mostra le informazioni di aiuto
new - Inizia una nuova conversazione
sethome - Imposta questa chat come canale principale

Mostra Stato Online/Offline (Nuovo!)

I bot di Telegram non hanno il pallino verde “online” come gli account utente. Ma ora Hermes può simularlo! Abilita status_indicator e Hermes aggiornerà la breve descrizione del bot (la riga sotto il nome nel profilo) per mostrare Online quando è connesso e Offline allo spegnimento pulito.

gateway:
  platforms:
    telegram:
      extra:
        status_indicator: true
        # Stringhe personalizzate opzionali (predefinite: "Online" / "Offline"):
        status_online: "🟢 Online"
        status_offline: "🔴 Offline"

Nota: Questo stato è globale (visibile a tutti gli utenti), non per singola chat. E si aggiorna solo con uno spegnimento pulito — un crash improvviso lascia l’ultimo stato conosciuto.

Hermes registra automaticamente il suo menu comandi all’avvio del gateway. Di default, lo limita a 60 comandi per mantenere il payload affidabile (Telegram consente fino a 100, ma payload grandi possono fallire).

Se hai comandi dei plugin che devono rimanere visibili nel selettore /, puoi dar loro priorità:

platforms:
  telegram:
    extra:
      command_menu:
        max_commands: 60
        priority_mode: prepend  # prepend | append | replace
        priority:
          - my_plugin_command

prepend: prima i tuoi comandi, poi quelli predefiniti di Hermes
append: prima quelli predefiniti di Hermes, poi i tuoi
replace: usa solo la tua lista per l’ordinamento prioritario

Passo 3: Modalità Privacy — L’Insidia N.1 (Critica per i Gruppi)

Questa è la fonte più comune di confusione. I bot di Telegram hanno la modalità privacy abilitata per impostazione predefinita.

Con la modalità privacy ATTIVA, il tuo bot può vedere solo:

Messaggi che iniziano con /
Risposte ai suoi stessi messaggi
Messaggi di servizio (entrate, uscite, messaggi fissati)
Messaggi nei canali dove è amministratore

Con la modalità privacy DISATTIVATA, il bot vede tutti i messaggi nel gruppo.

Come disattivarla:

Scrivi a @BotFather
Invia /mybots
Seleziona il tuo bot
Vai su Bot Settings → Group Privacy → Turn off

⚠️ Devi rimuovere e ri-aggiungere il bot a qualsiasi gruppo dopo questa modifica. Telegram memorizza nella cache lo stato della privacy quando il bot si unisce — non si aggiorna finché non lo ri-aggiungi.

Alternativa: Promuovi il bot ad amministratore del gruppo. I bot amministratori ricevono sempre tutti i messaggi, senza bisogno di attivare/disattivare la privacy.

Osserva le Chiacchiere di Gruppo Senza Rispondere Automaticamente (Nuovo!)

Vuoi che il tuo bot osservi un gruppo ma parli solo quando viene menzionato? Perfetto per i canali di team dove vuoi contesto senza rumore.

telegram:
  allowed_chats:
    - "-1001234567890"
  group_allowed_chats:
    - "-1001234567890"
  require_mention: true
  observe_unmentioned_group_messages: true

Con questa configurazione, i messaggi non menzionati dalle chat consentite vengono aggiunti alla trascrizione della sessione condivisa come contesto osservato — l’agente li vede ma non risponde. Poi, quando lo menzioni con @nomebot, ha il contesto completo della conversazione.

Perché Questo è Importante per i Team

Questa integrazione trasforma Hermes da strumento individuale a giocatore di squadra. Puoi:

Inviare memo vocali che vengono trascritti automaticamente
Ricevere i risultati di attività pianificate direttamente in chat
Condividere immagini e file
Far osservare al bot i canali in silenzio e intervenire quando serve

La nuova modalità di osservazione è particolarmente potente — il tuo bot diventa un compagno silenzioso sempre aggiornato, pronto ad aiutarti nel momento in cui pronunci il suo nome.

Conclusioni

Configurare Telegram con Hermes richiede circa cinque minuti, e i benefici sono enormi. Ottieni un assistente conversazionale che funziona dalla tua tasca, capisce la voce, rispetta le dinamiche di gruppo e può essere loquace o silenzioso quanto ti serve.

La prossima volta esploreremo altri modi per far sentire Hermes parte del team. Fino ad allora, buone chat! 🚀