Como pegar o token do bot no BotFather

Guia · atualizado em 2 de novembro de 2026 · 4 min de leitura

Todo bot de Telegram nasce no BotFather, o bot oficial do Telegram que cria e administra outros bots. É lá que você pega o token, a chave que liga o seu programa ao bot. Este guia mostra o caminho completo, o que fazer se perder ou vazar o token e as configurações que vale ajustar.

1. O que é o token
2. Passo a passo para criar o bot e copiar o token
3. Regras do nome de usuário
4. Perdi o token ou ele vazou: e agora?
5. Configurações que valem a pena no BotFather
6. Problemas comuns
7. Perguntas frequentes

O que é o token

O token é uma sequência parecida com 123456789:ABCdef...: um número, dois-pontos e um trecho longo de letras, números e símbolos. Ele funciona como a senha do bot. Qualquer programa que tenha o token consegue receber as mensagens do bot e responder em nome dele.

Por isso, duas regras simples: o token só vai para o lugar onde o bot vai rodar, e nunca aparece em print, grupo ou conversa com quem você não conhece.

Passo a passo para criar o bot e copiar o token

1. Abra o BotFather. No Telegram, pesquise @BotFather e abra a conta com selo azul de verificado.
2. Inicie a conversa. Toque em Iniciar (ou envie /start). Ele mostra a lista de comandos.
3. Envie /newbot. É o comando para criar um bot novo.
4. Escolha o nome de exibição. É o nome que aparece no topo da conversa, como "Agenda do Salão da Ana". Pode ter acentos e espaços.
5. Escolha o nome de usuário. É o endereço do bot. Precisa terminar em "bot", como agenda_salao_ana_bot.
6. Copie o token. O BotFather responde com uma mensagem de parabéns, o link t.me do bot e o token. Toque no token para copiar.
7. Guarde o token no lugar certo. Cole o token só onde o bot vai rodar. No AIBotBuild, cole na conversa quando a IA pedir: ele é guardado criptografado e não aparece no código.

Regras do nome de usuário

O nome de usuário (username) é o endereço do bot e precisa seguir algumas regras:

• terminar em bot, por exemplo agenda_salao_bot ou LojaDaAnaBot;
• ter entre 5 e 32 caracteres;
• usar só letras sem acento, números e sublinhado (_);
• não estar em uso por outra conta, bot, grupo ou canal.

Se o nome já estiver em uso, o BotFather avisa e pede outro. Escolha com calma: é o endereço que você vai divulgar. Já o nome de exibição (o que aparece no topo da conversa) é livre, aceita acentos e espaços e pode ser trocado quando quiser.

Perdi o token ou ele vazou: e agora?

Para ver o token de novo: no BotFather, envie /mybots, escolha o bot e toque em API Token. O token atual aparece na tela.

Para trocar o token (se você mostrou para alguém, publicou sem querer ou desconfia de algo): no mesmo menu, toque em Revoke current token, ou envie /revoke e escolha o bot. O BotFather gera um token novo e o antigo para de funcionar na hora.

Depois de trocar, atualize o token no lugar onde o bot roda. Até lá, o bot fica sem responder. No AIBotBuild é só colar o novo token na conversa e pedir para a IA atualizar.

Configurações que valem a pena no BotFather

Tudo isso fica em /mybots > seu bot > Edit Bot, ou pelos comandos diretos:

• /setuserpic: foto do bot. Faz diferença na hora de a pessoa confiar.
• /setdescription: texto que aparece na conversa vazia, antes de a pessoa tocar em Iniciar. Diga em uma frase o que o bot faz.
• /setabouttext: a "bio" curta que aparece no perfil do bot.
• /setcommands: lista de comandos que aparece no botão de menu, como /start, /ajuda, /agenda.
• /setname: troca o nome de exibição.
• /setjoingroups: permite ou bloqueia que adicionem o bot a grupos.
• /setprivacy: modo de privacidade em grupos. Ligado (padrão), o bot só recebe comandos e respostas às mensagens dele. Desligado, recebe todas as mensagens do grupo.

Se o bot vai ser gerenciado por uma ferramenta, ela pode cuidar dos comandos e textos por você. Foto e privacidade em grupo normalmente ficam com você no BotFather. Foto e descrição bem feitas também ajudam na hora de divulgar o bot.

Problemas comuns

• "Não encontro o BotFather." Pesquise @BotFather na busca do Telegram. O verdadeiro tem o selo azul de verificado. Ignore contas parecidas.
• "O BotFather está em inglês." É assim mesmo. Os comandos são poucos e os passos acima cobrem o necessário.
• "Criei o bot e ele não responde." Normal: o BotFather só cria a conta. Quem responde é o programa, que ainda precisa ser escrito e colocado para rodar com o token.
• "O programa diz que o token é inválido." Confira se copiou o token inteiro, sem espaço no começo ou no fim, e se ele não foi trocado depois.

Perguntas frequentes