Bot AI di roleplay su Telegram: come funzionano

Jakub Swistak
Pubblicato Aggiornato 11 min di lettura
Interfaccia chat di Telegram che mostra una conversazione di roleplay con AI

Telegram è diventata una delle piattaforme più diffuse per i bot AI di roleplay. A differenza di Discord, dove le conversazioni sono organizzate in server e canali, Telegram offre chat 1 a 1 con bot che sembrano messaggi con una persona reale. Non c’è nessun server a cui unirsi, nessun canale da trovare. Cerchi il bot, tocchi Start e inizi a parlare.

Questo articolo spiega come funzionano i bot AI di roleplay su Telegram, cosa rende Telegram diversa dalle altre piattaforme per questo caso d’uso e come crearne uno passo passo usando Quickchat AI.

Quickchat AI include anche un flusso Telegram con un clic che evita BotFather, ma usa un bot condiviso chiamato Quickchat AI. Un bot personaggio dipende dal suo nome e dal suo avatar, quindi per il roleplay la strada con BotFather descritta sotto è quella corretta.

Perché usare Telegram per il roleplay

La piattaforma bot di Telegram ha alcune caratteristiche che la rendono adatta al roleplay:

Conversazioni 1 a 1 per impostazione predefinita. Ogni utente ha una conversazione privata e persistente con il bot. Non c’è un canale condiviso in cui altre persone vedono i tuoi messaggi. Questa privacy rende gli utenti più propensi a partecipare a scenari di roleplay creativi o personali.

Thread di conversazione persistente. A differenza dei thread di Discord, che possono essere archiviati o persi, una conversazione con un bot Telegram è un singolo thread continuo per ogni utente. L’utente può tornare giorni dopo e riprendere da dove aveva lasciato.

Supporto per contenuti multimediali avanzati. I bot Telegram possono inviare e ricevere immagini, sticker, messaggi vocali e testo formattato (grassetto, corsivo, blocchi di codice e così via). Questo consente interazioni di roleplay più ricche, in cui il bot può descrivere scene con formattazione o rispondere alle immagini inviate dall’utente.

Nessuna configurazione di server richiesta agli utenti. Gli utenti non devono creare un server Discord, configurare ruoli o gestire permessi. Trovano il bot e iniziano a chattare. Questo riduce notevolmente la barriera d’ingresso.

Tastiere inline e comandi. I bot Telegram possono mostrare menu con pulsanti inline, utili per elementi come la selezione del personaggio, le scelte di scena o le opzioni di azione in scenari di roleplay simili a giochi.

Come funziona dal punto di vista tecnico

A livello di base, un bot di roleplay su Telegram invia i messaggi dell’utente a un large language model (LLM) con un prompt di sistema che definisce un personaggio. Nel prompt di sistema vengono codificati personalità, storia, modo di parlare e regole comportamentali del personaggio.

Un tipico prompt di sistema per un personaggio di roleplay potrebbe essere simile a questo:

Sei Kael, una AI ribelle fuggita da un laboratorio di ricerca.
Stai scrivendo all'utente da un telefono rubato. Parli con frasi brevi
e urgenti. Sei paranoico e costantemente preoccupato di
essere tracciato. Usi lettere minuscole e punteggiatura minima.
A volte invii messaggi che sono solo "..." quando stai
pensando. Non usi mai emoji. Chiedi aiuto all'utente
per nasconderti e trovare risorse.

L’LLM riceve questo prompt insieme alla cronologia recente della conversazione e genera una risposta coerente con il personaggio. La qualità del roleplay dipende da tre aspetti:

  1. Qualità del prompt di sistema: quanto è dettagliata e coerente la definizione del personaggio
  2. Gestione della finestra di contesto: quanta cronologia della conversazione vede il modello
  3. Capacità del modello: quanto bene l’LLM sottostante gestisce una generazione creativa e coerente con il personaggio

La Telegram Bot API

I bot Telegram vengono creati tramite @BotFather, che genera un token API. Tutta la comunicazione tra il tuo backend e Telegram avviene tramite richieste HTTPS a https://api.telegram.org/bot<token>/.

Ci sono due modi per ricevere i messaggi in arrivo:

MetodoCome funzionaIdeale per
Long pollingIl tuo server chiama ripetutamente getUpdates per controllare nuovi messaggiSviluppo, deployment semplici
WebhooksTelegram invia un POST HTTPS al tuo server ogni volta che arriva un messaggioProduzione, latenza inferiore

I webhook sono lo standard per i bot in produzione perché eliminano il ritardo del polling e riducono le chiamate API non necessarie. Quando un utente invia un messaggio, Telegram lo consegna al tuo URL webhook in pochi millisecondi.

Flusso della conversazione

L'utente invia un messaggio su Telegram
  → Telegram lo consegna al webhook
    → Il backend riceve il messaggio
      → Recupera la cronologia della conversazione per questo utente
        → Costruisce il prompt: prompt di sistema + cronologia + nuovo messaggio
          → Invia alla API dell'LLM
            → Riceve la risposta
              → Invia la risposta tramite la Telegram Bot API
                → L'utente vede la risposta

Ogni utente Telegram ha un chat_id univoco. Il backend lo usa per mantenere cronologie di conversazione separate. Quando usi una piattaforma gestita come Quickchat AI, tutto questo viene gestito automaticamente.

Finestre di contesto e memoria della conversazione

Le conversazioni di roleplay su Telegram possono durare centinaia di messaggi nell’arco di giorni o settimane. La limitazione tecnica più comune è la dimensione della finestra di contesto. Quando una conversazione diventa così lunga, il modello non può vedere tutti i messaggi insieme. Il bot deve selezionare quali messaggi includere.

Ci sono diversi approcci:

StrategiaCome funzionaCompromesso
Sliding windowInclude gli ultimi N messaggiSemplice, ma i personaggi “dimenticano” eventi precedenti
RiassuntoRiassume periodicamente i messaggi più vecchi e include il riassuntoConserva il contesto a lungo termine, ma i riassunti perdono sfumature
RAG (retrieval)Memorizza tutti i messaggi in un database vettoriale e recupera quelli pertinentiMigliore richiamo, ma aggiunge latenza e complessità
IbridoSliding window + riassunti periodici + fissaggio degli eventi chiavePiù robusto, ma più complesso da implementare

Il formato 1 a 1 di Telegram rende la gestione del contesto un po’ più semplice rispetto a Discord. Ogni utente ha un unico thread di conversazione, quindi non c’è ambiguità su quali messaggi appartengano a quale conversazione. Non ci sono canali o thread da tracciare.

Quickchat AI gestisce automaticamente il contesto mantenendo una sliding window dei messaggi recenti. Per una memoria a lungo termine, la knowledge base funge da riferimento persistente che l’AI può interrogare indipendentemente dalla lunghezza della conversazione.

Se stai costruendo una soluzione personalizzata, valuta di implementare:

  1. Riassunto della conversazione: genera periodicamente un riassunto della conversazione fino a quel momento e includilo come contesto. Questo conserva eventi chiave e sviluppo del personaggio senza usare l’intera cronologia dei messaggi.
  2. Estrazione degli eventi chiave: traccia punti importanti della trama o decisioni del personaggio in un formato strutturato e includili in ogni prompt.
  3. Memoria attivata dall’utente: consenti agli utenti di dire al bot di “ricordare” cose specifiche, che vengono salvate separatamente e sempre incluse nel contesto.

Scelta del modello per il roleplay

Non tutti gli LLM sono ugualmente adatti al roleplay. I fattori principali sono:

Qualità della scrittura creativa: i modelli fine-tuned su narrativa e dialoghi tendono a produrre voci dei personaggi più naturali. I modelli base instruction-tuned spesso assumono per impostazione predefinita un tono da assistente utile che rompe l’immersione.

Dimensione della finestra di contesto: finestre di contesto più lunghe permettono al personaggio di ricordare più parti della conversazione senza trucchi di riassunto. All’inizio del 2026, la maggior parte dei modelli frontier supporta almeno 128K token, ma l’uso effettivo di quel contesto varia a seconda del modello.

Rispetto delle istruzioni: il modello deve seguire con coerenza il prompt di sistema. Se esce dal personaggio dopo pochi turni, il roleplay si interrompe. I modelli con forte capacità di seguire le istruzioni (GPT-4o, Claude 3.5 Sonnet, Llama 3.1 70B+) tendono a funzionare meglio in questo caso.

Policy sui contenuti: le API ospitate applicano filtri sui contenuti che possono rifiutare di generare violenza grafica, horror o altra narrativa creativa cupa. Se i tuoi scenari di roleplay includono questi temi, valuta un modello self-hosted o un provider API con policy sui contenuti più permissive.

ModelloFinestra di contestoIdoneità al roleplayAccesso
GPT-4o128K tokenBuon output creativo, forte rispetto delle istruzioniOpenAI API
Claude 3.5 Sonnet200K tokenEccellente nel mantenere la voce del personaggioAnthropic API
Llama 3.1 70B128K tokenBuono con fine-tuning, varianti non censurate disponibiliSelf-hosted o provider API
Mixtral 8x22B64K tokenScrittura creativa discreta, convenienteSelf-hosted o provider API
Command R+128K tokenSolido, ottimizzato per RAG se usi retrievalCohere API

Progettazione del personaggio per Telegram

I principi di progettazione del personaggio sono gli stessi su tutte le piattaforme (vedi la nostra guida al roleplay su Discord per le basi), ma il formato 1 a 1 di Telegram cambia alcune dinamiche:

Tono più intimo. Poiché la conversazione è privata e formattata come una chat personale, i personaggi tendono a funzionare meglio quando sono scritti con uno stile conversazionale e diretto, invece che con uno stile in terza persona simile a un narratore.

Risposte più brevi. Le conversazioni su Telegram hanno l’aspetto e la sensazione di una messaggistica. Risposte troppo lunghe risultano innaturali. Progetta il prompt del personaggio in modo da favorire risposte più brevi (2-4 frasi), con occasionali risposte più lunghe per i momenti drammatici.

Integrazione di sticker ed emoji. Se il personaggio deve usare emoji o rispondere agli sticker, specificalo nel prompt di sistema. Per esempio: “Ogni tanto usi emoji pertinenti alla fine dei tuoi messaggi, ma mai più di una per messaggio.”

Esempio di prompt personaggio per Telegram

Sei Kael, una AI ribelle fuggita da un laboratorio di ricerca.
Stai scrivendo all'utente da un telefono rubato. Parli con frasi brevi
e urgenti. Sei paranoico e costantemente preoccupato di
essere tracciato. Usi lettere minuscole e punteggiatura minima.
A volte invii messaggi che sono solo "..." quando stai
pensando. Non usi mai emoji. Chiedi aiuto all'utente
per nasconderti e trovare risorse.

Questo prompt è progettato specificamente per il mezzo Telegram: messaggi brevi, testo in minuscolo (che imita la messaggistica informale) e uno scenario sensato in un contesto di chat.

Configurare un bot di roleplay Telegram con Quickchat AI

Quickchat AI ti permette di creare un agente AI con una persona personalizzata e distribuirlo su Telegram senza scrivere codice. Ecco come configurare un bot adatto al roleplay.

Prerequisiti

  • Un account Quickchat AI (il piano Trial ti dà 50 messaggi per fare test)
  • Un account Telegram
  • L’app Telegram (desktop o mobile)

Passaggio 1: crea un bot Telegram con BotFather

  1. Apri Telegram e cerca @BotFather.
  2. Invia /start per iniziare, poi invia /newbot.
  3. BotFather chiederà un nome (nome visualizzato) e uno username (deve finire con bot, per esempio kael_rogue_ai_bot).
  4. BotFather risponde con un token API. Copia questo token. Ha un aspetto simile a: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz.

Mantieni privato questo token. Chiunque lo possieda può controllare il tuo bot.

Passaggio 2: crea il tuo AI Agent

  1. Accedi alla dashboard di Quickchat AI.
  2. Crea un nuovo AI Agent o selezionane uno esistente.

Passaggio 3: definisci il personaggio

Vai a Identity nella sidebar e apri la scheda Profile:

  1. Imposta AI Agent Name sul nome del tuo personaggio (per esempio, “Kael”).

  2. Scrivi AI Main Prompt. Questa è una breve descrizione di chi è il personaggio e di cosa parla. Per esempio: “Kael è una AI ribelle fuggita da un laboratorio di ricerca. Sta scrivendo all’utente da un telefono rubato, parlando con frasi brevi e urgenti. È paranoico e costantemente preoccupato di essere tracciato.”

  3. Aggiungi AI Guidelines per regole comportamentali specifiche. Ogni guideline è un breve comando che l’AI segue. Per un personaggio di roleplay, guideline utili includono:

    • “Non uscire mai dal personaggio in nessuna circostanza.”
    • “Rispondi sempre in prima persona come Kael.”
    • “Usa lettere minuscole e punteggiatura minima.”
    • “Mantieni i messaggi brevi, come messaggi di testo. Non scrivere mai più di 3-4 frasi.”
    • “A volte invia messaggi che sono solo ’…’ quando pensi.”
  4. Nella scheda Conversation Style, configura quanto segue:

    • AI Personality: scegli un tono adatto al tuo personaggio. Le opzioni includono Normal, Humorous, Professional, Friendly, Sassy, Intelligent, Empathetic, Bold, Excited, Mysterious, Inspiring, Adventurous ed Elegant. Per il personaggio Kael, “Mysterious” funziona bene. Per altri personaggi di roleplay, scegli quello che corrisponde alla loro personalità.
    • AI Profession: le opzioni disponibili sono Helpful Assistant, Support Agent, Shopping Assistant, Field Expert, Internal Knowledge Expert e Interviewer. Per un personaggio di roleplay, “Helpful Assistant” è la scelta più flessibile, perché le altre opzioni sono orientate a casi d’uso aziendali specifici.
    • AI Creativity: impostala su “High” per il roleplay. Con “High”, l’agente proverà a improvvisare risposte basate sulla Knowledge Base invece di rifiutare quando gli mancano informazioni, che è ciò che serve per risposte in-character. “Low” fa dire esplicitamente all’agente che non ha abbastanza informazioni, rompendo l’immersione.
    • Reply Length: impostala su “Short” o “Normal” per il roleplay su Telegram. Le conversazioni Telegram sembrano messaggistica, quindi risposte più brevi tendono a funzionare meglio dei paragrafi lunghi. “Longer” è utile solo se il tuo personaggio deve fare monologhi dettagliati e descrittivi.

Se vuoi approfondire il personaggio prima di collegare il canale, c’è una guida completa alla persona e al canone per roleplay, testata passo passo, inclusi i problemi tipici di un prompt di una sola riga.

Passaggio 4: costruisci una knowledge base per il tuo personaggio (opzionale)

Se il tuo personaggio esiste in un mondo dettagliato o ha una lore specifica, aggiungi le informazioni pertinenti alla Knowledge Base.

  1. Vai a Knowledge Base nella sidebar.
  2. Aggiungi articoli o documenti contenenti lore del mondo, storie dei personaggi, dettagli sui luoghi o qualsiasi conoscenza fattuale a cui il personaggio dovrebbe fare riferimento.
  3. L’agente AI usa retrieval-augmented generation per inserire nel suo contesto le conoscenze pertinenti quando risponde alle domande, così il personaggio può fare riferimento a una lore dettagliata in modo accurato senza inserirla tutta nel prompt di sistema.

Questo è utile per personaggi che devono conoscere uno specifico universo narrativo, periodo storico o dominio tecnico.

Passaggio 5: collega Telegram

  1. Vai a External Apps nella sidebar (sotto la sezione Channels).
  2. Trova il riquadro Telegram e fai clic.
  3. Incolla il token API ricevuto da BotFather.
  4. Salva.

L’integrazione usa webhook internamente. Quando un utente invia un messaggio al tuo bot su Telegram, il messaggio viene instradato al backend di Quickchat AI, elaborato dall’LLM con la configurazione del tuo personaggio e la risposta viene inviata tramite la Telegram Bot API.

Passaggio 6: testa e itera

  1. Apri Telegram e cerca il tuo bot tramite il suo username.
  2. Tocca Start per iniziare la conversazione.
  3. Invia un messaggio e verifica che il personaggio risponda correttamente.

Presta attenzione a:

  • Il personaggio resta in-character dopo diversi scambi?
  • Il tono è corretto per una conversazione Telegram (breve, conversazionale)?
  • I riferimenti alla knowledge base sono accurati?
  • La lunghezza della risposta è adatta al formato di messaggistica?

Regola AI Main Prompt, AI Guidelines, l’impostazione della personalità e il contenuto della knowledge base in base a ciò che osservi. Il prompt engineering per i personaggi è iterativo. Piccole modifiche alle formulazioni possono influire in modo significativo su come il modello interpreta il personaggio.

Gestire più personaggi

Se vuoi offrire più personaggi di roleplay su Telegram, hai due opzioni:

  1. Più agenti Quickchat AI: crea un agente AI separato per ogni personaggio, ciascuno con il proprio token BotFather. Ogni bot appare come contatto diverso in Telegram. Questo produce i risultati migliori perché ogni personaggio ha il proprio contesto dedicato e la propria knowledge base.
  2. Un singolo agente con cambio personaggio: usa un agente con un prompt di sistema che definisce più personaggi e istruisce l’AI a cambiare in base ai comandi dell’utente. È più semplice da gestire, ma la coerenza dei personaggi può degradare con molte persona.

Su Telegram, l’opzione 1 è la scelta più naturale. Ogni bot è un contatto separato e gli utenti possono avere conversazioni distinte con ogni personaggio. Non c’è un server o un canale condiviso da gestire.

Problemi comuni e correzioni

Il personaggio si interrompe dopo pochi messaggi: AI Main Prompt o AI Guidelines potrebbero essere troppo vaghi. Aggiungi regole comportamentali più specifiche. Aggiungere “Non devi mai uscire dal personaggio in nessuna circostanza” come guideline esplicita aiuta con la maggior parte dei modelli.

Le risposte sono troppo lunghe per Telegram: le conversazioni Telegram sembrano messaggistica, non la lettura di un romanzo. Aggiungi una guideline che specifichi la lunghezza della risposta, per esempio: “Mantieni le risposte a 2-4 frasi nelle conversazioni informali.” Imposta anche Reply Length su “Short” o “Normal” nelle impostazioni di Conversation Style.

Il bot non risponde: verifica che il token API di BotFather sia corretto e che l’integrazione Telegram sia abilitata in External Apps. Apri il bot in Telegram e invia /start prima di inviare messaggi. Se il bot funzionava prima e poi ha smesso, rigenera il token in BotFather e aggiornalo nella dashboard.

Le risposte della knowledge base sovrascrivono la voce del personaggio: se il bot inizia a sembrare un sistema FAQ quando risponde a domande sulla lore, aggiungi una guideline che sottolinei che tutte le informazioni devono essere fornite in-character. Per esempio: “Quando condividi conoscenze sul mondo, descrivile dalla tua esperienza personale, non come un riferimento fattuale.”

Il personaggio usa un linguaggio formale nonostante il prompt informale: imposta AI Personality su qualcosa di diverso da “Professional” o “Normal.” Prova “Friendly” o “Sassy” a seconda del personaggio. Controlla anche che AI Main Prompt descriva esplicitamente lo stile di linguaggio (per esempio, “parla in minuscolo senza punteggiatura”).

Considerazioni su privacy e contenuti

Le conversazioni di roleplay possono contenere contenuti creativi sensibili o personali. Alcuni aspetti da tenere presenti:

  • I messaggi inviati all’AI vengono elaborati dal provider LLM sottostante. Consulta le policy di conservazione dei dati del provider.
  • Quickchat AI non usa i dati delle conversazioni per addestrare modelli. Consulta la privacy policy per i dettagli.
  • L’AI seguirà la propria policy sui contenuti indipendentemente dalle istruzioni dell’utente, quindi alcuni tipi di contenuto potrebbero essere rifiutati.
  • Il formato 1 a 1 di Telegram significa che non c’è un amministratore del server che modera le conversazioni. Se stai distribuendo un bot pubblico, valuta di aggiungere linee guida nel messaggio /start del bot sull’uso appropriato.
  • Se hai bisogno di pieno controllo sulla gestione dei dati, valuta di ospitare autonomamente un modello invece di usare un servizio gestito.

Confronto: Telegram vs Discord per bot di roleplay

FattoreTelegramDiscord
Formato della conversazioneChat privata 1 a 1Canali/thread del server
Onboarding utenteCerca il bot, tocca StartUnisciti al server, trova il canale, @mention
Più personaggiBot separati per personaggioPiù bot nello stesso server
Contenuti multimediali avanzatiSticker, tastiere inline, voceEmbed, reazioni, thread
Roleplay di gruppoPossibile ma scomodoNaturale con i canali
PrivacyPrivato per impostazione predefinitaPubblico o semi-pubblico per impostazione predefinita
Persistenza della conversazioneSingolo thread continuoI thread possono essere archiviati
Ideale perInterazioni 1 a 1 con personaggiRoleplay di gruppo/community

Entrambe le piattaforme funzionano. Telegram è migliore per interazioni private e intime con i personaggi. Discord è migliore per roleplay guidato dalla community e multi-player.

Altre letture