Quais são os recursos disponíveis no BotFather para criar um bot no Telegram?

Introdução ao BotFather: o ponto de partida para criar bots no Telegram

Quando se pensa em automação no Telegram, o primeiro nome que vem à mente é o BotFather. Trata-se do bot oficial da plataforma, responsável por registrar, configurar e gerenciar todos os bots da rede. Se você deseja criar um bot no Telegram, o BotFather é a ferramenta indispensável. Neste artigo, vamos explorar em detalhes cada um dos recursos disponíveis — desde o comando básico /newbot até opções mais avançadas, como configuração de comandos, permissões e integração com domínios personalizados. O objetivo é oferecer um guia completo e prático, tanto para iniciantes quanto para desenvolvedores experientes.

O que é o BotFather e como acessá-lo

O BotFather é um bot oficial mantido pela equipe do Telegram, disponível em todas as versões do aplicativo – Android, iOS, Windows, macOS e Linux. Para começar, basta procurar por @BotFather na busca ou acessar diretamente o link t.me/botfather. Ao iniciar uma conversa, o BotFather exibe uma lista de comandos disponíveis. É por meio deles que você criará, editará e excluirá bots, além de configurar aspectos como nome, descrição, foto de perfil e comandos personalizados. Em suma, é o centro de controle para qualquer bot na plataforma.

Recursos essenciais: comandos básicos do BotFather

1. /newbot – Criando seu primeiro bot

O comando mais importante é o /newbot. Ao digitá-lo, o BotFather pede duas informações: um nome para o bot (exibido nas conversas) e um nome de usuário único, que deve terminar com a palavra "bot" (ex.: exemplo_bot). Após a confirmação, você receberá um token de acesso – uma string alfanumérica que funciona como senha do bot. Guarde esse token com segurança, pois ele é necessário para conectar o bot ao seu código via API. Observação empírica: o processo leva menos de um minuto na maioria dos dispositivos, mas pode haver pequenas variações devido à rede. Exemplo: um token típico tem o formato 123456789:ABCdefGHIjklmNOPqrstUVwxyz.

2. /mybots – Gerenciando bots existentes

Para listar todos os bots que você já criou, use /mybots. O BotFather mostrará uma lista interativa. Ao selecionar um bot, surgem opções para editar seu nome, descrição, comandos, foto de perfil, permissões e muito mais. Esse é o painel central de administração. Diferença de plataforma: no Android, a interface é baseada em teclas inline; no iOS, o mesmo; no desktop, a interação é idêntica, mas a visualização é maior, facilitando a edição de múltiplos campos.

3. /setcommands – Definindo comandos personalizados

Com /setcommands, você pode definir uma lista de comandos que seu bot oferecerá. O formato é: comando1 - descrição comando2 - descrição. Cada comando deve começar com uma barra, e a descrição é opcional, mas recomendada. Esses comandos aparecerão no menu de entrada do chat quando o usuário digitar "/". Limitação: o Telegram permite até 100 comandos por bot, segundo a documentação oficial. Um exemplo prático: um bot de clima pode ter /tempo - Clima atual e /previsao - Previsão para 7 dias. Isso torna a interação mais intuitiva e rápida.

4. /setdescription e /setabouttext – Informações do bot

/setdescription define o texto curto exibido abaixo do nome do bot (por exemplo, na página de perfil). Já /setabouttext define o texto "Sobre" que aparece em chats. Ambos são limitados em caracteres: a descrição aceita até 512 caracteres, e o abouttext até 120 (conforme regras empíricas). Use-os para explicar o propósito do bot de forma clara e atrativa, pois são a primeira impressão que os usuários terão.

5. /setuserpic – Foto de perfil do bot

Envie uma imagem para o BotFather após o comando /setuserpic. A imagem deve ser quadrada e ter no máximo 128 KB, de acordo com a documentação. Recomenda-se usar PNG ou JPEG com resolução de 512×512 pixels para melhor qualidade. O BotFather não redimensiona, portanto envie já no formato adequado. Uma boa foto de perfil aumenta a credibilidade do bot.

6. /setinline – Habilitando modo inline

O modo inline permite que seu bot seja chamado de qualquer chat digitando @nomedobot seguido de uma consulta. Para habilitar, use /setinline e digite um placeholder (ex.: "Pesquise algo"). Esse recurso é útil para bots de busca, criação de GIFs, stickers, etc. Quando não usar: se seu bot não precisa responder a consultas em tempo real, o modo inline pode consumir recursos desnecessários (ex.: bots de notificação).

7. /setinlinefeedback – Feedback do inline

Ativa o feedback de resultados inline. Ao ativar, o Telegram enviará ao seu servidor uma atualização quando um resultado inline for selecionado por um usuário. Isso é importante para medir a eficácia das consultas. Observação empírica: bots com inline feedback ativado tendem a ter uma taxa de cliques maior, pois o desenvolvedor pode otimizar os resultados com base nos dados. Exemplo: um bot de stickers pode ajustar os mais populares com base nesse feedback.

8. /setjoingroups – Permitir que o bot entre em grupos

Por padrão, bots podem ser adicionados a grupos? Sim, mas o comando /setjoingroups permite controlar essa permissão. Você pode escolher entre "Enable" (permitir) e "Disable" (proibir). Se desabilitar, o bot só poderá ser usado em chats privados e inline. Exemplo: um bot de moderação precisa estar em grupos, então deve ter essa opção ativada. Já um bot pessoal de notas pode permanecer apenas em chats privados.

9. /setprivacy – Controle de privacidade e visibilidade de mensagens

Esse comando define se o bot pode ver todas as mensagens de um grupo ou apenas aquelas que começam com uma barra (comandos). Quando ativado (modo privado), o bot só recebe mensagens que são comandos ou menções. Quando desativado, o bot vê todas as mensagens. Trade-off: modo privado é mais seguro e eficiente, mas limita funcionalidades como análise de texto. Use desativado apenas se necessário (ex.: bots de chat automatizado que precisam ler todo o contexto).

10. /setdomain – Associar um domínio ao bot

Desde 2022, o Telegram permite que bots utilizem um domínio personalizado para verificar a identidade via DNS. Com /setdomain, você associa um domínio (ex.: exemplo.com) ao bot, e o Telegram exibirá um ícone de verificação ao lado do nome. Requisito: você deve ter controle sobre o domínio e adicionar um registro TXT específico fornecido pelo BotFather. Esse recurso é útil para bots oficiais de empresas, pois aumenta a confiança dos usuários.

11. /deletebot – Excluindo um bot

Cuidado: /deletebot remove permanentemente o bot e invalida o token. Não há confirmação adicional além do prompt; após confirmar, o bot desaparece. Recomendação: antes de excluir, desative o bot via código ou remova o webhook para evitar erros. Pense bem antes de usar este comando.

12. /token e /revoke – Gerenciamento de tokens

Com /token, você pode visualizar o token atual do bot. Se suspeitar de vazamento, use /revoke para gerar um novo token. O antigo será invalidado imediatamente. Exemplo prático: se você compartilhou o token acidentalmente em um fórum público, revogue-o e atualize seu código. Isso é essencial para a segurança do bot.

Recursos menos conhecidos mas úteis

/setname – Alterar o nome do bot

Diferente do nome de usuário, o nome pode ser alterado a qualquer momento. Por exemplo, se seu bot mudar de foco, você pode renomeá-lo sem perder seguidores. Isso é particularmente útil em rebrandings ou atualizações de funcionalidade.

/setlang – Definir idioma do bot

Permite escolher o idioma usado nas mensagens do BotFather ao interagir com o bot. Não afeta o idioma do seu bot, apenas a interface de administração. Se você prefere inglês, por exemplo, pode alterar aqui.

/setcommands – Além de definir, é possível editar comandos existentes

Se você já tem comandos e quer adicionar ou remover, basta usar /setcommands novamente e enviar a lista completa atualizada. O BotFather substitui totalmente a lista anterior. Isso facilita a manutenção conforme o bot evolui.

/mybots – Opções avançadas por bot

Ao selecionar um bot em /mybots, você encontra botões como "Edit Bot", "Settings", e "Delete Bot". Dentro de "Settings", há opções para alterar comandos, descrição, etc. É um menu hierárquico que facilita a navegação, especialmente quando você gerencia vários bots.

Como usar os recursos na prática: um passo a passo

Criando um bot do zero

Abra o Telegram e inicie uma conversa com @BotFather.
Digite /newbot.
Escolha um nome para o bot (ex.: "Meu Bot de Exemplo").
Escolha um nome de usuário único terminado em "bot" (ex.: exemplo_bot).
Copie o token gerado (ex.: 123456789:ABCdefGHIjklmNOPqrstUVwxyz).
Use /setcommands para adicionar comandos.
Use /setdescription e /setabouttext para preencher informações.
Opcional: /setuserpic para enviar uma foto.
Configure permissões com /setjoingroups e /setprivacy.
Pronto! Agora é só programar o bot usando a API.

Seguindo esses passos, você terá um bot funcional em poucos minutos. Lembre-se de testar cada etapa antes de publicar.

Solução de problemas comuns

Problema: O token não funciona

Verifique se você copiou o token completo, sem espaços. Se o token foi revogado ou expirou, gere um novo com /revoke. Certifique-se também de que ele está sendo usado no código corretamente.

Problema: O bot não responde a comandos

Possíveis causas: o bot não está rodando (servidor inativo), o webhook não está configurado corretamente, ou o modo privado está bloqueando mensagens. Verifique o webhook com getWebhookInfo da API e confira os logs do servidor.

Certifique-se de que você usou /setcommands e enviou a lista no formato correto. O Telegram pode levar alguns segundos para atualizar. Se o problema persistir, remova e adicione novamente os comandos. Às vezes, reiniciar o bot ajuda.

Boas práticas e recomendações

Ao criar um bot, siga estas diretrizes para garantir uma experiência robusta e profissional:

Segurança: nunca compartilhe o token; use variáveis de ambiente no código.
Comandos intuitivos: use nomes curtos e descrições claras.
Privacidade: se seu bot não precisa ver todas as mensagens, mantenha o modo privado ativado.
Testes: crie um bot de teste separado antes de alterar o bot de produção.
Documentação: mantenha a descrição e abouttext atualizados.

Essas práticas evitam problemas comuns e facilitam a manutenção a longo prazo.

Limitações e considerações finais

Embora o BotFather ofereça uma ampla gama de recursos, há limites: o número de bots por conta é ilimitado, mas cada bot tem um token único. A API do Telegram tem limites de requisições (30 mensagens por segundo por bot, aproximadamente). O BotFather não permite personalizar a interface do bot além do que foi descrito; para funcionalidades avançadas, é necessário programar o lado do servidor. Observação empírica: bots com muitos comandos (mais de 50) podem ter menu lento em dispositivos antigos. Planeje seus comandos com moderação.

Em resumo, o BotFather é a ferramenta central para qualquer desenvolvedor de bots no Telegram. Dominar seus comandos permite criar bots profissionais, seguros e funcionais. Recomenda-se explorar cada recurso, testar em ambiente de desenvolvimento e, acima de tudo, ler a documentação oficial da API do Telegram para complementar as configurações realizadas pelo BotFather.

Perguntas Frequentes

Posso alterar o nome de usuário do bot depois de criado?

Não. O nome de usuário (username) é único e imutável após a criação. Se você precisar de um novo username, será necessário criar um novo bot. O nome amigável (display name) pode ser alterado com /setname.

Quantos bots posso criar com uma conta do Telegram?

Não há limite oficial divulgado. Na prática, usuários já criaram dezenas de bots com a mesma conta. O BotFather permite gerenciar todos eles através de /mybots.

O que fazer se eu perder o token do bot?

Use o comando /token no BotFather para visualizar o token atual. Se você não tiver mais acesso ao bot (por exemplo, perdeu a conversa), infelizmente não há como recuperá-lo. Por isso, sempre guarde o token em um local seguro.

O BotFather permite configurar webhooks?

Não diretamente. A configuração de webhooks é feita através da API do Telegram, usando o método setWebhook. O BotFather apenas gerencia as configurações básicas do bot.

Posso ter um bot que não usa comandos, apenas mensagens de texto?

Sim. Basta não definir comandos com /setcommands e programar seu bot para responder a qualquer mensagem de texto. No entanto, recomenda-se usar comandos para facilitar a interação.