Como Criar um Bot no Telegram do Zero: 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 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 de estoque. Responder manualmente consome uma hora antes do almoço. Um amigo sugere criar um bot para lidar com isso. O lojista nunca escreveu uma linha de código.
A boa notícia: 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 feita exatamente para isso.
Comece pelo BotFather, não por um framework
Todo bot do Telegram começa do mesmo jeito: com 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 administrador de um site, não algo para colar em um grupo público ou em um repositório de código público.
Neste ponto, você tecnicamente tem um bot funcionando. 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 é adequado para quem já se sente confortável com JavaScript, especialmente se o bot precisar conversar com um aplicativo web que você já está rodando. 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-60 minutos para um bot de respostas básico | Primeiro bot, protótipos rápidos |
| Node.js / JavaScript | 30-60 minutos | Equipes que já rodam 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 a um comando /start com uma saudação, responder a algumas 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 adivinhada.
- Recorrer a "um humano vai te responder em breve" 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 uma consulta a banco de dados se torna um passo menor, em vez de uma reconstrução.
Onde o bot precisa ficar hospedado
O código no seu laptop para de responder no momento em que você fecha a tampa. Um bot que deve funcionar continuamente precisa de um host que fique ligado: um VPS pequeno, uma plataforma de contêineres ou uma função serverless que acorda ao receber mensagens. 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 de resposta simples, testes |
| VPS pequeno | $4-$10 | Bots que também precisam rodar outras tarefas em segundo plano |
| Plataforma de contêineres gerenciada | $5-$20 | Equipes que querem menos manutenção de servidor |
Nota: os preços são faixas aproximadas e ilustrativas 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 através do mercado de proxy é uma opção que algumas pessoas usam junto com sua configuração de hospedagem, separada do código do bot em si. 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 pequena lista de verificação 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ê pode compartilhar ou versionar.
- Teste
/start, suas três principais respostas de palavras-chave e a mensagem de fallback a partir de uma segunda conta. - Confirme que o bot continua online depois de fechar o laptop, verificando-o de um dispositivo diferente uma hora depois.
- Defina uma descrição e uma foto de perfil para o bot através do BotFather para que pareça intencional, não abandonado no meio da construção.
- Anote quem é notificado quando a mensagem de fallback é disparada, para que perguntas não correspondidas não desapareçam no vazio.
Muitos fornecedores de marketplace também vendem contas de administrador verificadas ou números verificados por SMS para testes de bot nas listagens de contas Telegram ou verificação SMS, útil 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 se comprometer, da mesma forma que compararia provedores de hospedagem.
