Telegram é opcional. @BotFather é a conta oficial do Telegram que cria bots; o token é o código secreto do seu bot, e o id é o número da sua conta. O token fica no cofre; só ids cadastrados podem conversar com o bot. Os testes do projeto usaram servidor falso local.
Objetivo: Preparar o token no cofre e configurar o id de dono para que o bot responda só à pessoa autorizada.
01 · Mensagem até a resposta
Sem dono cadastrado, o bot só responde /id.
Clique em cada bloco do diagrama para ver o que ele faz.
Clique em cada parte para ver sua função.
02 · Ligue só se você for usar
Clique em cada etapa para ver o que fazer.
1. Criar bot
Abra @BotFather no Telegram, envie /newbot, escolha um nome e depois um nome de usuário que termina em bot. Copie o token recebido: é o código secreto do bot. Não cole em USER.md, AGENTS.md ou config.json. O @BotFather manda também o link do seu bot, no formato t.me/nome_bot: abra esse link para conversar com ele.
2. Guardar segredo
O comando guardar telegram pede o token sem exibi-lo. O arquivo de configuração guarda os ids, não o token.
3. Descobrir id
Ligue o bot, mande /id e anote o número. A mensagem real diz “Coloque em telegram_donos no config.json”. Você pode preencher esse mesmo campo pelo configurar, na pergunta de ids do Telegram. Pare o bot com Ctrl+C antes de configurar.
4. Cadastrar dono
Informe o id na pergunta de donos e ligue o bot novamente. Teste com outra conta se tiver uma; somente a sua deve receber resposta. Se um comando pedir aprovação, responda /sim ou /nao em até 120 segundos; depois disso o pedido expira e o comando não roda.
03 · Sequência opcional
Copie os comandos e rode no terminal a partir da pasta indicada.
Os testes automatizados usam servidor Telegram falso: filtro de dono, formato das mensagens e aprovação por /sim. Não houve teste ao vivo do bot pelo INEMA.
04 · Verifique quem manda
Opcional. Depende do seu bot e da sua conta; esta integração não foi testada ao vivo pelo INEMA.
Conclua o cadastro
8
Se usar Telegram, obtenha /id, coloque o número em configurar e ligue novamente. Se não usar, pule sem bloquear o restante do curso.
Pronto quando: O bot responde ao seu id; uma outra conta não recebe resposta, se você puder testar com ela.
Confira uma aprovação
5
No chat com o seu bot, mande “rode: echo teste > nota.txt”. Isso pede aprovação porque grava arquivo. Responda /nao primeiro; só use /sim se você quiser mesmo criar o arquivo. A aprovação expira após 120 segundos sem /sim ou /nao.
Pronto quando: A auditoria registra a decisão e o comando não roda após /nao.
05 · Confira se entendeu
Escolha antes de abrir o comentário. Se errar, use o link para rever.
Pergunta 1 de 3
Onde guardar o token do bot?
Correto
O cofre guarda o segredo cifrado. telegram_donos contém somente ids de usuários.