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
- Abra o @BotFather no Telegram. Confira o selo azul ao lado do nome, porque existem imitações.
- Toque em Iniciar ou envie /start.
- Envie /newbot.
- 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.
- 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.
- 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…

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.