Como criar um bot no Telegram usando o BotFather?

Introdução: O que é o BotFather e por que criar seu próprio bot?

O BotFather é o bot oficial do Telegram responsável por gerenciar a criação e configuração de outros bots. Se você quer automatizar tarefas em grupos, canais ou conversas privadas, o primeiro passo é usar o BotFather para registrar seu bot e obter o token de acesso. Este tutorial cobre desde o início até configurações avançadas, com exemplos práticos e recomendações de segurança.

Diferente de outras plataformas, o Telegram oferece uma API gratuita e flexível, e o BotFather é a porta de entrada para qualquer desenvolvedor — mesmo sem experiência em programação, pois ele mesmo guia o processo. No entanto, é importante entender os limites: o BotFather não hospeda seu código, apenas registra e configura as permissões. Você precisará de um servidor ou serviço de nuvem para executar a lógica do bot. Por isso, planeje com antecedência onde o código será executado.

Pré-requisitos e preparação

Antes de começar, certifique-se de ter uma conta ativa no Telegram e um aplicativo cliente (mobile ou desktop) na versão mais recente. Não é necessário conhecimento técnico para os passos iniciais, mas ter um editor de texto ou ferramenta de API (como Postman) será útil se quiser testar o token rapidamente.

• Conta no Telegram – qualquer número verificado serve.
• Aplicativo instalado – Windows, macOS, Linux, Android, iOS.
• Conexão com internet – para enviar comandos ao BotFather.

Não é necessário criar um grupo ou canal previamente; o bot pode ser testado em conversas privadas. Se você planeja usar o bot em um grupo, precisará adicioná-lo manualmente depois, e isso pode ser feito a qualquer momento.

Passo a passo: Criando seu primeiro bot

1. Encontre o BotFather

No Telegram, pesquise por @BotFather ou acesse diretamente t.me/botfather. Inicie uma conversa e clique em “Iniciar” (ou envie /start). O BotFather exibirá uma lista de comandos disponíveis, facilitando a navegação.

2. Crie um novo bot com /newbot

Envie o comando /newbot. O BotFather pedirá um nome para o bot (exibido na lista de contatos) e um nome de usuário (username) único, que deve terminar com “bot” (ex: MeuSuperBot). Escolha algo fácil de lembrar e que represente a função do bot, pois isso ajuda na divulgação.

Após o username ser aceito, o BotFather responderá com uma mensagem contendo o token de acesso — uma sequência alfanumérica como 123456:ABCdefGHIjklMNOpqrsTUVwxyz. Guarde esse token em local seguro; ele é a chave para controlar seu bot via API. Anote-o imediatamente, pois a conversa com o BotFather pode ser perdida.

3. Teste o token rapidamente

Para verificar se o token funciona, você pode fazer uma requisição simples no navegador ou usando curl:
https://api.telegram.org/bot<SEU_TOKEN>/getMe. Substitua <SEU_TOKEN> pelo token obtido. A resposta JSON deve conter informações do bot, como first_name e username. Isso confirma que o bot está ativo e que o token é válido.

Configurações essenciais pós-criação

Descrição, foto e comandos

Com o token em mãos, você pode personalizar seu bot usando comandos do BotFather. Essas configurações não afetam o funcionamento interno, mas melhoram a experiência dos usuários:

• /setdescription – define uma descrição de até 512 caracteres, exibida na página do bot.
• /setabouttext – texto curto (até 120 caracteres) mostrado no perfil do bot.
• /setuserpic – envia uma imagem para ser o avatar do bot.
• /setcommands – registra uma lista de comandos que o bot entende, como /start, /ajuda, etc. O formato aceito é: comando - descrição.

Por exemplo, ao digitar / no chat com o bot, os comandos registrados aparecem como sugestões, facilitando a interação. Use descrições claras para cada comando, pois elas orientam o usuário sobre o que o bot pode fazer.

Modo privado e permissões de grupo

Dois comandos importantes são /setprivacy e /joingroups. O modo privado (habilitado por padrão) faz com que o bot só receba mensagens que comecem com uma barra (comandos) ou que sejam enviadas diretamente a ele. Desabilitar o modo privado permite que o bot leia todas as mensagens de um grupo onde está inserido — útil para moderação, mas requer cuidado com privacidade.

Já /joingroups controla se o bot pode ser adicionado a grupos por outros usuários. Se você quer que seu bot funcione apenas em conversas privadas, desative essa opção. Essas duas configurações definem o alcance do bot dentro do Telegram.

Entendendo o token e a segurança

O token é a única autenticação entre seu código e a API do Telegram. Nunca o inclua em código-fonte público, repositórios Git ou mensagens. Armazene-o como variável de ambiente ou em um serviço de segredos (ex: GitHub Secrets, variáveis de ambiente do servidor). Essa prática evita vazamentos acidentais.

Se suspeitar de vazamento, use /revoke no BotFather para invalidar o token antigo e gerar um novo. Todos os serviços conectados ao token antigo pararão de funcionar até serem atualizados — por isso, mantenha um backup seguro do token atual.

Integração com código: conceitos básicos

Para que o bot execute ações, você precisa programar um servidor que consuma a API. As linguagens mais comuns são Python (bibliotecas python-telegram-bot, Telebot), Node.js (node-telegram-bot-api) e PHP (TelegramBot). O padrão básico é:

1. Configurar um webhook (URL pública que recebe atualizações) ou usar o método getUpdates (long polling).
2. Processar mensagens recebidas e responder de acordo com comandos.
3. Hospedar o código em um servidor ou função serverless.

O BotFather não fornece hospedagem. Para iniciantes, recomenda-se serviços gratuitos como PythonAnywhere (plano gratuito limitado) ou AWS Lambda. Uma alternativa é usar bots de terceiros que abstraem a lógica, mas isso foge ao escopo deste tutorial. Escolha a abordagem que melhor se adequa ao seu nível técnico.

Funções avançadas do BotFather

Comandos especiais

Além dos básicos, o BotFather oferece uma série de comandos para ampliar as capacidades do bot:

• /setinline – habilita o modo inline, permitindo que o bot seja “chamado” em qualquer chat digitando @username do bot seguido de um termo de busca.
• /setinlinegeo – associa dados de localização ao modo inline.
• /setinlinefeedback – ativa feedback quando um resultado inline é enviado.
• /setdomain – vincula um domínio ao bot (para webhooks).
• /deletebot – remove o bot permanentemente. Use com cuidado, pois não há reversão.

O comando /setdomain é essencial se você for usar webhook: defina o mesmo domínio que seu servidor web usará. Isso previne que terceiros enviem atualizações falsas para seu bot, reforçando a segurança.

Criando bots para grupos e canais

Após criar o bot, adicione-o a um grupo ou canal como membro normal. Para grupos, você pode atribuir permissões de administrador (via configurações do grupo) se o bot precisar gerenciar mensagens (banir, fixar, etc.). No canal, o bot precisa ser administrador para postar. Lembre-se de que o BotFather não controla permissões em grupos — isso é feito pelo proprietário do grupo.

Use /setjoingroups apenas para permitir que outros adicionem o bot. Se você mesmo adicionar o bot manualmente, essa configuração não interfere.

Casos de uso e exemplos práticos

Um bot criado com BotFather pode ser programado para diversas finalidades. A versatilidade é grande, e a criatividade do desenvolvedor é o limite. Por exemplo:

• Moderação automática: responder a palavras-chave, banir usuários que enviam links não permitidos.
• Notificações: enviar alertas de sites, clima, criptomoedas.
• Pesquisas e enquetes: criar quizzes interativos.
• Jogos simples: usando inline queries.
• Integração com APIs externas: buscar informações de serviços como GitHub, Google Calendar.

Para um bot de moderação em um grupo com 100 mil membros, é crucial projetar a lógica para não exceder os limites de rate limiting da API (30 mensagens por segundo por grupo). Observação empírica sugere que o Telegram pode aplicar limites mais restritivos para respostas automáticas em grupos grandes, portanto, implemente filas ou delays se necessário.

Trade-offs: quando usar (e quando não usar) o BotFather

O BotFather é a única via oficial para criar bots no Telegram, mas há situações em que você pode repensar a abordagem. Avalie sempre o custo-benefício de desenvolver um bot próprio versus usar soluções prontas:

• Bots extremamente simples: se você só precisa de uma resposta fixa, considere serviços de bots prontos (ex: Manybot) que dispensam programação.
• Alta disponibilidade: seu servidor precisa ficar online 24/7. Serviços gratuitos podem cair e o bot para de responder.
• Custo: hospedagem paga para bots que processam milhares de requisições pode se tornar cara.
• Privacidade: bots de terceiros (não feitos por você) podem ter acesso a dados das conversas. Sempre prefira bots próprios para dados sensíveis.

Para tarefas que exigem interação rica (como menus inline com botões), o BotFather dá a base, mas a lógica deve ser implementada por você. Se precisar de uma solução zero-code, as plataformas mencionadas são alternativas viáveis.

Solução de problemas comuns

Problema	Possível causa	Como verificar / resolver
Bot não responde a comandos	Token inválido ou webhook mal configurado	Teste com getMe; se falhar, regenere o token
Bot não entra no grupo	Modo privado ou /joingroups desabilitado	Verifique as configurações no BotFather
Mensagens de grupo não são lidas	Modo privado habilitado	Use /setprivacy para desabilitar

Se o bot não aparece nos resultados de busca, lembre-se de que não há um “catálogo” oficial; os usuários devem saber o username exato para iniciar a conversa. Para divulgar, compartilhe o link direto t.me/SeuBotUsername.

Perguntas Frequentes

Preciso saber programar para criar um bot com BotFather?

Não. O BotFather apenas registra o bot e fornece o token. Para que ele execute ações, você precisa de um código (ou de um serviço que abstraia a lógica). Se não quer programar, existem plataformas como Manybot que permitem criar bots básicos via interface gráfica.

O token do meu bot vazou. O que fazer?

Use o comando /revoke no BotFather para gerar um novo token imediatamente. Depois, atualize todos os serviços que usavam o token antigo.

Quantos bots posso criar com uma única conta?

O BotFather não impõe um limite explícito, mas na prática é possível criar dezenas. Cada bot é independente; você pode gerenciar todos através da mesma conta.

Meu bot pode enviar mensagens para qualquer pessoa sem ela iniciar conversa?

Não. O bot só pode enviar mensagens para usuários que já iniciaram uma conversa com ele (exceto se o usuário estiver em um grupo onde o bot pode enviar notificações). Para notificações proativas, use o botão “Iniciar” ou solicite que o usuário envie /start primeiro.

Posso alterar o username do bot depois de criado?

Sim. Use o comando /setusername no BotFather. O novo username também deve terminar com “bot” e não pode estar em uso. Todos os links e buscas anteriores para o username antigo deixarão de funcionar.

Conclusão e próximos passos

Criar um bot no Telegram usando o BotFather é um processo simples que qualquer usuário pode realizar em poucos minutos. A verdadeira complexidade está em dar vida ao bot com código ou integrações. Comece com um bot de teste, explore os comandos de configuração e, em seguida, implemente uma funcionalidade básica como um eco ou um comando de ajuda.

Para aprofundar, estude a documentação oficial da API do Telegram, que lista todos os métodos disponíveis (enviar fotos, documentos, teclados inline, etc.) e os limites de taxa. Lembre-se de sempre manter a segurança do token e respeitar a privacidade dos usuários. Conforme ganhar confiança, você pode expandir o bot para automatizar tarefas mais complexas em grupos e canais. A tendência é que bots se tornem cada vez mais integrados com serviços externos e inteligência artificial, então mantenha-se atualizado com as novidades da plataforma.