Como Conectar um Assistente de IA ao Telegram

Você quer que o mesmo assistente que já usa em uma aba do navegador viva dentro do Telegram, para mandar mensagem do celular no bolso em vez de abrir o laptop. A boa notícia é que o encanamento é simples: um token de bot, um loop de mensagens e um LLM. A parte menos óbvia é o que exige manter esse cano no ar depois do primeiro "olá mundo".

Por que colocar um assistente de IA no Telegram

A maioria das ferramentas de IA vive atrás de uma URL. Você navega até elas, digita, lê a resposta e fecha a aba. O contexto some no instante em que você fecha.

O Telegram muda isso ao tratar seu assistente como qualquer outra conversa da sua lista de contatos. Dá para mandar um áudio do carro, encaminhar um link de um grupo ou colar uma mensagem de erro enquanto está logado no desktop. Do outro lado, o mesmo assistente mantém a memória de cada uma dessas trocas, porque quem responde é um processo persistente, não uma página que recarrega.

Com essa moldura na cabeça, a pergunta interessante deixa de ser "consigo tirar uma resposta de um bot do Telegram?", que quase todo tutorial responde em cinco minutos. A pergunta real é "quem fica na responsa quando o bot cala às 23h de uma terça-feira?".

Passo 1: Crie o bot no BotFather

Abra o Telegram e busque por @BotFather. É a conta oficial com o selo azul de verificado. Toque em Iniciar e envie:

/newbot

O BotFather faz duas perguntas:

Nome de exibição: o que aparece no cartão de contato do bot. Editável depois.
Username: o @handle usado em links e menções. Precisa ter de 5 a 32 caracteres, só alfabeto latino, e terminar em bot (por exemplo meuia_assistente_bot).

Quando você aceita um username válido, o BotFather devolve um token. Se parece com isto:

7123456789:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw

Trate essa string como se fosse uma senha. Não cole em prints, grupos ou repositórios públicos. Se vazar, mande /revoke para o BotFather, escolha o bot e ele te entrega um novo; o antigo para de funcionar na hora.

Passo 2: Decida quem pensa

O token do bot só serve para enviar e receber mensagens. Ele não decide o que dizer. Esse trabalho é do LLM. Você tem três grandes opções:

Uma única API de LLM: apontar direto para OpenAI, Anthropic ou Google. Simples, mas cada provedor tem seu SDK, seu modelo de auth e seus limites.
Um roteador tipo OpenRouter: uma única API key que dá acesso a dezenas de modelos. Você troca de modelo por tarefa (rápido e barato para chat, modelo grande para raciocínio) sem malabarismo com contas.
Um modelo local: Ollama ou llama.cpp no seu próprio hardware. Sem custo por token, mas você cuida do uptime.

Para um assistente pessoal que precisa parecer responsivo, a maioria acaba em uma API hospedada. A latência de um modelo local em hardware de consumo costuma ser pior que a de um comercial bem conectado, e a qualidade ainda fica atrás em raciocínio geral.

Escolha qual provedor for, gere a chave no painel dele agora e guarde junto com o token do bot. Você vai precisar das duas no próximo passo.

Passo 3: Construa (ou pegue emprestado) o loop de mensagens

Entre o Telegram e o LLM precisa haver um pequeno software que:

Faça long polling (ou use webhooks) na API de bots do Telegram para novas mensagens.
Passe o texto da mensagem (e, se quiser, o histórico da conversa) para o LLM.
Devolva a resposta do LLM para o mesmo chat no Telegram.
Trate erros para que uma falha pontual não mate o loop em silêncio.

Se você se vira em Python, a biblioteca python-telegram-bot mais o SDK do provedor deixam um protótipo funcionando em cerca de 40 linhas. Em Node há pacotes equivalentes. Para um caminho estritamente no-code, ferramentas como Make.com ou n8n permitem arrastar um gatilho do Telegram e uma ação do OpenAI e ligar os dois com uma linha.

Dois detalhes que você quase certamente vai querer adicionar antes de considerar usável:

Uma lista de usuários permitidos, para que estranhos que adivinhem o handle do bot não torrem seu orçamento de API. Bots do Telegram são pesquisáveis; sem allowlist, seu bot responde a qualquer um.
Memória de conversa, para o assistente lembrar dos turnos anteriores no mesmo chat em vez de tratar cada mensagem como a primeira. Persista o histórico em um banco indexado por chat_id ou use um framework de agentes com memória embutida.

Passo 4: Mantenha o processo vivo

É aqui que a maioria dos projetos de fim de semana morre em silêncio.

Seu bot do Telegram só responde enquanto o loop de mensagens está rodando. Se ele está no terminal do seu laptop, para no instante em que o laptop dorme. Se é um python bot.py num VPS barato, para na próxima queda do processo, no próximo reboot do VPS por atualização de kernel ou na próxima exceção não tratada às três da manhã.

A resposta da indústria é pouco glamorosa:

Empacote o processo em systemd (ou Docker com restart: unless-stopped) para o SO subir de novo depois de uma queda ou reboot.
Mande os logs para algum lugar que você realmente vai olhar (um arquivo rotacionado pelo logrotate ou um serviço de logs hospedado).
Adicione um health check que te avise se o bot ficou N minutos sem receber update do Telegram.
Guarde token do bot e chaves de API num cofre de segredos, não em um config.yaml no mesmo disco que o código.

Nada disso é difícil isoladamente. É apenas uma responsabilidade contínua, e é a parte que decide se "assistente de IA no Telegram" vira uma ferramenta diária deliciosa ou um projeto para reimplantar de tempos em tempos.

O atalho: usar um Hermes Agent gerenciado

Se você gosta da ideia do assistente de IA no Telegram, mas não da de administrar um servidor Linux, o atalho é delegar os dois passos do meio e ficar com os que realmente importam.

A Hermify roda um Hermes Agent gerenciado como um contato do Telegram para você. Você entra com:

Seu token de bot (do passo 1)
Uma chave de provedor de modelo (do passo 2), ou um plano que já inclua acesso ao modelo

A Hermify cuida do loop de mensagens, do supervisor do processo, dos arquivos de memória que persistem entre conversas e do armazenamento das credenciais. O bot fica no ar no seu Telegram em cerca de um minuto, e quando o processo precisa reiniciar ele reinicia sozinho, então você descobre por um painel, não por um chat em silêncio. Comece com a Hermify para experimentar o caminho gerenciado.

O Hermes Agent por baixo é open source, então você não fica preso à hospedagem: pode mover a mesma configuração para o seu VPS mais tarde se decidir que a carga operacional vale a pena. A maioria descobre que nunca move.

Escolhendo entre DIY e gerenciado

Os dois caminhos funcionam. A decisão é mais sobre onde você quer gastar atenção:

DIY se já roda essa classe de infraestrutura, quer controle total sobre modelo, arquivos de memória e prompts, e enxerga a parte operacional como parte da diversão.
Gerenciado se quer que o assistente seja simplesmente um contato do Telegram para mandar mensagem de qualquer lugar, sem manutenção de fim de semana.

De qualquer forma, o ganho de UX no fundo é o mesmo: seu assistente deixa de ser uma URL e vira alguém para quem você manda mensagem. Quando ele vive no Telegram, você começa a usar de verdade.

Se quiser comparar os passos de configuração com uma implantação concreta, o guia de deploy no Telegram percorre uma instalação completa do começo ao fim. Se quer o atalho, comece com a Hermify e seu assistente fica no ar no Telegram em cerca de um minuto.