Como criar um bot para Telegram

Se você pesquisou como criar um bot para Telegram, está diante de uma bifurcação — e a maioria das pessoas só percebe isso quando já avançou bastante pelo caminho errado. "Criar um bot do Telegram" pode significar duas coisas completamente diferentes. Uma é desenvolver seu próprio bot do zero com código. A outra é ter um bot funcional que realiza uma tarefa real no seu grupo. As duas opções são válidas. Mas não são o mesmo projeto, e confundi-las faz você perder horas.

Esta página separa os dois caminhos com clareza. Primeiro, o processo real e oficial para criar seu próprio bot do Telegram por meio do @BotFather, incluindo a parte que quase ninguém conta logo de início: um bot recém-criado não faz nada até você escrever e hospedar o código por trás dele. Depois, o caso mais comum: quando alguém quer um bot para moderar ou gerenciar um grupo e, na prática, não precisa desenvolver nada. Ao final, você saberá qual caminho é o seu.

O que "criar um bot do Telegram" realmente significa

Um bot do Telegram é uma conta automatizada operada por software em vez de uma pessoa. Quando você "cria" um bot no sentido técnico, ainda não está escrevendo o software. Você está registrando uma conta no Telegram e recebendo credenciais para ela. A conta fica vazia até que um programa seja conectado a ela e mantido em execução em algum lugar.

Portanto, a palavra "criar" esconde uma lacuna. Registrar o bot leva dois minutos e é gratuito. Fazer com que ele realize algo útil é um trabalho separado e bem maior. Entender isso evita a surpresa mais comum: concluir as etapas no @BotFather, abrir uma conversa com seu novo bot e vê-lo ficar ali, em silêncio.

Se bots ainda são novidade para você, O que são bots no Telegram? explica o básico, e Bot para Telegram: de qual o seu grupo precisa mostra os diferentes tipos.

Caminho A: crie seu próprio bot com o @BotFather e código

Este é o caminho oficial, e funciona para qualquer pessoa disposta a programar. O @BotFather é o bot oficial do Telegram para registrar bots, e você conversa com ele em um chat normal.

Registre o bot com o @BotFather

1. Abra o Telegram, procure por @BotFather (o verificado, com o selo azul) e inicie uma conversa.
2. Envie o comando /newbot.
3. O @BotFather pede um nome de exibição (o que as pessoas veem, por exemplo, "My Helper Bot"). Envie o nome.
4. Em seguida, ele pede um nome de usuário, que deve ser único e terminar em bot (por exemplo, myhelper_bot). Envie um que ainda não esteja em uso.
5. O @BotFather responde com um API token, uma sequência longa como 123456789:ABCdef.... Esse token é a senha do bot. Mantenha-o em sigilo; qualquer pessoa com acesso a ele pode controlar seu bot.

Esse é todo o registro. Seu bot agora existe. Depois, você pode usar o @BotFather para definir uma foto de perfil, descrição e sugestões de comandos por meio de comandos como /setdescription e /setuserpic.

A parte que exige trabalho de verdade

Aqui está o que os tutoriais rápidos deixam de fora. Neste ponto, seu bot ainda não faz nada. O token é uma chave para uma conta vazia. Para fazer o bot responder a mensagens, executar comandos ou moderar qualquer coisa, você precisa:

• Escrever código que se comunique com a Telegram Bot API usando seu token. A maioria das pessoas usa uma biblioteca na linguagem de sua preferência (python-telegram-bot, telegraf para Node.js, aiogram, entre outras). O código define o que acontece quando uma mensagem chega.
• Hospedar esse código em algum lugar que funcione continuamente. Um bot só funciona enquanto seu programa está em execução e acessível. Isso significa um servidor, uma VPS ou um serviço de hospedagem, além de mantê-lo ativo e monitorado. Desligue ou leve seu laptop embora, e o bot fica offline.

Nada disso é incomum para um desenvolvedor, mas é trabalho real de software. Criar um bom bot de moderação envolve muito mais do que um bot simples: classificação de spam, verificação de imagens, limites de envio, tratamento de abuso, banco de dados e uma interface para configurar tudo.

Portanto, o Caminho A é a resposta certa se você quer aprender, tem uma ideia personalizada ou é um desenvolvedor que precisa de um comportamento sob medida. É a resposta errada se o que você realmente queria era um bot que já moderasse grupos.

Caminho B: você não quer construir um bot, quer um bot que faça uma tarefa

Observe com atenção as buscas em torno de "como fazer um bot do Telegram" e um padrão aparece. Uma grande parte das pessoas que digitam isso não quer se tornar desenvolvedora de bots. Elas administram um grupo do Telegram que está sendo tomado por spam, links fraudulentos, invasões coordenadas ou imagens indesejadas, e concluíram que a solução é "criar um bot" para limpar tudo.

Se esse é o seu caso, aqui vai o atalho honesto: você não cria esse bot. Você adiciona um que já funciona.

Moderação de grupos é um problema já resolvido. Um bom bot de moderação precisa de detecção de spam com machine learning, análise de imagens, pontuação comportamental, cobertura multilíngue, sistema de punições e um painel de controle. Escrever e hospedar tudo isso por conta própria leva meses de trabalho e manutenção contínua. Um bot pronto entrega o mesmo resultado no tempo necessário para adicionar um membro e ativar algumas opções.

É aqui que o Telegram Bot App entra. O objetivo aqui é direcionar você corretamente, então vale ser preciso sobre o que ele é e o que não é.

O que é o Telegram Bot App

Telegram Bot App é um bot pronto de moderação e gerenciamento que você adiciona a um grupo do Telegram. Você não o cria, não o programa e não o hospeda. Você o adiciona usando as permissões de administrador que bots emitidos pelo @BotFather recebem em um grupo, e depois o configura em um painel web em telegram-bot.app.

Para deixar igualmente claro o que ele não é: não é uma plataforma de criação de bots ou no-code, não é AI conversacional e não é um userbot que faz login como humano ou convida pessoas em massa. O @BotFather também não produz um bot de moderação para você; ele apenas registra bots em branco. O Telegram Bot App é o próprio bot finalizado e funcional.

O que ele realmente faz

Depois de adicionado e promovido a administrador, ele aplica suas regras automaticamente:

• Mensagens de boas-vindas e CAPTCHA ao entrar. Cumprimente novos membros e desafie-os a provar que são humanos, com um tempo limite que você define de 1 a 60 minutos. Veja CAPTCHA e verificação de novos membros e mensagens de boas-vindas e regras.
• Duas camadas gratuitas contra spam. AI Spam Intelligence pontua o comportamento da conta como um valor de risco bayesiano de 0.0 a 1.0 e expulsa automaticamente a partir de 0.75. Spamfinder é um classificador de conteúdo com machine learning, com um limite que você define de 0 a 100 por cento. Ambos são gratuitos. Saiba mais em Como parar bots de spam.
• Verificações de conteúdo. Análise de imagens NSFW, detecção de sentimento e toxicidade, filtro personalizado de palavrões que identifica tentativas de burlar a escrita, aplicação de idioma em cerca de 33 a 43 idiomas, verificação antivírus de arquivos e análise de perfil de novos membros.
• Tratamento de links. Ele bloqueia links de convite do Telegram para impedir spam de promoção de grupos e detecta URLs maliciosas por meio do Google Safe Browsing. Ele não remove todos os links por domínio nem executa uma lista personalizada de URLs permitidas/bloqueadas.
• Punições progressivas e painel de controle. Infrações repetidas recebem consequências mais severas, e um painel web mostra análises, além de um feed de punições ao vivo.

Ele oferece gratuitamente o conjunto principal de moderação, incluindo 500 análises de imagem e 1.000 análises de sentimento por mês. Os planos pagos aumentam as cotas: Gold por $4.99/mês, Platinum por $9.99/mês, Ultimate por $49.99/mês, com cobrança anual cerca de 20 por cento mais barata. Veja compra de premium para detalhes.

A configuração completa está em Como adicionar um bot ao seu grupo: adicione o bot, conceda permissões de administrador, envie uma mensagem para registrar o grupo e depois configure tudo no painel.

Qual caminho é o seu?

Decida com uma pergunta. Você quer construir software ou quer um resultado?

Você quer...	Escolha	Por quê
Aprender desenvolvimento de bots ou criar um recurso personalizado que nenhum bot existente tem	Caminho A: @BotFather + código	Você precisa de controle total e está preparado para escrever e hospedar a lógica
Parar spam, verificar novos membros, filtrar conteúdo, moderar um grupo	Caminho B: adicionar um bot pronto	O trabalho já está feito; você configura, não programa
Uma loja, quiz, bot de música ou notificações com design próprio	Caminho A: @BotFather + código	Esses são projetos de lógica personalizada, sem uma solução pronta que se encaixe exatamente no seu caso
Gerenciar uma comunidade em crescimento sem se tornar desenvolvedor	Caminho B: adicionar um bot pronto	Construir um mecanismo de moderação por conta própria custa meses que você não precisa gastar

Não há problema em escolher qualquer um dos dois. Muita gente começa pelo Caminho A, registra um bot, bate na parede do "agora preciso escrever um filtro de spam" e percebe que o Caminho B era o que queria desde o início.

Perguntas frequentes

Criar um bot do Telegram é gratuito?

Registrar um bot pelo @BotFather é gratuito, e o Telegram não cobra pela Bot API. O que pode custar dinheiro é operar seu próprio bot, já que o código precisa ser hospedado em algum lugar que permaneça online. Se você adicionar um bot pronto em vez disso, a moderação principal do Telegram Bot App funciona em um plano gratuito, então um grupo pode ser protegido sem custo.

Como criar um bot para Telegram sem programar?

Você não pode programar um bot sem código, por definição. Mas, se seu objetivo é ter um bot que faça uma tarefa em um grupo em vez de criar um projeto personalizado, você pula totalmente a construção e adiciona um bot pronto. Com o Telegram Bot App, você o adiciona, concede direitos de administrador e configura tudo por meio de um painel web com botões e controles deslizantes, sem envolver código. O passo a passo está em Como adicionar um bot ao seu grupo.

O que o @BotFather realmente cria?

O @BotFather registra uma conta de bot em branco e fornece um API token. Só isso. O bot não tem nenhum comportamento até que você conecte um programa ao token e mantenha esse programa em execução. O @BotFather não cria um bot de moderação, um assistente de chat nem qualquer recurso para você; ele apenas emite a conta e as credenciais.

Quero moderar meu grupo. Eu realmente preciso criar um bot?

Não. Moderação de grupos é exatamente o caso em que criar seu próprio bot é o caminho lento. Um bot de moderação precisa de detecção de spam, análise de imagens, tratamento de idiomas e um sistema de punições, coisas que já existem em bots prontos. Adicionar o Telegram Bot App entrega isso em minutos, em vez de meses de desenvolvimento.

Qual é a diferença entre criar um bot e adicionar um bot?

Criar um bot significa registrar uma conta com o @BotFather, escrever o código que dá comportamento a ela e depois hospedar esse código. Adicionar um bot significa pegar um bot finalizado e funcional e convidá-lo para o seu grupo com direitos de administrador. Criar é adequado para desenvolvedores e ideias personalizadas; adicionar é adequado para quem quer uma tarefa resolvida sem construir nada. Veja por que usar um bot do Telegram.

A conclusão honesta

Se você realmente quer desenvolver, o Caminho A está aberto para você, e o @BotFather é o primeiro passo correto. Se você queria um bot para manter um grupo do Telegram limpo e confundiu isso com um projeto de programação, pode parar por aqui. Adicione um bot de moderação pronto, configure-o e siga em frente. Para configurar um, siga Como adicionar um bot ao seu grupo, ou leia Proteja seu grupo do Telegram para ver o que a moderação automatizada cobre.