# Bot Telegram > Chatta a tu per tu in una chat privata, porta i personaggi nei gruppi, condividili inline o apri la Mini App. Source: https://reverie.im/it/docs/integrations/telegram-bot Language: it Il bot di Reverie porta i personaggi dentro Telegram — una chat privata con il bot, un gruppo, o un canale che amministra. Può anche aprire Reverie stessa dentro Telegram come Mini App, dove puoi comprare crediti con le Telegram Stars. ## Configurazione \[#set-it-up] ### Collegare il tuo account \[#link-your-account] Chiunque parli con un personaggio ha bisogno di un account Reverie collegato al proprio account Telegram (ne basta uno gratuito). Un account Telegram corrisponde a esattamente un account Reverie. * **Dal sito.** Nell'app, vai su **Labs → Bot Discord e Telegram** e premi **Collega su Telegram** sulla scheda di Telegram. Telegram apre una chat con il bot; tocca **Avvia** e sei collegato all'account con cui hai effettuato l'accesso. La pagina si aggiorna da sola. * **Da Telegram.** Apri il bot e invia `/start`. **Continua con Telegram** crea un account Reverie gratuito tramite la Mini App, senza bisogno di email. **Ho già un account** invia invece un link monouso, valido **10 minuti**, che unisce il tuo Telegram a un account esistente; `/link` invia lo stesso link in qualsiasi momento. ### Scegliere un personaggio \[#pick-a-character] Invia `/chat` per vedere con chi puoi parlare (prima i personaggi con cui parli già qui, poi i suggerimenti), oppure `/chat` seguito da un nome per cercare. Toccane uno e inizia a scrivere. ### Portare i personaggi in un gruppo \[#bring-characters-into-a-group] Facoltativo. Aggiungi il bot a un gruppo (**Aggiungi Bot a un Gruppo** sulla scheda di Telegram lo fa) e invia lì `/add `. Il bot cerca e mostra fino a otto risultati come pulsanti; toccane uno per aggiungerlo. Solo gli amministratori del gruppo possono aggiungere personaggi. ## La tua chat privata \[#your-private-chat] La tua chat privata con il bot è la tua conversazione, addebitata al tuo account. Ogni messaggio riceve una risposta, senza bisogno di menzioni. * **Un personaggio alla volta.** `/chat` passa a qualcun altro, e `/chats` elenca i personaggi con cui hai parlato qui. Ognuno conserva la propria conversazione, quindi tornando riprendi da dove avevi lasciato. * `/remove` chiude la conversazione in corso (resta salvata per `/chats`), e `/reset` la cancella dopo averti chiesto conferma. * **I personaggi 18+** seguono l'impostazione 18+ del tuo account: se è disattivata, restano nascosti e non possono chattare qui. * Le tue conversazioni recenti compaiono anche nella dashboard delle integrazioni sotto **Chat privata**, con **Continua sul web** per riprenderne una nel browser e **Chatta su Telegram** per tornare. ## Comandi \[#commands] Il pulsante del menu accanto alla casella di testo elenca i comandi che funzionano dove ti trovi: la chat privata e i gruppi hanno ciascuno il proprio elenco, nella lingua del tuo Telegram. | Comando | Argomento | Dove | Cosa fa | | -------------------- | ------------------------------ | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | `/start` | — | privata | Ti registra o ti collega, poi propone dei personaggi. In un gruppo, come `/help` | | `/help` | — | entrambe | Elenca i comandi | | `/chat` | nome (facoltativo) | privata | Sceglie o cambia il personaggio con cui stai parlando | | `/chats` | — | privata | I personaggi con cui hai parlato, per passare dall'uno all'altro | | `/link` | — | privata | Un link monouso per unire il tuo Telegram a un account Reverie esistente | | `/add` | testo di ricerca (facoltativo) | gruppo, amministratori | Cerca personaggi e aggiunge quello che tocchi. Nella chat privata, come `/chat` | | `/remove` | — | gruppo, amministratori | Elenca i personaggi del gruppo come pulsanti; rimuove quello che tocchi. Nella chat privata, chiude la conversazione in corso | | `/list` | — | gruppo | I personaggi di questo gruppo. Nella chat privata, come `/chats` | | `/info` | nome del personaggio | entrambe | Dettagli del personaggio. Nella chat privata, `/info` da solo descrive il personaggio con cui stai parlando; in un gruppo il nome è obbligatorio | | `/settings` | una sottochiave (facoltativa) | entrambe | Apre il menu delle impostazioni | | `/plugins` | — | entrambe | I plugin attivi in questa chat, con pulsanti per installare, rimuovere o attivare e disattivare i plugin ufficiali e i tuoi | | `/group` | — | gruppo, amministratori o l'host | Chi può parlare, un limite giornaliero per membro, i membri bloccati e i consumi. Si apre nella tua chat privata | | `/block`, `/unblock` | — | gruppo, amministratori o l'host | Inviati in risposta al messaggio di un membro: gli impediscono di parlare con i personaggi, o glielo permettono di nuovo | | `/reset` | — | entrambe, amministratori in un gruppo | Cancella la cronologia di questa chat | | `/regenerate` | — | entrambe | Rigenera l'ultima risposta | | `/suggest` | — | entrambe | Tre risposte suggerite | | `/account` | — | entrambe | Crediti e stato dell'abbonamento | | `/daily` | — | privata | Riscuote il tuo premio giornaliero | | `/notify` | — | privata | Se i personaggi possono scriverti per primi, e quali notifiche arrivano qui | | `/buy` | — | privata | Compra un abbonamento o un pacchetto di crediti con le Telegram Stars | | `/app` | — | entrambe | Apre la Mini App di Reverie | | `/paysupport` | — | entrambe | Assistenza pagamenti. Registrato ma non elencato nel menu | `/plugins` elenca i plugin di prompt e di strumento attivi in questa chat e, per gli amministratori o chi ha aggiunto un personaggio, offre pulsanti per installare i plugin ufficiali e i tuoi, rimuoverli o attivarli e disattivarli. Un plugin che richiede impostazioni da compilare non si può installare dal bot. Il risultato di un plugin di strumento viene pubblicato nella chat come breve scheda. ### Impostazioni \[#settings] `/settings` apre un menu in linea, oppure vai dritto a una pagina con `/settings model`, `language`, `mode`, `style`, `payment` o `limit`. | Voce del menu | Ambito | Solo admin nei gruppi | | ---------------------- | ----------------------------------------------------------- | --------------------- | | **Model (personal)** | Il tuo modello per il personaggio principale di questa chat | no | | **Language (chat)** | Lingua di risposta della chat | sì | | **Chat mode** | Rispondere a tutto, o solo quando si è interpellati | sì | | **Chat style** | Prosa da gioco di ruolo, o solo dialogo | sì | | **Payment mode** | Paga il proprietario o paga chi scrive | sì | | **Daily credit limit** | Tetto di crediti per giorno UTC | sì | Nella chat privata il menu offre \*\*Model (personal)\*\*, **Reply language** e **Chat style**: una chat privata risponde sempre, e paghi tu i tuoi messaggi. In un gruppo, i menu e i messaggi di errore si cancellano da soli dopo poco, per tenere la chat in ordine. ## Gruppi e canali \[#groups-and-channels] In un gruppo i personaggi rispondono quando vengono **@menzionati** o quando **rispondi** a un loro messaggio: la risposta automatica è disattivata di default, quindi aggiungere un personaggio a un gruppo vivace non lo fa parlare sopra tutti. `/settings mode` la attiva. Se entrando il bot ha detto di vedere solo i messaggi che lo menzionano o gli rispondono, rendilo amministratore del gruppo: la risposta automatica deve vedere ogni messaggio. In un gruppo con argomenti, ogni risposta finisce nell'argomento a cui risponde. Il gruppo mantiene un solo cast e una sola cronologia in tutti i suoi argomenti. Il bot può anche pubblicare in un **canale** Telegram quando è stato reso amministratore lì. ## Regole del gruppo \[#group-rules] Invia `/group` nel gruppo. Il pannello si apre nella tua chat privata con il bot, così il gruppo non ti guarda mentre lo regoli; se non hai mai avviato una chat privata con il bot, prima ti chiede di aprirne una. Possono usarlo gli amministratori del gruppo e chi paga i suoi personaggi. Mostra i consumi di oggi e degli ultimi sette giorni, i membri che hanno speso di più oggi e le regole: | Regola | Scelte | | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | **Chi può parlare** | **Tutti** (predefinito) o **Solo amministratori** | | **Limite giornaliero per membro** | Quanti crediti dell'host un membro può spendere per giorno UTC, oppure **Nessun limite** (predefinito). Vale solo dove paga l'host | | **Membri bloccati** | Rispondi `/block` al messaggio di un membro nel gruppo per impedirgli di parlare con i personaggi; `/unblock`, inviato allo stesso modo, annulla | Gli amministratori e l'account che paga non restano mai fuori, né per un blocco né per la modalità di accesso. Un membro escluso dalla modalità di accesso viene avvisato una volta che solo alcuni membri possono parlare con i personaggi; un membro bloccato non riceve nessuna risposta. ## Condividere un personaggio \[#sharing-a-character] In qualsiasi chat di Telegram, anche una in cui il bot non c'è, digita il @nomeutente del bot seguito dal nome di un personaggio e scegline uno dall'elenco. Viene pubblicata una scheda il cui pulsante apre una chat a tu per tu con quel personaggio nel bot. Sono proposti solo personaggi pubblici che non sono 18+. ## La Mini App \[#the-mini-app] `/app` apre Reverie dentro il browser di Telegram, già connessa con il tuo account Telegram — l'app completa, con i tuoi personaggi, le tue chat e i tuoi crediti. Se il bot risponde che l'app non è disponibile, la Mini App non è attiva: apri Reverie nel tuo browser. ## Pagare con le Telegram Stars \[#paying-with-telegram-stars] `/buy` svolge tutto l'acquisto dentro Telegram. Se non sei abbonato scegli tra un piano e un pacchetto crediti; se lo sei già vai dritto ai pacchetti crediti con il bonus da abbonato già applicato. Sceglierne uno pubblica una fattura Stars nativa con un pulsante **Pay**. `/buy` è limitato alle chat private: una fattura in un gruppo addebiterebbe chi la tocca. ## Chi paga \[#who-pays] | Modalità di pagamento | Addebitato a | Limiti che valgono | | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | | **Owner pays** (predefinita) | L'host del gruppo: l'account Reverie che per primo ha aggiunto un personaggio al gruppo, finché qualcun altro non subentra | Il limite giornaliero di crediti del gruppo e il limite giornaliero per membro impostato con `/group` | | **User pays** | Il saldo di chi scrive | Nessuno: ogni membro è limitato dal proprio saldo | I messaggi costano quanto nell'app web. I contatori giornalieri si azzerano alle **00:00 UTC**. Per passare il conto di un gruppo sul tuo account, apri `/group` e premi **Paga con il mio account**. Nella tua chat privata paghi sempre tu i tuoi messaggi. ## Cosa funziona in Telegram \[#what-works-in-telegram] * **Immagini.** I personaggi possono generare immagini. * **Voce in uscita.** I personaggi possono inviare messaggi vocali. * **Voce in entrata.** Note vocali e file audio vengono trascritti, fino a **25 MB**. * **Memoria.** I personaggi salvano e aggiornano ricordi quando il modello gestisce gli strumenti, e il canone dei world book entra nel loro contesto. * **Cronologia.** Le chat lunghe vengono riassunte automaticamente man mano che crescono. ## Notifiche e premio giornaliero \[#notifications-and-check-ins] `/notify` regola due cose. **Personaggi che ti scrivono per primi** è il livello di proattività del tuo account, la stessa impostazione del sito: con un abbonamento, il personaggio con cui stai parlando nella chat privata può scriverti per primo; vedi [Messaggi di iniziativa](https://reverie.im/it/docs/chatting/proactive-messages). **Ricevi anche qui** sceglie quali delle tue notifiche di Reverie arrivano anche nella tua chat privata; all'inizio è attiva solo **Account e fatturazione**; vedi [Notifiche](https://reverie.im/it/docs/account/notifications). La dashboard delle integrazioni offre le stesse scelte. `/daily` riscuote il tuo [premio giornaliero](https://reverie.im/it/docs/rewards/daily-check-in), lo stesso del sito, e apre l'estrazione fortunata nella Mini App. ## Limiti \[#limits] | Limite | Valore | | --------------------------------------- | --------------- | | Personaggi per chat | 5 | | Lunghezza del messaggio | 4.096 caratteri | | Dimensione dell'ingresso vocale | 25 MB | | Messaggi in coda per chat | 3 | | Risultati di ricerca mostrati da `/add` | 8 | I messaggi rapidi e consecutivi della stessa persona vengono uniti in un solo turno. ## Scollegare \[#unlinking] Scollega dalla dashboard delle integrazioni con **Unlink Account**. > Bloccare il bot su Telegram non scollega il tuo account. Togliere il bot da un gruppo disattiva soltanto i personaggi di quel gruppo. Usa **Unlink Account** nell'app. ## Correlati \[#related] * [Bot Discord](https://reverie.im/it/docs/integrations/discord-bot) — gli stessi personaggi, in un server * [Reverie Labs](https://reverie.im/it/docs/integrations/labs) — dove sta la dashboard delle integrazioni * [Crediti](https://reverie.im/it/docs/billing/credits) — quanto costa un messaggio * [Abbonamenti](https://reverie.im/it/docs/billing/subscriptions) — cosa comprende un piano