Como criar um agente de IA no Telegram (guia 2026)

Você quer um agente de IA que viva dentro do Telegram. Não mais uma aba do navegador, não mais um app móvel esquecido, mas um contato na sua barra lateral que responde quando você manda mensagem, lembra do que você falou semana passada e consegue, de fato, fazer coisas em vez de só conversar.

A boa notícia é que o Telegram é a plataforma de mensageria mais amigável para isso. A Bot API é gratuita, sai em dois minutos com o BotFather e não cobra por mensagem - diferente do WhatsApp Business, que cobra por conversa e exige verificação na Meta. A notícia menos boa é que "como criar um agente de IA no Telegram" se divide em pelo menos quatro caminhos diferentes em 2026, e o certo depende de você ser uma pessoa dev que gosta de montar stacks ou alguém que quer o agente rodando até hoje à noite.

Este guia passa pelo que você realmente precisa, os quatro caminhos reais e uma árvore de decisão honesta no final.

O que é, de fato, "um agente de IA no Telegram"

Antes de escolher o stack, vale precisar o que está construindo. A expressão cobre um espectro amplo:

Um wrapper de chat simples. O bot encaminha suas mensagens para um LLM e devolve a resposta. Útil, mas esquece tudo quando o chat rola.
Um chatbot com memória. Mesmo fluxo, mas com memória de sessão ou um vector store para lembrar mensagens anteriores.
Um agente. Um processo de longa duração com personalidade, ferramentas que pode chamar (busca na web, agenda, e-mail, suas próprias APIs), memória persistente entre sessões e capacidade de executar trabalho de várias etapas por conta própria.

A maioria dos tutoriais "como montar um bot no Telegram" para no wrapper de chat. Tudo bem, se você só quer conversar. Se quer que o agente lembre do projeto que você descreveu na quarta passada ou rode um resumo diário pela manhã, precisa de memória persistente e de um scheduler - exatamente o que transforma um bot em agente.

As dimensões que pesam na hora de escolher:

Memória entre sessões: o agente lembra de você na semana que vem ou cada chat novo começa do zero?
Ferramentas e skills: ele consegue fazer coisas (enviar e-mails, buscar na web, resumir um PDF, chamar sua API) ou só conversa?
BYOK: dá pra apontar para a sua chave da OpenAI, Anthropic ou OpenRouter, ou você fica preso aos créditos embutidos do fornecedor?
Hospedagem: SaaS hospedado, no-code na nuvem, self-hosted ou runtime gerenciado.
Allowlist: dá para restringir ao seu próprio user ID do Telegram ou qualquer pessoa que descobrir o bot pode queimar seus créditos?

Memória é o diferencial que mais conta. Um chatbot responde perguntas; um agente pessoal lembra delas.

Passo zero: criar o bot no BotFather

Todos os caminhos abaixo começam pelo mesmo passo de cinco minutos, então faça isso primeiro.

Abra o Telegram, busque por @BotFather e envie /newbot. O BotFather pede duas coisas nesta ordem:

Um nome de exibição (pode ter espaços e pode ser alterado depois).
Um nome de usuário, que precisa terminar em bot e é permanente.

Quando ele aceitar os dois, o BotFather responde com um token de API parecido com 123456789:ABCdef.... Trate como senha: qualquer pessoa com esse token pode postar mensagens em nome do seu bot. Guarde em um gerenciador de senhas ou em um .env que não vai pro repositório.

Alguns comandos do BotFather úteis desde o primeiro dia:

/setdescription: a introdução curta que os usuários veem ao abrir o chat.
/setcommands: o menu de autocompletar dos comandos de barra.
/setprivacy: em grupos, defina como "Disable" se quiser que o bot veja todas as mensagens, não só as menções.

Dois detalhes que costumam surpreender iniciantes. Primeiro, a Bot API do Telegram é realmente gratuita e sem cobrança por mensagem, mesmo em escala. Segundo, por padrão um bot só inicia conversa depois que o usuário manda a primeira mensagem - então, em desenvolvimento, mande uma mensagem para o seu próprio bot antes de esperar resposta.

Caminho 1: Python do zero (BotFather + python-telegram-bot + OpenAI)

O caminho clássico de quem programa. Você escreve um pequeno serviço em Python que conecta a Bot API do Telegram a uma API de LLM e decide o que acontece no meio.

O stack ao qual quase todo mundo converge:

# requirements.txt
python-telegram-bot==22.1
openai==1.40.0
python-dotenv==1.0.1

O loop mínimo é:

from telegram.ext import Application, MessageHandler, filters
from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])

async def reply(update, context):
    msg = update.message.text
    answer = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": msg}],
    ).choices[0].message.content
    await update.message.reply_text(answer)

app = Application.builder().token(os.environ["TELEGRAM_BOT_TOKEN"]).build()
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, reply))
app.run_polling()

Esse código é um chatbot, ainda não um agente. Para virar agente, você adiciona quatro coisas em cima:

Memória. Uma tabela em SQLite ou Postgres indexada pelo chat_id para o histórico curto. Para lembrança mais longa, um vector store como ChromaDB, Qdrant ou pgvector.
Ferramentas. Function-calling no LLM para que possa bater nas suas APIs, na web ou no sistema de arquivos.
Allowlist. Verifique update.effective_user.id contra uma variável de ambiente ALLOWED_USERS para que um usuário aleatório não esvazie sua chave.
Um host. Algo que mantenha o processo vivo quando o notebook hibernar. Uma VPS de R$25/mês como a Hetzner CX22 ou uma Raspberry Pi é suficiente - o modelo roda nos servidores da OpenAI, não nos seus.

Tempo até "agente que lembra e usa ferramentas": um fim de semana se você já programa em Python, mais que isso se não. Custo: tokens do fornecedor (alguns reais por mês em uso pessoal) mais o host.

Melhor para: devs que querem controle total, sem amarras de fornecedor, e dispostos a manter um serviço Python.

Caminho 2: No-code com n8n (ou Make)

Se você não quer escrever código mas quer controle real do fluxo, o n8n é a opção open source mais forte em 2026. É um construtor visual de workflows que você pode auto-hospedar numa VPS de R$25/mês ou usar no n8n.cloud.

A construção tem mais ou menos quatro nós:

Telegram Trigger: escuta mensagens novas do seu bot.
Nó AI Agent: o nó de agente nativo do n8n, configurado com um LLM (OpenAI, Anthropic, Groq etc.) e um buffer de memória.
Nós de ferramentas (opcionais): HTTP Request, Google Sheets, Postgres, suas próprias APIs.
Telegram Send Message: responde no mesmo chat.

O nó AI Agent traz uma opção Memory embutida. Escolha Window Buffer Memory para os últimos N turnos ou conecte um nó de memória Postgres ou Redis para persistência entre reinícios do n8n.

O trade-off honesto: o n8n é, antes de tudo, uma ferramenta de workflow, e só depois uma plataforma de agentes. É excelente quando o bot é principalmente uma camada de triagem em cima de um workflow que você já tem - captura de leads, registro de despesas, atualização de CRM, pré-triagem de suporte. Começa a sofrer quando o agente precisa pensar em vez de só rotear. No momento em que você se vê adicionando um quinto nó IF para lidar com nuances de linguagem humana, está simulando raciocínio com galhos e o agente vai perder. Falamos do contraste em mais detalhe em Hermes Agent vs n8n.

Melhor para: quem não programa, ou devs que já usam o n8n para outros workflows e querem uma camada no Telegram para eles.

Caminho 3: Construtores SaaS hospedados

Plataformas que embrulham o stack atrás de uma interface web. Você se cadastra, cola o token do BotFather, arrasta uns blocos, clica em publicar e o bot está no ar. Voiceflow, Botpress, Mosaia, Lobster Father e uma longa cauda de nichos vivem aqui.

Os trade-offs são previsíveis:

O setup mais fácil do mercado: muitas vezes em menos de uma hora, às vezes em cinco minutos.
BYOK é raro. Em geral, você consome os créditos do fornecedor com markup ou estoura o plano gratuito em uma tarde.
A "memória" anunciada na landing costuma ser por sessão, não entre sessões. Teste isso no oitavo dia antes de fechar contrato.
Suas mensagens e as dos seus usuários passam pela infraestrutura do fornecedor. Leia a política de privacidade.

Esse caminho encaixa quando o bot é um FAQ para clientes ou uma camada de captura de leads e você não precisa de memória pessoal persistente.

Melhor para: pequenos negócios que querem um bot no Telegram voltado para clientes, com mínima carga operacional e sem necessidade de memória pessoal entre sessões.

Caminho 4: Um runtime de agente auto-hospedado

É a categoria mais nova e a que melhor se encaixa no caso "agente pessoal no Telegram". Um runtime de agente auto-hospedado é um processo de longa duração feito especificamente para ser um agente: vem com memória estruturada, camada de skills, scheduler e entrega de primeira classe no Telegram (e em outras plataformas) de fábrica.

As duas opções open source reais:

OpenClaw guarda tudo como arquivos Markdown e YAML no seu workspace. Local-first, transparente, as skills são portáteis entre máquinas porque são só arquivos.
Hermes Agent é o que conhecemos melhor, porque Hermify é a versão gerenciada dele. Mantém um perfil persistente e memória entre sessões, cria e melhora skills automaticamente conforme trabalha, roda numa VPS de R$25 ou numa Raspberry Pi e tem suporte de primeira no Telegram incluindo allowlist, modo voz e agendamento em linguagem natural. Para um passo a passo, veja Como implantar o Hermes Agent no Telegram.

O perfil de custo é parecido com o do Caminho 1 (você hospeda), com a vantagem de o runtime fazer o trabalho pesado de memória, skills e confiabilidade. Você aponta para a sua própria chave da OpenAI ou Anthropic, coloca o token do BotFather na configuração e tem um agente que lembra e age, sem nenhum serviço Python para manter.

Melhor para: quem quer um agente pessoal de verdade (que lembra, aprende e age), valoriza ser dono do stack e se sente confortável com uma VPS barata ou uma Pi.

$Mesa de escritório em casa, escura e fotorrealista, com um celular mostrando uma notificação do Telegram em verde e o LED de um pequeno servidor brilhando fracamente ao fundo$

Como escolher

Uma árvore de decisão curta, ordenada pelo que a maioria das pessoas realmente precisa:

| Sua situação | Caminho | |---|---| | Quer um chatbot, não se importa com memória ou ferramentas | SaaS hospedado (Caminho 3). Grátis ou quase, instantâneo. | | Já usa n8n / Make em outros workflows | n8n (Caminho 2). Telegram Trigger + AI Agent. | | É dev Python e quer controle total | Python do zero (Caminho 1). Reserve um fim de semana. | | Quer um agente pessoal real que lembra e aprende | Runtime de agente auto-hospedado (Caminho 4). | | Quer o Caminho 4 sem rodar um servidor | Runtime gerenciado - é o que o Hermify é. |

Um teste de sanidade antes de fechar: monte o bot, escreva para ele por uma semana e, no oitavo dia, veja do que ele lembra quando você volta. Se lembrar do projeto que você descreveu na quarta passada, você tem um agente. Se não lembrar, você tem um chatbot. Não há nada de errado com um chatbot, mas é bom saber com qual dos dois ficou.

Por que Telegram e não WhatsApp ou Discord

Esta é a segunda pergunta mais frequente e vale um parágrafo. O Telegram ganhou para agentes pessoais porque três coisas se encaixam: a Bot API é grátis e imediata (sem cobrança por mensagem, sem verificação de empresa, sem templates pré-aprovados), a plataforma permite bots de terceiros sem fricção e a UX do chat (replies, anexos, mensagens de voz, teclados inline) é rica o bastante para suportar interações no estilo agente. O WhatsApp Business cobra por conversa e exige verificação na Meta com templates pré-aprovados - viável para atendimento transacional, doloroso para um agente pessoal de R$99/mês. O Discord encaixa quando a sua comunidade já vive lá; cobrimos isso em um guia separado.

Também escrevemos uma comparação mais longa em O melhor assistente de IA para Telegram se quiser ver lado a lado as opções existentes em vez de montar uma.

Fechamento

O caminho menor - SaaS hospedado - é genuinamente ok se o que você quer é um chatbot. Python do zero é a resposta certa se você curte montar stacks e quer que cada linha seja sua. n8n é a resposta certa se o bot é, em boa parte, encanamento de workflow. Um runtime de agente auto-hospedado é a resposta certa se quer que o assistente seja uma ferramenta de longo prazo que melhora quanto mais você usa.

Se quer a versão "agente pessoal" sem rodar um servidor, comece com o Hermify. É a versão gerenciada do Hermes Agent: memória persistente, BYOK, entrega no Telegram, allowlist, e zero Docker para vigiar.

Seja qual for o caminho escolhido, o prêmio é o mesmo: um assistente que vive no app que você já abre cinquenta vezes por dia.