Como pegar o token do bot no BotFather

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

Para pegar o token, abra o @BotFather no Telegram, envie /newbot, escolha um nome e um nome de usuário terminado em "bot". Na resposta, o BotFather mostra o token, uma sequência no formato números:letras. Se já tem o bot, envie /mybots, escolha o bot e toque em API Token.

1. O que é o token do bot
2. Passo a passo: criar o bot e copiar o token
3. Como ver o token de um bot que já existe
4. O token vazou: como revogar e gerar outro
5. Como guardar o token com segurança
6. Ajustes úteis depois de criar o bot
7. Erros comuns e como resolver
8. Como usar o token no AIBotBuild
9. Perguntas frequentes

O que é o token do bot

O token é a chave de acesso do bot. O Telegram cria um token único para cada bot. Ele identifica o bot, não a sua conta pessoal.

O formato é sempre o mesmo: um número, dois-pontos e um trecho longo de letras, números, hífen e sublinhado. A documentação oficial do Telegram usa este exemplo:

123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

A parte antes dos dois-pontos é o número do bot. A parte depois é a parte secreta. As duas juntas formam o token.

O que o token permite: qualquer programa que tenha o token controla o bot por completo. Ele recebe as mensagens que chegam ao bot, responde em nome dele, envia fotos e arquivos, administra grupos onde o bot é admin e muda a lista de comandos. O próprio Telegram resume assim: quem tem o token tem controle total do bot.

O que o token não faz: não dá acesso à sua conta do Telegram, às suas conversas pessoais nem aos seus contatos.

Passo a passo: criar o bot e copiar o token

Leva uns três minutos. Funciona igual no celular e no computador. O BotFather responde em inglês, mas os passos são poucos.

1. Abra o BotFather. Na busca do Telegram, digite @BotFather. Abra a conta com o selo azul de verificado. Ignore contas com nomes parecidos.
2. Toque em Iniciar. Ou envie /start. Ele responde com a lista de comandos.
3. Envie /newbot. É o comando que cria um bot novo. O BotFather pergunta como o bot vai se chamar.
4. Escolha o nome. É o nome que aparece no topo da conversa e no perfil, como "Agenda do Salão da Ana". Pode ter acento e espaço. Dá para trocar depois.
5. Escolha o nome de usuário. O BotFather pede o username e avisa que ele precisa terminar em "bot". Exemplos: agenda_salao_ana_bot ou AgendaSalaoAnaBot.
6. Copie o token. Se o nome de usuário estiver livre, o BotFather manda uma mensagem de parabéns com o link do bot (t.me/seu_bot), o token e um aviso para guardar o token em segurança. Toque no token para copiar.
7. Guarde o token. Cole só no lugar onde o bot vai rodar ou num gerenciador de senhas. Veja abaixo onde guardar.

Regras do nome de usuário, segundo a documentação do Telegram:

• de 5 a 32 caracteres;
• só letras sem acento (alfabeto latino), números e sublinhado (_);
• precisa terminar em bot, como tetris_bot ou TetrisBot;
• maiúscula e minúscula não fazem diferença: LojaBot e lojabot são o mesmo endereço;
• não pode estar em uso por outra conta, bot, grupo ou canal.

O nome de usuário vira o endereço público do bot: https://t.me/nome_do_bot. É ele que você vai divulgar, então escolha algo curto e fácil de digitar.

Como ver o token de um bot que já existe

Perdeu o token, mas ele não vazou? Dá para ver o mesmo token de novo, sem trocar nada:

1. Abra o @BotFather e envie /mybots.
2. Toque no bot que você quer.
3. Toque em API Token. O token atual aparece na tela.

Esse caminho não muda o token. O programa que já usa o bot continua funcionando.

E o comando /token? A documentação oficial do Telegram diz que ele serve para gerar um token novo, para quando o atual foi exposto ou perdido. Se o BotFather gerar um token novo, o antigo deixa de valer e o bot para até você atualizar o lugar onde ele roda. Para só consultar, prefira /mybots.

O token vazou: como revogar e gerar outro

Mostrou o token num print, mandou num grupo, publicou num código aberto ou desconfia de alguém? Troque na hora. Revogar é o único jeito de cortar o acesso de quem copiou o token.

Pelo menu: /mybots → escolha o bot → API Token → Revoke current token.

Pelo comando: envie /revoke e escolha o bot.

O que acontece depois:

• o BotFather mostra um token novo;
• o token antigo para de funcionar na hora, para você e para quem tinha a cópia;
• o programa que usava o token antigo recebe erro de acesso (Unauthorized) e o bot fica mudo;
• o bot em si não muda: nome, username, foto, comandos e pessoas que já conversaram com ele continuam iguais.

Por último, cole o token novo no lugar onde o bot roda. Assim que fizer isso, o bot volta a responder.

Como guardar o token com segurança

Trate o token como a senha do banco. O Telegram pede o mesmo: guarde em lugar seguro e não compartilhe com ninguém.

• Não poste print da conversa com o BotFather. O token fica legível na imagem.
• Não mande em grupo, comentário, fórum ou chat de suporte aberto. Quem pedir o token "para ajudar" ganha controle do bot.
• Não coloque no código publicado. Se o código vai para um site como o GitHub, o token deve ficar fora dele, numa variável de ambiente ou num cofre de segredos.
• Guarde num gerenciador de senhas. É o lugar mais seguro para ter uma cópia.
• Use um token em um lugar só. Cada cópia a mais é mais uma chance de vazar.
• Revogue quando trocar de ferramenta ou de pessoa que cuida do bot.

Na dúvida se vazou, revogue. Custa um minuto e não apaga nada do bot.

Ajustes úteis depois de criar o bot

Todos ficam em /mybots → seu bot → Edit Bot, ou pelos comandos abaixo. Cada comando pergunta qual bot você quer mudar.

• /setname: troca o nome de exibição do bot.
• /setdescription: texto que aparece na conversa vazia, antes de a pessoa tocar em Iniciar (até 512 caracteres). Diga o que o bot faz.
• /setabouttext: o "sobre" curto do perfil do bot (até 120 caracteres).
• /setuserpic: foto do bot. Ajuda a pessoa a confiar.
• /setcommands: lista de comandos do botão de menu, como /start, /ajuda e /agenda.
• /setprivacy: define o que o bot recebe em grupos. Ligado (padrão), ele recebe comandos dirigidos a ele e respostas às mensagens dele. Desligado, recebe todas as mensagens do grupo. Depois de mudar, tire o bot do grupo e adicione de novo.
• /setjoingroups: permite ou bloqueia que adicionem o bot a grupos.

Para apagar um bot, existe o /deletebot. Ele apaga o bot e libera o nome de usuário. Não tem volta.

Erros comuns e como resolver

• "O nome de usuário já existe." O BotFather avisa que o username está em uso e pede outro. Junte palavras, acrescente a cidade ou o ramo (salao_ana_bh_bot) e tente de novo.
• "O nome não termina em bot." Todo username de bot precisa terminar em bot. agenda_ana não passa; agenda_ana_bot passa.
• "O username tem caractere inválido." Tire acentos, espaços, pontos e hífens. Só vale letra, número e sublinhado.
• "O token é inválido." Quase sempre é cópia errada. Confira se veio inteiro, com os dois-pontos, sem espaço ou quebra de linha no começo ou no fim. Se ainda falhar, veja em /mybots se o token não foi trocado depois.
• "Criei o bot e ele não responde." Normal. O BotFather só cria a conta do bot. Quem responde é um programa que precisa estar rodando com o token, 24 horas, num servidor. Sem programa rodando, o bot fica mudo.
• "O bot parou do nada." Veja se alguém revogou o token, ou se o mesmo token está em dois programas ao mesmo tempo. As duas formas de o bot receber mensagens (consulta e webhook) não funcionam juntas.
• "O bot não vê as mensagens do grupo." É o modo de privacidade. Desligue em /setprivacy ou faça o bot administrador do grupo.

Como usar o token no AIBotBuild

No AIBotBuild, você descreve em português o bot que quer e uma IA escreve o programa, testa e deixa o bot no ar 24 horas. O token é o que liga esse programa ao bot que você criou no BotFather.

1. Crie o bot no BotFather e copie o token, como mostrado acima.
2. No painel, descreva o bot que você quer.
3. Quando o agente pedir, cole o token. Ele confere na hora se o token é válido e qual é o bot.
4. O token fica guardado criptografado, fora do código e fora da conversa com a IA.

Se trocar o token no BotFather, cole o novo no painel e o bot volta a responder. Para testar, há 3 dias grátis, sem cartão; os planos estão em preços.

Perguntas frequentes