Como Criar um Bot do Telegram do Zero: Um Guia para Iniciantes
Construir um bot no Telegram começa com o BotFather e um token de API, não com uma decisão sobre framework. Aqui está o caminho para iniciantes, do primeiro token até um bot que fica sempre online.
Michael Chen
Um pequeno lojista recebe as mesmas três perguntas no Telegram todos os dias: prazos de entrega, política de devolução e datas de reposição. Responder manualmente consome uma hora antes do almoço. Um amigo sugere criar um robô para cuidar disso. O lojista nunca escreveu uma linha de código na vida.
Boas notícias: a primeira versão de um bot do Telegram não precisa de muito código, e nada disso exige mexer diretamente nos servidores do Telegram. Tudo passa por uma ferramenta oficial criada exatamente para isso.
Comece pelo BotFather, não por um framework
Todo bot do Telegram começa da mesma forma: por uma conversa com o @BotFather, o próprio bot do Telegram para criar bots. Abra um chat com ele, envie /newbot, escolha um nome de exibição e depois um nome de usuário terminando em "bot". O BotFather devolve um token de API na hora. Esse token é a senha do bot para os servidores do Telegram, e qualquer um que o tenha pode controlar o bot. Portanto, trate-o como trataria as credenciais de admin de um site: nada de colar em grupo público ou commitá-lo num repositório de código aberto.
Nesse ponto, tecnicamente você tem um bot funcional. Ele ainda não faz nada, porque nenhum código está ouvindo as mensagens enviadas a ele.
Escolha uma linguagem antes de escolher um tutorial
A maioria dos guias para iniciantes usa Python por padrão, porque as bibliotecas da comunidade são maduras e a sintaxe se aproxima do inglês simples. Node.js é ideal para quem já se sente confortável com JavaScript, especialmente se o bot precisar conversar com um web app que você já mantém. Equipes maiores às vezes recorrem a Java ou Go quando o bot precisa lidar com tráfego pesado, mas isso raramente é o ponto de partida para um primeiro projeto.
| Linguagem | Tempo típico de configuração (ilustrativo) | Melhor para |
|---|---|---|
| Python | 30 a 60 minutos para um bot básico de respostas | Primeiro bot, protótipos rápidos |
| Node.js / JavaScript | 30 a 60 minutos | Equipes que já mantêm um backend em JS |
| Java ou Go | Meio dia ou mais para uma configuração mínima | Bots de alto tráfego ou empresariais |
Nota: os tempos de configuração variam muito conforme a experiência do desenvolvedor; os valores acima são estimativas ilustrativas, não benchmarks medidos.
O que uma primeira versão deve fazer
Resista à vontade de construir todos os recursos antes de testar qualquer coisa. Uma primeira versão funcional geralmente cobre três comportamentos: responder ao comando /start com uma saudação, responder a um punhado de palavras-chave fixas e encaminhar qualquer coisa que não reconheça para um humano. Essa última parte é mais importante do que parece. Bots que ficam em silêncio diante de entradas inesperadas frustram muito mais os usuários do que bots com um conjunto menor de funcionalidades.
- Responder a
/starte/helpcom um menu curto do que o bot pode fazer. - Reconhecer um pequeno conjunto de palavras-chave ligadas às suas perguntas repetitivas reais, não a uma lista chutada.
- Recorrer a "um humano vai te responder" em vez de silêncio quando nada corresponder.
Assim que esse ciclo funcionar de forma confiável, adicionar postagens agendadas, comandos de gerenciamento de grupo ou consultas a banco de dados vira um passo menor, e não uma reconstrução.
Onde o bot precisa ficar hospedado
O código no seu notebook para de responder assim que você fecha a tampa. Um bot que precisa rodar continuamente exige um host que fique ligado: um VPS pequeno, uma plataforma de contêineres ou uma função serverless que acorda com mensagens recebidas. Nenhuma dessas opções precisa ser cara para um bot de baixo tráfego.
| Opção de hospedagem | Custo mensal (referência) | Melhor para |
|---|---|---|
| Função serverless no plano gratuito | $0 para tráfego leve | Bots simples de respostas, testes |
| VPS pequeno | $4 a $10 | Bots que também precisam rodar outras tarefas em segundo plano |
| Plataforma de contêineres gerenciada | $5 a $20 | Equipes que querem menos manutenção de servidor |
Nota: os preços são faixas ilustrativas aproximadas, que variam conforme provedor e região, não cotações fixas.
Se o seu bot precisar parecer consistente de um país específico, seja para testes regionais ou porque seu público é geograficamente concentrado, uma conexão residencial via marketplace de proxy é uma opção que algumas pessoas usam junto com a hospedagem, separada do código do bot. Seja qual for o host escolhido, a documentação oficial da API de Bots do Telegram é a referência que vale a pena favoritar quando você passar dos comandos para iniciantes.
Uma checklist rápida antes de ir ao ar
Seguir estes passos antes de anunciar um bot publicamente evita a maioria das dores de cabeça iniciais com suporte.
- Armazene o token da API em uma variável de ambiente, nunca diretamente no código que você possa compartilhar ou commitar.
- Teste
/start, suas três principais respostas por palavra-chave e a mensagem de fallback a partir de uma segunda conta. - Confirme que o bot continua online depois de fechar o notebook, verificando-o de outro dispositivo uma hora depois.
- Defina uma descrição e uma foto de perfil para o bot pelo BotFather, para que pareça intencional, e não abandonado no meio da construção.
- Anote quem será notificado quando a mensagem de fallback for disparada, para que perguntas não correspondidas não desapareçam no vácuo.
Muitos fornecedores de marketplace também vendem contas de admin verificadas ou números verificados por SMS para testes de bots nas listagens de contas Telegram ou verificação por SMS, úteis se você preferir não vincular um número pessoal a um bot que ainda está testando. Compare algumas listagens quanto a preço e velocidade de entrega antes de decidir, da mesma forma que compararia provedores de hospedagem.
