FlowAgents

Criar um bot do Telegram com o BotFather e copiar o token

Publicado em 16. novembro 2026

Cada agente de IA recebe um bot próprio no Telegram. É por esse bot que você escreve para o agente, e ele responde a você ali mesmo. Você mesmo cria o bot no BotFather, a ferramenta oficial do Telegram para bots. No final, você recebe um token do bot, que depois cadastra no seu agente.

Antes de começar

  • Você precisa de uma conta no Telegram, veja Criar uma conta e um nome de usuário no Telegram.
  • Crie um bot separado para cada agente. Um bot que já está sendo usado para outra coisa não pode ser conectado.
  • Pense antes em um nome, por exemplo o nome do agente.

Criar o bot

  1. Abra o @BotFather no Telegram. Confira o selo azul ao lado do nome, porque existem imitações.
  2. Toque em Iniciar ou envie /start.
  3. Envie /newbot.
  4. O BotFather pergunta o nome do bot. É o nome de exibição que aparece no topo do chat, por exemplo Matthias Haller. Espaços e acentos são permitidos.
  5. Em seguida, o BotFather pergunta o nome de usuário. Ele precisa terminar em bot, por exemplo matthias_haller_bot ou MatthiasHallerBot, e pode ter de 5 a 32 letras, algarismos ou sublinhados. Se o nome já estiver em uso, tente uma variação.
  6. O BotFather confirma o novo bot e envia uma mensagem com o token. Ele aparece abaixo de "Use this token to access the HTTP API" e tem mais ou menos esta cara: 123456789:AAH4kq…

O chat com o BotFather: /newbot, o nome Matthias Haller, o nome de usuário matthias_haller_bot e a resposta com o token

Copiar o token

  • Toque no token na mensagem, e o Telegram o copia para a área de transferência.
  • Copie o token inteiro, com os algarismos antes dos dois-pontos e tudo o que vem depois.
  • Cole-o diretamente para o seu agente, como descrito no artigo Conectar seu agente de IA ao Telegram.

Proteger o token

O token é como uma senha: quem o conhece pode controlar o bot.

  • Não encaminhe o token por e-mail ou chat e não o guarde em documentos compartilhados.
  • Nunca vamos pedir o token por e-mail ou telefone. Você só o digita pessoalmente na janela Conectar o Telegram.
  • Não cadastre o token em nenhum outro lugar, por exemplo em outra ferramenta de chat. Um bot só pode ser usado por um programa de cada vez.
  • Se o token cair em mãos erradas, envie /revoke ou /token ao BotFather, escolha o bot e peça um token novo. O antigo deixa de funcionar na hora. Se o bot já estiver conectado ao seu agente, você não consegue trocar o token sozinho: fale com a gente, e combinamos com você uma forma segura de nos passar o token.

Opcional: foto e descrição

  • /setuserpic define uma foto de perfil para o bot, por exemplo a foto do seu agente.
  • /setdescription define o texto que as pessoas veem antes de iniciar o bot pela primeira vez.

Você pode mudar essas informações quando quiser, a conexão com o agente não é afetada.

Este artigo foi útil?

Voltar para Telegram