> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram

> Chatta con l'agente Macaly su Telegram

La connessione Telegram di Macaly ti permette di chattare con l'agente Macaly dal tuo telefono. Invia un messaggio su Telegram, ricevi una risposta e continua a lavorare ai tuoi progetti senza aprire l'app web.

## Cosa puoi fare

L'agente su Telegram lavora sugli stessi progetti che crei nell'app web. Tutto ciò che chiederesti normalmente all'agente puoi chiederglielo da Telegram:

* **Avviare un nuovo progetto.** Descrivi cosa vuoi creare e l'agente si mette al lavoro, proprio come nell'app web.
* **Modificare i tuoi progetti esistenti.** Chiedi modifiche, correzioni o nuove sezioni. Se hai diversi progetti e non specifichi quale, l'agente te lo chiede.
* **Pubblicare e gestire.** Pubblica un progetto, cambia il suo sottodominio o controlla cosa è online.
* **Fare domande veloci.** Ottieni aiuto, idee o aggiornamenti di stato senza interrompere il tuo flusso di lavoro.

Quando l'agente apporta modifiche, ti invia un link di anteprima per controllare il risultato senza uscire da Telegram.

## Cosa puoi inviare

Al momento l'agente lavora con:

* **Messaggi di testo.** Basta scrivere e inviare.
* **Messaggi vocali.** Macaly li trascrive e risponde. Utile quando scrivere non è pratico.
* **Immagini.** Invia screenshot, mockup o riferimenti che l'agente deve esaminare.
* **File.** PDF e documenti che l'agente può leggere e utilizzare.

I video non sono ancora supportati. Le risposte arrivano come testo semplice, senza formattazione avanzata né anteprime dei link.

## Come si usa

<Steps>
  <Step title="Apri le impostazioni Connessioni">
    In Macaly vai su **Impostazioni → Connessioni** e fai clic su **Connetti** nella scheda Telegram.

    <img src="https://mintcdn.com/macaly-41b1d3e9/dOzNT7eRKWZWpaZK/images/integrations_telegram_01.png?fit=max&auto=format&n=dOzNT7eRKWZWpaZK&q=85&s=33014b19133bc9434e1335a8af1d97c4" alt="Scheda Telegram in Impostazioni Connessioni" width="2400" height="1600" data-path="images/integrations_telegram_01.png" />
  </Step>

  <Step title="Apri Telegram">
    Macaly mostra un codice QR e un link di connessione. Scansiona il codice QR con il telefono oppure fai clic su **Apri Telegram** per avviarlo sul computer o sul telefono con il codice di connessione già inserito.
  </Step>

  <Step title="Premi Avvia">
    Telegram apre una chat con il bot di Macaly e il messaggio `/start [CODE]` già inserito. Premi **Avvia** (oppure invia il messaggio) per connetterti.
  </Step>

  <Step title="Inizia a chattare">
    Macaly conferma la connessione e mostra l'account a cui è collegata. Da ora puoi scrivere all'agente in qualsiasi momento da Telegram.
  </Step>
</Steps>

Il codice di connessione è valido per 15 minuti. Se scade, generane uno nuovo dalle impostazioni Connessioni.

## Comandi del bot

Invia uno di questi comandi nella tua chat Telegram con Macaly:

| Comando | Cosa fa |
| - | - |
| `/new` | Avvia una nuova conversazione con l'agente. |
| `/switch` | Passa a un altro workspace collegato (mostrato quando ne è collegato più di uno). |
| `/status` | Controlla lo stato della connessione e della chat attuale. |
| `/unlink` | Scollega un workspace da questa chat. Se ne sono collegati diversi, scegli quale. |
| `/help` | Elenca i comandi disponibili. |

## Usare più workspace

Puoi collegare lo stesso account Telegram a più di un workspace Macaly, fino a 3 alla volta. È comodo se lavori su più workspace e vuoi raggiungerli tutti da una sola chat.

* **Collegare un altro workspace.** Apri **Impostazioni → Connessioni** nell'altro workspace e collegalo dallo stesso account Telegram.
* **Cambiare il workspace attivo.** Invia `/switch` e scegli un workspace dall'elenco. Il tuo messaggio successivo avvia una nuova conversazione lì.
* **Vedere quale è attivo.** Invia `/status`: la risposta inizia con il nome del workspace attivo.

È attivo un solo workspace alla volta, quindi i messaggi vanno a quello su cui sei passato per ultimo. Se scolleghi il workspace attivo, Macaly sposta automaticamente la chat su un altro workspace collegato, così continua a funzionare.

## Scollegare

Per scollegare, invia `/unlink` da Telegram oppure apri **Impostazioni → Connessioni** nell'app e rimuovi l'account collegato.

Se la chat è collegata a un solo workspace, viene scollegata subito. Se ne sono collegati diversi, `/unlink` ti chiede quale rimuovere: scollegare un workspace che non stai usando lascia la conversazione intatta, mentre scollegare quello attivo sposta la chat su un altro workspace collegato.

## Buono a sapersi

* **Nessuna configurazione del bot.** Non devi creare un tuo bot Telegram né ottenere una chiave API. Basta collegarsi da Impostazioni e iniziare a chattare.
* **I crediti funzionano come nell'app web.** Il lavoro dell'agente consuma crediti alla stessa velocità dell'app web, più una piccola quota aggiuntiva quando invii messaggi vocali (per la trascrizione).
* **Fino a 3 workspace per account Telegram.** Puoi collegare il tuo account Telegram a diversi workspace Macaly (al massimo 3) e passare dall'uno all'altro con `/switch`. Anche ogni membro del workspace può collegare il proprio account.
* **Limite di dimensione dei messaggi vocali.** I messaggi vocali possono arrivare fino a 10 MB. Le registrazioni più lunghe non vengono inviate.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.