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

# Telegram

> Chatta con l'agente Vibewax su Telegram

La connessione Telegram di Vibewax ti permette di chattare con l'agente Vibewax 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.** Vibewax 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 Vibewax vai su **Impostazioni → Connessioni** e fai clic su **Connetti** nella scheda Telegram.

    <img src="https://vibewax.be/docs/images/integrations_telegram_01.png" alt="Scheda Telegram in Impostazioni Connessioni" width="1500" height="1000" />
  </Step>

  <Step title="Apri Telegram">
    Vibewax 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 Vibewax e il messaggio `/start [CODE]` già inserito. Premi **Avvia** (oppure invia il messaggio) per connetterti.
  </Step>

  <Step title="Inizia a chattare">
    Vibewax 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 Vibewax:

| 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 Vibewax, 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, Vibewax 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 Vibewax (al massimo 3) e passare dall'uno all'altro con `/switch`.
- **Limite di dimensione dei messaggi vocali.** I messaggi vocali possono arrivare fino a 10 MB. Le registrazioni più lunghe non vengono inviate.


This page is part of the [Vibewax documentation](https://vibewax.be/docs/it/welcome/overview).
