---
title: Telegram
description: Collega un bot Telegram a un progetto e scegli chi può inviargli attività.
---

Un bot Telegram permette di inviare attività all'agente di un progetto da una chat. Le risposte arrivano nella stessa chat e lo storico completo della sessione è consultabile in Beeuni.

## Collegare il bot

1. Apri **@BotFather** in Telegram e crea un bot con `/newbot`. Copia il token del bot.
2. Apri la pagina **Canali** del progetto. Trova **Telegram**, inserisci il token e collega il bot.
3. Invia `/start` al bot in Telegram. Se il tuo account non è ancora autorizzato, la risposta mostra il tuo ID numerico Telegram.
4. Aggiungi l'ID all'elenco delle persone autorizzate in Beeuni e salva. Invia quindi un'attività al bot.

Se l'elenco è vuoto, nessuno può eseguire attività. Per collegare il bot o modificare l'elenco serve il permesso di gestire i connettori del progetto. Il token resta sul server: non compare nei dati di installazione e non viene passato all'agente.

## Sessioni e accesso

La prima attività in una chat avvia una sessione. I messaggi successivi la continuano. Ogni argomento di un forum ha una sessione distinta. Invia `/new` per avviare una nuova sessione con il messaggio successivo. Lo storico precedente resta in Beeuni.

Le persone autorizzate eseguono attività con l'identità di automazione del progetto. Le sessioni sono visibili nel progetto. Non si tratta di un accesso a Beeuni con l'account personale di ogni mittente. Aggiungi solo chi può eseguire attività con gli accessi condivisi del progetto.

Per non ricevere più attività tramite il bot, scollegalo dalla pagina Canali.

## SDK

L'SDK offre `getTelegramInstallation`, `connectTelegram`, `setTelegramAllowedUsers` e `disconnectTelegram`. Passa l'ID del progetto alle funzioni. Vedi [Autenticazione SDK](/docs/it/sdk/auth) per configurare il token di accesso.