# Telegram (Beta) Collega il tuo account Telegram esistente alla piattaforma in modo che le tue conversazioni Telegram confluiscano direttamente nell'app e un Agente AI possa rispondere. Puoi connetterti inserendo il tuo numero di telefono e un codice di accesso: lo stesso metodo che useresti per aggiungere Telegram su un nuovo dispositivo. > **Beta.** Telegram è ora disponibile per tutti, ma è ancora una novità: aspettati qualche piccola imperfezione mentre lo perfezioniamo. Se qualcosa non funziona come descritto, segnalalo all'assistenza. --- ## Cos'è l'integrazione Telegram? L'integrazione Telegram collega il tuo account Telegram personale alla piattaforma utilizzando il flusso di accesso di Telegram stesso. Non c'è alcun bot da creare né un numero di telefono separato da acquistare: accedi con l'account Telegram che già utilizzi e le tue chat 1-a-1 diventano disponibili all'interno dell'app. Questa soluzione è ideale per le aziende che comunicano già con i clienti su Telegram e desiderano aggiungere un Agente AI, trasmissioni e una casella di posta condivisa al proprio account esistente. > **Importante: leggi prima di connetterti.** Questa è un'integrazione **non ufficiale** che automatizza un **account Telegram personale**. Le regole di Telegram scoraggiano l'automazione e l'invio di messaggi di massa o non richiesti; gli account che violano tali regole possono essere **limitati o bannati permanentemente** (in alcuni casi, il numero di telefono stesso può essere bloccato dalla ri-registrazione). Utilizza questo canale solo per inviare messaggi a persone che ti hanno **già contattato o che sono contatti salvati**, mantieni bassi i volumi e lascia che l'AI risponda a un ritmo naturale. **Non** utilizzarlo per attività di cold outreach di massa. --- ## Telegram vs. WhatsApp Web Entrambi collegano un account già in tuo possesso, senza un'API Business ufficiale. | Funzionalità | Telegram | WhatsApp Web | |---|---|---| | **Configurazione** | Inserisci numero di telefono + codice di accesso | Associa il tuo telefono (QR o codice di associazione) | | **Tipo di account** | Il tuo account Telegram personale | Il tuo WhatsApp personale/business | | **Costo per messaggio** | Gratuito | Gratuito | | **Messaggi modello** | Non applicabile | Non supportato | | **Indicatori di digitazione** | Supportati | Supportati | | **Media (in entrata)** | Foto, documenti, note vocali | Foto, documenti, note vocali | | **Supporto ufficiale** | Integrazione non ufficiale | Integrazione non ufficiale | | **Ideale per** | Aziende già attive su Telegram, contatti esistenti/caldi | Aziende su WhatsApp, avvio rapido | > **Stesso numero su entrambi?** Sì. Se lo stesso numero di telefono è presente sia su Telegram che su WhatsApp (Web), puoi collegarlo come **entrambi** i canali: vengono eseguiti come due connessioni separate nella pagina Canali, ognuna con il proprio stato, riscaldamento e limiti. Collegarne uno non influisce né sostituisce l'altro. --- ## Configurazione di Telegram ### Passaggio 1: Apri il flusso di connessione 1. Nella barra laterale sinistra, fai clic su **Settings** vicino alla parte inferiore. 2. Nella barra laterale di Settings, sotto **Channels**, fai clic su **Channels**. 3. Trova la scheda **Telegram** — che riporta un avviso **Beta** — e fai clic su **Connect**. ### Passaggio 2: Inserisci il tuo numero di telefono 1. Digita il numero di telefono dell'account Telegram che desideri collegare, incluso il prefisso internazionale (ad esempio `555 123 4567`). 2. Attiva **Importa chat esistenti** se desideri importare le tue recenti conversazioni individuali di Telegram come contatti, in modo da non iniziare con una casella di posta vuota. (Attivando questa opzione potrai anche controllare **Mantieni l'IA in pausa per le chat importate** — consigliato e attivo per impostazione predefinita, in modo che l'importazione della cronologia non attivi mai risposte automatiche a vecchi messaggi. Puoi disattivarlo in seguito per singolo contatto quando sei pronto.) 3. Fai clic su **Invia codice di accesso**. 4. Telegram invia un codice di accesso **alla tua app Telegram** (solitamente arriva come messaggio dalla chat di servizio ufficiale "Telegram", non sempre come SMS). ### Passaggio 3: Inserisci il codice di accesso 1. Apri Telegram sul tuo telefono. 2. Leggi il codice di accesso dalla chat di servizio **Telegram**. 3. Digita il codice nell'app. 4. Fai clic su **Verifica codice**. > **Il codice scade rapidamente.** Tieni il telefono a portata di mano prima di fare clic su **Invia codice di accesso** e inserisci il codice tempestivamente. Se scade, avvia nuovamente la connessione per ottenerne uno nuovo. ### Passaggio 4: Password a due fattori (se ne hai una) Se il tuo account Telegram ha la **verifica in due passaggi** abilitata, l'app richiederà la tua **password 2FA** dopo il codice. Inseriscila, quindi fai clic su **Verifica password**. La tua password viene utilizzata solo per completare l'accesso sicuro e non viene mai memorizzata in forma leggibile. Una volta verificato, il tuo account apparirà nella pagina Canali come **Connesso**. Le tue conversazioni Telegram sono ora accessibili tramite la piattaforma e un Agente AI assegnato a questo canale può rispondere ai messaggi in arrivo. ### Importazione delle chat esistenti Se hai attivato **Importa chat esistenti** nel Passaggio 2: - Vengono importate solo le chat private (uno a uno) recenti. Le chat di gruppo non sono incluse e per ogni chat viene estratta solo una quantità limitata di cronologia recente. - L'importazione viene eseguita una sola volta, in background, subito dopo la connessione. Per gli account più grandi, potrebbe volerci un po' di tempo prima che tutto venga visualizzato. - I messaggi importati completano la conversazione nelle Chat, ma non vengono conteggiati nei numeri o nei grafici della tua [Dashboard](../get-started/dashboard.md). In quella sezione viene misurato solo ciò che invii e ricevi dopo la connessione. Se ti connetti senza importare, le nuove conversazioni continueranno ad arrivare normalmente da quel momento in poi; verrà saltata solo la cronologia precedente. --- ## Gestione della sessione ### Verifica dello stato della connessione Lo stato della tua connessione Telegram viene mostrato sulla scheda **Telegram** nella pagina **Canali**: | Stato | Significato | |---|---| | **Connesso** | Attivo e in grado di ricevere/inviare messaggi | | **Codice inviato** | In attesa dell'inserimento del codice di accesso | | **Verifica in due passaggi richiesta** | In attesa della password per la verifica in due passaggi | | **Non connesso** | Nessuna sessione attiva | ### Riconnessione Se la sessione si interrompe, apri **Impostazioni → Canali → Canali**, trova la scheda Telegram e utilizza l'azione di connessione/gestione. Se la sessione non può essere ripristinata automaticamente (ad esempio, perché l'hai terminata dal telefono), ti verrà chiesto di accedere nuovamente con un nuovo codice. ### Disconnessione Apri la scheda **Telegram** e fai clic su **Disconnetti**. Questo scollegherà la piattaforma dal tuo account Telegram e chiuderà la sessione. Puoi anche terminarla direttamente da Telegram: **Impostazioni → Dispositivi → Sessioni attive**, quindi termina la sessione della piattaforma. --- ## Rimanere al sicuro su Telegram Poiché questo strumento automatizza un account personale, proteggerlo dai ban è una tua responsabilità. La piattaforma regola l'IA e gli invii in uscita per farli sembrare naturali, ma segui queste pratiche: - **Invia messaggi solo a contatti caldi/esistenti.** Rispondi alle persone che ti hanno scritto per prime o che sono tra i tuoi contatti salvati. Evita di inviare messaggi in massa a sconosciuti: è il modo più rapido per attivare il filtro antispam di Telegram. - **Mantieni i volumi bassi**, specialmente su un account appena connesso. Aumenta gradualmente nel corso dei giorni, non tutto in una volta. - **Evita di inviare link a persone che non ti conoscono**: i messaggi pieni di link inviati a sconosciuti sono una causa comune di ban. - **Lascia che l'IA risponda a un ritmo naturale.** I ritardi integrati e l'indicatore di digitazione servono a mantenere la conversazione simile a quella umana: non cercare di disattivarli. - **Usa un numero reale che controlli.** I numeri usa e getta/virtuali (VoIP, ovvero numeri basati su internet e non su una SIM fisica) hanno molte più probabilità di essere segnalati. > **Attenzione.** Se Telegram segnala l'account per spam, l'invio si interrompe finché il comportamento non cambia; attendere da solo non risolve il problema. Violazioni ripetute possono portare al ban permanente dell'account e del relativo numero di telefono. --- ## Limiti di invio, riscaldamento e controlli sui follow-up Telegram utilizza gli stessi limiti di invio protettivi, il riscaldamento automatico e l'interruttore di sicurezza per i follow-up per account, simili a quelli di WhatsApp Web. Questi servono a evitare che un account personale sembri una farm di spam e venga segnalato. Nella pagina **Canali**, una volta connesso il tuo account Telegram, vedrai: - Una scheda **Limiti di invio e riscaldamento** con gli stessi indicatori di WhatsApp Web: messaggi inviati oggi, nuovi contatti oggi e il giorno di riscaldamento corrente. - Un interruttore **Follow-up automatici**: è **attivo** per impostazione predefinita per un numero appena collegato, quindi disattivalo manualmente mentre il numero è ancora in fase di riscaldamento. Rimane interattivo in ogni momento, ma mostra quali soglie di riscaldamento (età del numero, incremento dell'attività, coinvolgimento recente dei contatti) non sono ancora state superate. ### Riscaldamento automatico (ramp) Un account Telegram appena collegato viene intenzionalmente limitato e sblocca maggiore capacità nel tempo. L'account guadagna un "giorno di qualificazione" solo nei giorni in cui invia effettivamente almeno il 75% del suo limite attuale; i giorni di inattività non contano, quindi l'account non può progredire senza un utilizzo reale e costante. - **Limite giornaliero di messaggi** = `50 + 8 × (day − 1)`, con un tetto massimo di **500/giorno** (raggiunto al giorno 58). - **Limite giornaliero di nuovi contatti** = `floor((day − 1) × 5 / 6)` (arrotondato per difetto al numero intero), con un tetto massimo di **50/giorno** (raggiunto al giorno 61). Quindi, su un account nuovo si parte da 50 messaggi/giorno e 0 nuovi contatti/giorno, salendo fino al tetto massimo in circa due mesi. La pagina Canali mostra il giorno attuale, l'utilizzo odierno rispetto al limite e quanto manca al completamento. ::: tip **Suggerimento:** Se connetti un account che **ha già** mesi di cronologia Telegram autentica, il pannello di aumento graduale ti permette di avanzare il giorno di riscaldamento in modo che i limiti vengano rimossi immediatamente. Usa questa funzione onestamente: solo per account che hanno davvero una cronologia organica. Un account nuovo di zecca che salta il riscaldamento ha molte più probabilità di essere bannato. ::: ### Override manuale oltre il periodo di riscaldamento Una volta che un account ha terminato l'intero periodo di riscaldamento di 58 giorni, un override opzionale ti consente di aumentare il limite giornaliero di messaggi oltre i 500 (da 750 fino a 5.000, con incrementi di 250 messaggi). Non esiste un numero "sicuro" pubblicato per Telegram: mantieniti prudente, tieni d'occhio le segnalazioni di spam e riduci immediatamente se noti problemi. L'override è disponibile solo su account completamente riscaldati; un account nuovo non può saltare il riscaldamento in questo modo. ### Interruttore di blocco (kill switch) dei follow-up per account L'interruttore **Follow-up automatici** controlla solo questo account. Quando è disattivato, **nessun follow-up automatico di alcun tipo** viene inviato da quell'account, indipendentemente dalle impostazioni di trasmissione o campagna. Su un account nuovo (meno di circa 30 giorni di riscaldamento), è più sicuro lasciare i follow-up disattivati e inviare solo la risposta iniziale: i follow-up sono ciò che più spesso fa classificare un account a bassa affidabilità come "bot". Riattivalo una volta che l'account è riscaldato e stabile. Quando viene raggiunto il limite giornaliero di messaggi, i follow-up programmati vengono automaticamente spostati al giorno successivo invece di fallire. --- ## Messaggi multimediali Foto, documenti e note vocali in arrivo vengono caricati nella chat in modo che l'IA possa comprenderli (le note vocali vengono trascritte automaticamente). Le risposte dell'IA in uscita sono **solo testo** in questa versione. Le risposte lunghe vengono automaticamente troncate al limite di 4.096 caratteri di Telegram. --- ## Leggi lo stato sul tuo telefono Quando l'IA risponde a una chat di Telegram, o quando apri quella chat in Chat, la chat viene contrassegnata come letta anche sulla tua app Telegram, così il badge dei messaggi non letti sul telefono rimane sincronizzato invece di accumulare centinaia di chat non lette. Le chat a cui il bot **non** risponde (ad esempio quando è spento, fuori dagli orari di attività o quando ha scelto di non rispondere) vengono lasciate **non lette** di proposito, così puoi individuarle e gestirle personalmente. --- ## Limitazioni - **Solo chat personali 1-a-1.** I messaggi di gruppi e canali non sono gestiti in questa versione. - **Nessun pulsante inline.** I menu a pulsanti interattivi non sono supportati. - **Invio solo testo.** L'IA risponde con testo; l'invio di file multimediali è previsto in un aggiornamento successivo. - **Integrazione non ufficiale.** Si basa sull'accesso client di Telegram e non è approvata da Telegram; le modifiche alla piattaforma da parte loro potrebbero influire sul funzionamento. - **Rischio per l'account.** L'automazione eccessiva o non richiesta può portare alla limitazione o al ban dell'account: segui le linee guida di sicurezza sopra indicate. --- ## Risoluzione dei problemi ### Il codice di accesso non arriva - Controlla la chat di servizio **Telegram** all'interno dell'app Telegram: il codice viene solitamente consegnato lì, non via SMS. - Assicurati di aver inserito il numero di telefono con il prefisso internazionale corretto. - Telegram limita l'invio di codici per account/numeri che considera sospetti. Attendi qualche minuto e riprova. ### "Codice scaduto" o "Codice non valido" - Il codice è valido solo per breve tempo. Avvia nuovamente la connessione per richiederne uno nuovo e inseriscilo tempestivamente. ### Richiesta di password inaspettata - Il tuo account ha la verifica in due passaggi attivata. Inserisci la tua password di Telegram per completare l'accesso. Se l'hai dimenticata, reimpostala da **Impostazioni → Privacy e sicurezza → Verifica in due passaggi** su Telegram. ### Messaggi non inviati - Verifica che lo stato della connessione mostri **Connesso** nella pagina Canali. - Conferma che il contatto sia qualcuno a cui puoi inviare messaggi su Telegram. - Se l'account è stato recentemente segnalato per spam, riduci il volume e limitati ai contatti esistenti. ### Account disconnesso - La tua sessione è stata terminata (da te, da un altro dispositivo o da Telegram). Vai su **Impostazioni → Canali → Canali**, fai clic su **Disconnetti**, quindi accedi di nuovo. --- ## Best practice - **Collega un account che comunica già con i clienti su Telegram**, non uno nuovo creato appositamente. - **Inizia con un volume di automazione basso** e aumenta gradualmente. - **Rispondi ai contatti in entrata e a quelli già attivi** invece di inviare messaggi a freddo a sconosciuti. - **Mantieni il tuo account in salute**: un numero reale, un utilizzo normale e un ritmo conservativo riducono drasticamente il rischio di ban.