E2 · O bot no Telegram
10 minCrie o bot no @BotFather com /newbot e guarde o token no .env da pasta do projeto.
Pronto quando: você tem o token e ele não aparece em nenhum arquivo além do .env (a busca do terceiro bloco não acha nada).
Aula 3 · 15 min
A porta: o bot no Telegram, com um dono só
O Telegram é a porta mais simples: você cria o bot em dois minutos e recebe um token. Esse token é a chave da porta. Quem tem o token controla o bot, e qualquer pessoa pode mandar mensagem para um bot. Por isso a aula é metade criar e metade proteger.
Começar a aula
Nesta aula você vai
- 1Criar o bot com /newbot no @BotFather
- 2Por que o token fica só no .env e fora do Git
- 3Como o canal conversa com o Telegram (long-polling)
- 4Por que o bot precisa aceitar só o dono
Objetivo: criar o bot no @BotFather, guardar o token só no .env e definir que o assistente responde apenas a você.
01Do @BotFather ao seu bot
Clique em cada bloco.
Clique em cada bloco do diagrama para ver o que ele faz.
O INTELECTO foi desenhado para um usuário. Um Jarvis com acesso à sua máquina é poderoso, e por isso mesmo merece cuidado.
02Criar e proteger, passo a passo
Clique em cada etapa.
1. Criar o bot
No Telegram, procure @BotFather (o oficial, com selo de verificado) e mande /newbot.
Escolha o nome que aparece na conversa e o @usuário, que precisa terminar em bot. Ele responde com o token.
Nome
Use o nome do seu meu-jarvis.md. O @usuário pode ser o nome + _bot.
2. Guardar o token
Cole o token numa linha do .env da pasta do projeto, como aprendeu no degrau 1.
Confira se o .env está no .gitignore. Chave exposta no GitHub é encontrada por robôs em pouco tempo.
Regra do degrau 1
O token não aparece em nenhum arquivo além do .env.
3. Um dono só
Quando for construir (aula 4), peça ao agente que o bot responda só ao seu usuário do Telegram e ignore os outros.
No cofre (aula 7) você vê por que isso importa ainda mais quando o assistente roda comandos.
Pedido ao agente
O bot responde só ao meu usuário do Telegram; mensagens de outras pessoas são ignoradas e registradas.
4. Se o token vazar
Token em print, em grupo ou em commit é token vazado. Não apague e torça: gere um novo no @BotFather e troque no .env.
O token antigo deixa de valer, e quem pegou perde o acesso.
No @BotFather
/mybots → escolha o bot → API Token → gerar um novo.
03O .env e a conferência
Troque o texto entre < > pelo seu token. Nunca cole o token aqui no curso nem num chat.
.env (na pasta do projeto)
TELEGRAM_BOT_TOKEN=<cole aqui o token do @BotFather>
Terminal · conferir que o .env não sobe
grep -n ".env" .gitignore git status --short
Terminal · procurar o token fora do .env
grep -rn "<os 6 primeiros caracteres do token>" . --exclude=.env
Simulação: exemplo ilustrativo
grep mostra a linha .env no .gitignore.
git status não lista o .env.
A busca pelo começo do token não acha nada fora do .env.
Se o git status mostra ?? .env, falta a linha no .gitignore: acrescente antes de qualquer commit.
Se a busca acha o token em outro arquivo, apague de lá e gere um token novo no @BotFather.
04Prática: o bot no Telegram
Exercício E2 da sequência 2.
E2b · Anote o pedido do dono único
5 minNo seu meu-jarvis.md, acrescente a regra: responde só a mim no Telegram.
Pronto quando: a regra está escrita e vai junto no pedido de construção da aula 4.
05Teste o que aprendeu
A explicação aparece depois da sua resposta.
Pergunta 1 de 3
Onde o token do bot pode aparecer?competência
Correto
Quem tem o token controla o bot. Ele vive só no .env, que está no .gitignore; em qualquer outro lugar, conte como vazado e troque.Não é essa
Quem tem o token controla o bot. Ele vive só no .env, que está no .gitignore; em qualquer outro lugar, conte como vazado e troque.Rever: Criar e proteger, passo a passoPergunta 2 de 3
Por que o bot precisa de uma lista de quem pode falar?
Correto
Bot do Telegram é público para quem achar o @. Sem a lista, um estranho conversa com o seu Jarvis e com as ferramentas dele.Não é essa
Bot do Telegram é público para quem achar o @. Sem a lista, um estranho conversa com o seu Jarvis e com as ferramentas dele.Rever: Do @BotFather ao seu botPergunta 3 de 3
O seu token apareceu num print que você postou. Qual o certo?
Correto
Apagar não desfaz o vazamento. Gerar um token novo invalida o antigo; quem copiou perde o acesso.Não é essa
Apagar não desfaz o vazamento. Gerar um token novo invalida o antigo; quem copiou perde o acesso.Rever: Criar e proteger, passo a passoTeste concluído
Você acertou {a} de {n}. Acertando todas, a aula é marcada como concluída.Escolha uma alternativa. A explicação aparece depois da sua tentativa.