Torna alla documentazioneIntegrazioni

Telegram

Porta il tuo bot Telegram, legato a un agente, per DM e gruppi.

Ultimo aggiornamento 17 settembre 2026 · 3 min read

Telegram è il canale giusto quando Slack non è un'opzione — sei fuori dal tenant Slack dello spazio di lavoro, collabori con un gruppo che vive su Telegram, oppure vuoi un canale di messaggi diretti leggero con Okou, separato dallo Slack del tuo team.

Il bot lo porti tu. Ogni bot Telegram è legato a un solo agente nel tuo spazio di lavoro Okou, così un bot personale e uno di team possono portare ad agenti diversi con workflow diversi.

Collegare il bot

  1. Parla con @BotFather su Telegram. Esegui /newbot, dai un nome al bot e copia il token che BotFather ti restituisce.
  2. In Okou apri Where Okou works e scegli Telegram.
  3. Incolla il token del bot. Scegli verso quale agente deve instradare.
  4. (Per l'uso nei gruppi) Disattiva il privacy mode del bot in BotFather: /setprivacy → scegli il tuo bot → Disable. Senza questo il bot vede solo i messaggi che lo menzionano direttamente con @; disattivandolo legge il contesto del gruppo attorno a menzioni e risposte.
  5. Apri Telegram e manda un messaggio al bot. Il primo messaggio apre una chat collegata in Okou.

Come si usa Okou su Telegram

Due modalità principali:

Scrivere al bot in privato. Si comporta come una chat privata con Okou. Messaggi, file, foto — Okou li vede tutti. Ogni conversazione privata corrisponde a una chat in Okou.

Aggiungere il bot a un gruppo. Con il privacy mode disattivato il bot legge i messaggi attorno a menzioni e risposte. Menzionalo con @ o rispondi ai suoi messaggi per tenere vivo il filo. Gli altri membri del gruppo non vedono mai il ragionamento di Okou, solo il risultato che il bot pubblica.

Usi ricorrenti su Telegram

  • Smistare la posta da mobile. In treno scrivi al tuo bot: «riassumi i messaggi Slack non letti di #cs.» Okou risponde in pochi secondi.
  • Gruppi con fornitori o partner. Aggiungi il bot a un gruppo con persone esterne alla tua azienda. Il bot gestisce appuntamenti, promemoria o traduzioni senza esporre il tuo Slack interno.
  • Un bot per agente. Lega un bot di ricerca al tuo agente di ricerca e un bot personale al tuo agente personale. Stessa app Telegram, bot diversi, agenti diversi.

Instradamento per agente

Ogni token di bot è legato esattamente a un agente. Se vuoi che risponda un altro agente, crea un secondo bot in BotFather e collegalo. È una scelta voluta: su questa superficie l'identità di un bot Telegram è l'identità dell'agente.

Supporto ai file

Telegram accetta foto, note vocali, documenti e PDF. Okou li acquisisce tutti come input della chat. I file in uscita — gli artefatti prodotti da Okou — tornano come documenti Telegram o come immagini mostrate direttamente.

Inciampi frequenti

  • Il bot non risponde nel gruppo. Il privacy mode è ancora attivo. Riesegui /setprivacy in BotFather → Disable, poi togli il bot dal gruppo e riaggiungilo.
  • Risponde l'agente sbagliato. Il token del bot è legato a un solo agente. Per cambiarlo, modifica il collegamento in Where Okou works oppure usa un bot separato.
  • Token del bot trapelato. Rigeneralo in BotFather (/revoke), poi aggiorna il token in Okou. Quello vecchio smette subito di funzionare.

Cosa fare dopo

  • Vedi Workflows per fissare il lavoro ricorrente da mobile.
  • Vedi Permissions per cosa Okou può e non può fare tramite il tuo bot.