Como criar seu próprio bot do Telegram

Um bot do Telegram é um pequeno programa que conversa com os usuários através do aplicativo Telegram, e todos eles começam da mesma forma: você o registra com o próprio bot do Telegram para criar bots, o @BotFather, que fornece um token de autorização único. A partir daí, você escreve código que usa esse token para fazer o bot responder, ou conecta-o a um criador no-code que faz a programação por você. Este guia percorre os dois caminhos, além da segurança do token e das noções básicas de hospedagem que se aplicam de qualquer forma.

Registrar um bot com o @BotFather

Todo bot do Telegram começa sua vida dentro de um chat com o @BotFather, o bot oficial do Telegram que cria e gerencia outros bots.

1. Abra o Telegram e procure por @BotFather, ou abra o link t.me/BotFather. Procure pela marca de verificação que o identifica como bot oficial antes de continuar.
2. Envie /start para ver a lista de comandos disponíveis, depois envie /newbot para começar a criar um bot.
3. Quando solicitado, envie o nome de exibição do bot — é o nome que as pessoas veem nos chats, e você pode alterá-lo depois.
4. Quando solicitado, envie um username para o bot. Ele deve ser único em todo o Telegram e terminar em "bot" ou "Bot" (por exemplo, MyRecipesBot).
5. Se o username estiver disponível, o @BotFather confirma seu novo bot e envia um token de autorização na mesma mensagem.

Esse token é a única coisa que você precisa para fazer o bot realmente funcionar — e a única coisa que você nunca deve compartilhar.

Entenda e proteja o token do seu bot

O token que o @BotFather fornece é, na prática, a senha do seu bot: qualquer pessoa que o tenha pode enviar mensagens como seu bot, ler o que ele recebe e alterar suas configurações através da Bot API. Trate-o adequadamente.

• Nunca o publique em um chat público, em um repositório de código público, em uma captura de tela ou em um chamado de suporte.
• Se você colar o token no seu código, guarde-o em uma variável de ambiente ou em um arquivo de configuração que não seja compartilhado nem enviado para lugar nenhum público — não o digite diretamente em um script que você possa colar em outro lugar depois.
• Se em algum momento suspeitar que o token vazou, envie uma mensagem ao @BotFather, selecione seu bot e use a opção para gerar um novo token — o antigo para de funcionar imediatamente.

O @BotFather também é onde você gerencia depois tudo o mais sobre o bot: sua descrição, foto de perfil, lista de comandos e configurações como o modo inline ou a privacidade em grupos, tudo por meio de comandos de menu simples como /setdescription ou /setcommands.

Construa a lógica do bot: código ou no-code

Um token só permite que o bot exista — algo ainda precisa dizer a ele como responder. Há dois caminhos comuns:

1. Escrever código. Usando o token, você pode chamar diretamente a Bot API do Telegram, ou usar uma biblioteca em uma linguagem como Python, JavaScript ou Go que encapsula essa API. Seu programa escuta as mensagens recebidas e envia respostas, lidando com comandos como /start ou qualquer texto que um usuário envie.
2. Usar um criador no-code. Se você não quer escrever código, um serviço criador de bots permite desenhar a conversa com menus, botões e blocos de lógica simples, e então conecta seu token do @BotFather para executá-lo por você. Isso troca um pouco de flexibilidade por uma configuração muito mais rápida, e é um bom ponto de partida para um bot de FAQ, um bot de lembretes ou uma loja simples.

Qualquer que seja o caminho escolhido, o token do @BotFather é o que conecta sua lógica — código ou no-code — ao chat real do Telegram.

Coloque seu bot online: noções básicas de hospedagem

Ao contrário de uma conta comum do Telegram, um bot só funciona enquanto o programa que responde por ele está realmente em execução. Esse programa precisa de um lugar para rodar continuamente:

1. Seu próprio computador. Bom para testes, mas o bot fica offline assim que você fecha o programa ou desliga o computador.
2. Um pequeno servidor na nuvem. Roda o dia todo independente do seu próprio dispositivo; você é responsável por manter o próprio servidor atualizado e funcionando.
3. A hospedagem própria de um criador no-code. Se você usou um criador do passo anterior, ele normalmente executa e hospeda seu bot por você, então não há uma etapa de hospedagem separada para configurar.

Qualquer que seja a opção escolhida, vale a pena adicionar um bot ou serviço de monitoramento que avise você se o servidor do seu bot ficar offline. Um bot que silenciosamente para de responder por dias sem que ninguém perceba é uma das formas mais comuns de projetos pequenos perderem seus usuários.