Como bots funcionam: BotFather, o token e getUpdates

Vamos ver o que um bot realmente é — então fica claro por que qualquer um pode construir um, incluindo alguém que «não entende de computador».

Um bot = um programa + um «socket» do Telegram

Todo bot tem duas partes:

1. Uma conta de bot no Telegram — um nome, um avatar, um handle como @seu_bot. Dois minutos para criar, e por si só não faz nada: é uma vitrine e um «socket» onde a segunda parte se conecta.
2. Um programa que recebe as mensagens dos usuários via Telegram e envia respostas. Ele pode viver em qualquer lugar: no seu computador ou em um servidor.

O Telegram transporta as mensagens entre o usuário e seu programa — sem app, sem site, sem interface para construir. Botões, chats, notificações — tudo já feito e rodando em bilhões de celulares. É por isso que bots são a maneira mais fácil de construir produtos: você escreve apenas o «cérebro», o Telegram fornece o «corpo».

BotFather: onde os bots nascem

Lembre-se da lição anterior: a plataforma de bots abriu em 2015 junto com o @BotFather. É o bot registrador oficial: envie /newbot, escolha um nome (as pessoas o veem) e um handle (deve terminar em bot) — e ele te entrega um token: uma longa sequência como 7213…:AAH8…. O BotFather também é onde você configura mais tarde a «cara» do bot: descrição, avatar, o menu de comandos.

O token é a chave de ignição

O token conecta seu programa à conta do bot: o programa o apresenta ao Telegram e ganha o direito de falar como o bot. Quem tem o token controla o bot. Duas regras de ferro se seguem:

• Nunca mostre o token a ninguém — nem em chats, nem em capturas de tela, nem em código que você postar em qualquer lugar. Alguém com seu token pode responder aos seus clientes como seu bot — e você nem vai perceber na hora.
• Vazou — substitua. O BotFather tem /revoke: o token antigo morre instantaneamente, um novo é emitido. Isso leva um minuto e não é nada para se envergonhar; esperar que «ninguém notou» é.

Como um bot sabe que recebeu uma mensagem: getUpdates

Aqui está uma pergunta que quase ninguém faz, e deveria: a mensagem de um usuário «voa» para o seu programa sozinha? Pense por um segundo. Na verdade — não. O Telegram armazena tudo o que é escrito para o seu bot em uma fila nos seus servidores — imagine uma caixa de correio registrada para o seu bot. E o programa vai buscar o correio por conta própria: a cada poucos segundos ele envia ao Telegram uma requisição getUpdates — literalmente «entregue as atualizações» — e coleta as mensagens acumuladas. Responde, pergunta de novo, e assim por diante em um loop. É exatamente por isso que um bot fica em silêncio quando o programa está desligado: as cartas se acumulam, mas ninguém vem buscá-las.

Essa mecânica tem uma consequência que vai te poupar horas: uma caixa de correio, uma chave. Inicie duas cópias do programa com o mesmo token — digamos, no seu laptop e em outro lugar — e elas começarão a pegar as cartas uma da mão da outra, e o Telegram responderá com um erro. Mantenha a imagem do correio em mente: na lição sobre deploy em servidor, isso explicará a falha mais comum de iniciantes.

O que há de novo para bots em 2026

Os fundamentos acima não mudaram em dez anos — mas os «cosméticos» crescem a cada versão da Bot API: botões ganharam cores, chats ganharam checklists, mensagens ganharam modo de desaparecimento. Boas notícias: nosso bot só precisa do básico, e você pode pedir os detalhes sofisticados ao ChatGPT mais tarde com uma única frase — assim que o básico funcionar.

Faça isso agora

Abra o @BotFather → /newbot → invente um nome e um handle (terminando em bot). Salve o token nas suas anotações — não em chats. Na próxima lição, vamos comissionar o programa que dará vida a este bot.

Experimente na sandbox

Fixe a regra do token através de uma história — copie o prompt inteiro:

Act out a scene and then dissect it. The hero is Mitya, a beginner.
He created a bot via @BotFather, got the token 7213456789:AAH8xQ…
(made up) and, excited, sent a screenshot with the token to a chat
of 200 friends. Show step by step: what anyone in that chat can do
with the token; what Mitya will see (and not see) from his side;
which BotFather command saves his bot. Finish with a one-sentence
rule for storing tokens.

Então, verifique o quanto você entendeu a mecânica do correio:

Using a mailbox metaphor, explain how a Telegram bot's program
receives messages via the getUpdates request: Telegram puts letters
into a box, the program comes to collect them itself. Then test me:
ask 3 comprehension questions (including what happens if two
programs fetch mail with the same key) and review my answers.