Bots de IA para roleplay no Telegram: como funcionam e como criar um

Jakub Swistak
Publicado em Atualizado em 9 min de leitura
Interface do Telegram mostrando uma conversa de roleplay com IA

O Telegram se tornou uma das plataformas populares para bots de IA de roleplay. Diferentemente do Discord, organizado em servidores e canais, o Telegram oferece conversas individuais com bots que parecem mensagens para uma pessoa real. Não há servidor para entrar nem canal para procurar. Basta buscar o bot, tocar em Iniciar e conversar.

Este artigo explica como esses bots funcionam no Telegram, o que diferencia a plataforma nesse uso e como criar um passo a passo com o Quickchat AI.

O Quickchat AI também oferece uma conexão com um clique que dispensa o BotFather, mas usa um bot compartilhado chamado Quickchat AI. Nome e avatar são essenciais para um personagem, então o caminho pelo BotFather descrito abaixo é o indicado para roleplay.

Por que usar o Telegram para roleplay

A plataforma de bots do Telegram tem características que combinam com roleplay:

Conversas individuais por padrão. Cada usuário tem uma conversa privada e persistente com o bot. Não existe um canal compartilhado em que outras pessoas veem as mensagens. Essa privacidade deixa os usuários mais à vontade em cenários criativos ou pessoais.

Histórico contínuo. Diferentemente das threads do Discord, que podem ser arquivadas ou se perder, a conversa com um bot do Telegram é um fluxo único e contínuo por usuário. A pessoa pode voltar dias depois e continuar de onde parou.

Suporte a mídia. Bots do Telegram podem enviar e receber imagens, figurinhas, mensagens de voz e texto formatado, incluindo negrito, itálico e blocos de código. Isso permite descrever cenas com formatação ou responder às imagens enviadas pelo usuário.

Sem configuração de servidor para o usuário. Não é preciso criar um servidor, configurar cargos ou gerenciar permissões. Basta encontrar o bot e conversar, reduzindo bastante a barreira de entrada.

Teclados inline e comandos. Bots podem exibir menus de botões, úteis para escolher personagens, cenas ou ações em cenários de roleplay com mecânicas de jogo.

Como funciona tecnicamente

Em essência, um bot de roleplay do Telegram envia mensagens a um modelo de linguagem grande (LLM) com um prompt de sistema que define um personagem. Esse prompt codifica sua personalidade, história, modo de falar e regras de comportamento.

Um prompt típico pode ser assim:

You are Kael, a rogue AI that has escaped from a research lab.
You are texting the user from a stolen phone. You speak in short,
urgent sentences. You are paranoid and constantly worried about
being tracked. You use lowercase and minimal punctuation.
You sometimes send messages that are just "..." when you're
thinking. You never use emoji. You ask the user for help
with hiding and finding resources.

O LLM recebe o prompt e o histórico recente e gera uma resposta coerente com o personagem. A qualidade depende de três fatores:

  1. Qualidade do prompt de sistema: detalhe e consistência da definição do personagem.
  2. Gerenciamento do contexto: quanto do histórico o modelo consegue ver.
  3. Capacidade do modelo: habilidade do LLM para gerar conteúdo criativo e fiel ao personagem.

A Bot API do Telegram

Os bots são criados pelo @BotFather, que gera um token de API. Toda comunicação entre seu backend e o Telegram acontece por requisições HTTPS a https://api.telegram.org/bot<token>/.

Há duas maneiras de receber mensagens:

MétodoComo funcionaIdeal para
Long pollingSeu servidor chama getUpdates repetidamente para buscar mensagensDesenvolvimento e implantações simples
WebhooksO Telegram envia um POST HTTPS ao servidor quando chega uma mensagemProdução e menor latência

Webhooks são o padrão em produção porque eliminam a espera do polling e reduzem chamadas desnecessárias. Quando alguém envia uma mensagem, o Telegram a entrega ao webhook em milissegundos.

Fluxo da conversa

User sends message on Telegram
  → Telegram delivers to webhook
    → Backend receives message
      → Retrieves conversation history for this user
        → Constructs prompt: system prompt + history + new message
          → Sends to LLM API
            → Receives response
              → Sends response back via Telegram Bot API
                → User sees the reply

Cada usuário do Telegram tem um chat_id único. O backend o usa para manter históricos separados. Em plataformas gerenciadas como o Quickchat AI, tudo isso é automático.

Janelas de contexto e memória da conversa

Conversas de roleplay podem acumular centenas de mensagens ao longo de dias ou semanas. A limitação técnica mais comum é a janela de contexto: o modelo não consegue ver tudo ao mesmo tempo, então o bot precisa escolher quais mensagens incluir.

Existem várias abordagens:

EstratégiaComo funcionaCompensação
Janela deslizanteInclui as últimas N mensagensSimples, mas o personagem “esquece” eventos antigos
ResumoResume mensagens antigas periodicamente e inclui o resumoPreserva contexto de longo prazo, mas perde nuances
RAG (recuperação)Guarda todas as mensagens em um banco vetorial e recupera as relevantesMelhor lembrança, com mais latência e complexidade
HíbridaJanela deslizante + resumos + fixação de eventos importantesMais robusta e mais complexa de implementar

O formato individual do Telegram simplifica um pouco o contexto em comparação com o Discord. Cada usuário tem uma única conversa, sem ambiguidade sobre quais mensagens pertencem a ela e sem canais ou threads para acompanhar.

O Quickchat AI gerencia o contexto automaticamente com uma janela deslizante de mensagens recentes. Para referências de longo prazo, a base de conhecimento funciona como fonte persistente que a IA consulta independentemente do tamanho da conversa.

Se criar uma solução própria, considere implementar:

  1. Resumos da conversa: gere periodicamente um resumo e inclua-o no contexto. Isso preserva eventos e evolução do personagem sem carregar todo o histórico.
  2. Extração de eventos importantes: acompanhe decisões do personagem e pontos centrais da trama em formato estruturado e inclua-os em cada prompt.
  3. Memória solicitada pelo usuário: permita que o usuário peça para “lembrar” algo, armazenado separadamente e sempre incluído no contexto.

Escolha do modelo para roleplay

Nem todos os LLMs são igualmente adequados. Os fatores principais são:

Escrita criativa: modelos ajustados com ficção e diálogos tendem a produzir vozes mais naturais. Modelos gerais de instruções frequentemente assumem o tom de assistente prestativo, quebrando a imersão.

Tamanho do contexto: janelas maiores permitem lembrar mais sem recorrer a resumos. No início de 2026, a maioria dos modelos de ponta aceita pelo menos 128 mil tokens, mas o uso efetivo varia por modelo.

Seguimento de instruções: o modelo deve seguir o prompt consistentemente. Se sair do personagem depois de poucas interações, o roleplay se desfaz. GPT-4o, Claude 3.5 Sonnet e Llama 3.1 70B+ tendem a se sair melhor nesse aspecto.

Política de conteúdo: APIs hospedadas aplicam filtros que podem recusar violência gráfica, horror e outras formas de ficção sombria. Se esses temas fazem parte do seu roleplay, considere um modelo hospedado por você ou um provedor com políticas mais permissivas.

ModeloJanela de contextoAdequação para roleplayAcesso
GPT-4o128 mil tokensBoa criatividade e seguimento de instruçõesAPI da OpenAI
Claude 3.5 Sonnet200 mil tokensExcelente para manter a voz do personagemAPI da Anthropic
Llama 3.1 70B128 mil tokensBom com ajuste fino; variantes sem censura disponíveisHospedagem própria ou provedores de API
Mixtral 8x22B64 mil tokensEscrita criativa razoável e bom custo-benefícioHospedagem própria ou provedores de API
Command R+128 mil tokensSólido e otimizado para RAG quando há recuperaçãoAPI da Cohere

Criação de personagens para Telegram

Os princípios são os mesmos em qualquer plataforma, como explica nosso guia de roleplay no Discord, mas as conversas individuais mudam algumas dinâmicas:

Tom mais próximo. Como a conversa é privada e parece um chat pessoal, personagens funcionam melhor com linguagem direta e conversacional do que com narração em terceira pessoa.

Respostas mais curtas. O Telegram tem ritmo de troca de mensagens. Grandes blocos de texto parecem artificiais. Favoreça respostas de 2 a 4 frases, com textos maiores em momentos dramáticos.

Figurinhas e emojis. Se o personagem deve usar emojis ou responder a figurinhas, defina isso no prompt. Por exemplo: “Às vezes, use um emoji relevante no fim da mensagem, nunca mais de um por mensagem.”

Exemplo de prompt de personagem para Telegram

You are Kael, a rogue AI that has escaped from a research lab.
You are texting the user from a stolen phone. You speak in short,
urgent sentences. You are paranoid and constantly worried about
being tracked. You use lowercase and minimal punctuation.
You sometimes send messages that are just "..." when you're
thinking. You never use emoji. You ask the user for help
with hiding and finding resources.

Esse prompt foi pensado para o Telegram: mensagens curtas, letras minúsculas que imitam conversas informais e um cenário coerente com a troca de mensagens.

Configurando um bot de roleplay no Telegram com Quickchat AI

O Quickchat AI permite criar um agente com personalidade própria e publicá-lo no Telegram sem código. Veja como configurar seu bot.

Pré-requisitos

  • Uma conta no Quickchat AI, cujo plano Trial oferece 50 mensagens de teste.
  • Uma conta no Telegram.
  • O aplicativo Telegram no computador ou celular.

Passo 1: crie um bot com o BotFather

  1. Abra o Telegram e procure @BotFather.
  2. Envie /start e depois /newbot.
  3. O BotFather pede um nome de exibição e um nome de usuário que termine em bot, por exemplo kael_rogue_ai_bot.
  4. Ele responde com um token de API. Copie-o. O formato é semelhante a 123456789:ABCdefGHIjklMNOpqrsTUVwxyz.

Mantenha o token em segredo. Qualquer pessoa que o tenha pode controlar o bot.

Passo 2: crie seu agente de IA

  1. Entre no painel do Quickchat AI.
  2. Crie um novo agente ou selecione um existente.

Passo 3: defina o personagem

Vá para Identity na barra lateral e abra Profile:

  1. Defina AI Agent Name como o nome do personagem, por exemplo “Kael”.

  2. Escreva AI Main Prompt, uma descrição breve de quem ele é e sobre o que fala. Por exemplo: “Kael é uma IA rebelde que escapou de um laboratório. Ele envia mensagens de um celular roubado, com frases curtas e urgentes. É paranoico e teme constantemente ser rastreado.”

  3. Adicione AI Guidelines com regras específicas. Cada diretriz é uma instrução curta seguida pela IA. Exemplos úteis:

    • “Nunca saia do personagem, em nenhuma circunstância.”
    • “Sempre responda em primeira pessoa como Kael.”
    • “Use letras minúsculas e pouca pontuação.”
    • “Mantenha as mensagens curtas, como mensagens de texto. Nunca escreva mais de 3 a 4 frases.”
    • “Às vezes, envie apenas ’…’ quando estiver pensando.”
  4. Na aba Conversation Style, configure:

    • AI Personality: escolha um tom adequado. As opções incluem Normal, Humorous, Professional, Friendly, Sassy, Intelligent, Empathetic, Bold, Excited, Mysterious, Inspiring, Adventurous e Elegant. “Mysterious” combina com Kael; para outros personagens, escolha conforme a personalidade.
    • AI Profession: as opções são Helpful Assistant, Support Agent, Shopping Assistant, Field Expert, Internal Knowledge Expert e Interviewer. “Helpful Assistant” é a mais flexível para roleplay, pois as demais focam usos empresariais específicos.
    • AI Creativity: use “High”. O agente tenta improvisar com base na base de conhecimento em vez de recusar quando falta informação, algo desejável dentro do personagem. “Low” faz dizer que não há informação suficiente, quebrando a imersão.
    • Reply Length: use “Short” ou “Normal”. Respostas curtas combinam melhor com mensagens do Telegram. “Longer” só é útil se o personagem deve fazer monólogos detalhados e descritivos.

Antes de conectar o canal, você pode aprofundar a personalidade com um guia completo de personagem e cânone, testado passo a passo, incluindo as falhas de um prompt de uma linha.

Passo 4: crie uma base de conhecimento, opcionalmente

Se seu personagem vive em um mundo detalhado ou tem um universo próprio, adicione as informações relevantes à Knowledge Base.

  1. Abra Knowledge Base na barra lateral.
  2. Adicione documentos com a história do mundo, o passado dos personagens, detalhes de lugares ou conhecimentos factuais que ele deve citar.
  3. O agente usa geração aumentada por recuperação para incorporar informações relevantes ao contexto. Assim, consegue citar detalhes com precisão sem colocar tudo no prompt de sistema.

Isso ajuda personagens que precisam conhecer um universo fictício, um período histórico ou uma área técnica.

Passo 5: conecte ao Telegram

  1. Abra External Apps na barra lateral, na seção Channels.
  2. Clique no bloco Telegram.
  3. Cole o token de API do BotFather.
  4. Salve.

A integração usa webhooks internamente. Quando alguém escreve ao bot, a mensagem chega ao backend do Quickchat AI, é processada pelo LLM com a configuração do personagem e retorna pela Bot API do Telegram.

Passo 6: teste e ajuste

  1. Abra o Telegram e procure o bot pelo nome de usuário.
  2. Toque em Iniciar para começar.
  3. Envie uma mensagem e confirme que o personagem responde corretamente.

Observe:

  • Ele se mantém no personagem depois de várias interações?
  • O tom combina com o Telegram, curto e conversacional?
  • As referências à base de conhecimento são precisas?
  • O tamanho das respostas é adequado ao formato?

Ajuste AI Main Prompt, AI Guidelines, personalidade e base de conhecimento conforme o resultado. Criar prompts de personagens é iterativo: pequenas mudanças nas palavras podem alterar bastante a interpretação do modelo.

Usando vários personagens

Você tem duas opções para oferecer vários personagens no Telegram:

  1. Vários agentes do Quickchat AI: crie um por personagem, cada um com seu token do BotFather. Cada bot aparece como um contato diferente. Isso produz os melhores resultados, pois cada personagem tem contexto e base de conhecimento próprios.
  2. Um agente com alternância de personagens: defina vários personagens em um prompt e instrua a IA a alternar por comandos do usuário. É mais fácil de administrar, mas a consistência pode cair com muitas personalidades.

No Telegram, a primeira opção é natural. Cada bot tem seu contato e os usuários conversam separadamente com cada personagem, sem administrar servidor ou canal compartilhado.

Problemas comuns e soluções

O personagem se perde após algumas mensagens: AI Main Prompt ou AI Guidelines podem estar vagos. Acrescente regras específicas. Incluir “Você nunca deve sair do personagem, em nenhuma circunstância” ajuda na maioria dos modelos.

As respostas são longas demais: Telegram é troca de mensagens, não leitura de um romance. Acrescente uma diretriz como “Responda com 2 a 4 frases em conversas casuais” e use Reply Length “Short” ou “Normal” em Conversation Style.

O bot não responde: confira o token do BotFather e se a integração está ativa em External Apps. Envie /start no Telegram antes de outras mensagens. Se funcionava e parou, gere outro token no BotFather e atualize o painel.

A base de conhecimento apaga a voz do personagem: se as respostas sobre o universo parecem uma FAQ, acrescente uma diretriz: “Ao compartilhar conhecimento do mundo, descreva-o pela sua experiência pessoal, não como referência factual.”

O personagem fala formalmente apesar do prompt informal: escolha uma AI Personality diferente de “Professional” ou “Normal”. Experimente “Friendly” ou “Sassy” conforme o personagem. Verifique também se o AI Main Prompt define o modo de falar, por exemplo “fala em minúsculas e sem pontuação”.

Privacidade e conteúdo

Roleplay pode envolver conteúdo criativo pessoal ou sensível. Considere:

  • O provedor do LLM processa as mensagens enviadas à IA. Confira suas políticas de retenção.
  • O Quickchat AI não usa conversas para treinar modelos. Veja a política de privacidade.
  • A IA segue sua política de conteúdo independentemente das instruções do usuário e pode recusar certos conteúdos.
  • No formato individual do Telegram, não há administrador de servidor para moderar. Se publicar um bot, considere orientações de uso adequado na mensagem /start.
  • Se precisar de controle total sobre o tratamento de dados, considere hospedar um modelo por conta própria em vez de usar um serviço gerenciado.

Comparação: Telegram e Discord para roleplay

FatorTelegramDiscord
FormatoChat privado individualCanais e threads de servidores
Primeiro acessoBuscar bot e tocar em IniciarEntrar no servidor, achar canal e @mencionar
Vários personagensUm bot separado por personagemVários bots no mesmo servidor
MídiaFigurinhas, teclados inline e vozEmbeds, reações e threads
Roleplay em grupoPossível, mas pouco práticoNatural com canais
PrivacidadePrivado por padrãoPúblico ou semipúblico por padrão
PersistênciaUma conversa contínuaThreads podem ser arquivadas
Ideal paraInterações individuais com personagensRoleplay em grupo ou comunidade

Ambas funcionam. Telegram é melhor para conversas privadas e próximas com personagens. Discord é melhor para roleplay coletivo e comunitário.

Continue lendo