Um bot em uma hora: ChatGPT escreve o código

Este é o prompt que faz 80% do trabalho deste curso. Tudo o que você precisa é de qualquer acesso ao ChatGPT — a versão gratuita é suficiente. Primeiro, o prompt completo, depois por que cada linha tem seu lugar — e como aceitar o trabalho sem ler o código.

O prompt mestre para código de bot

Write a Telegram bot in Python (python-telegram-bot library).
What it does: replies to the /start command with a greeting,
and echoes any text message back politely.
Requirements: read the token from the BOT_TOKEN environment
variable, keep everything in one file bot.py, comment every code
block in plain words explaining what it does. Add exactly one
feature at a time: just this for now, we'll extend later.
I'm not a programmer: finish with step-by-step launch instructions.

Por que o prompt é construído assim

• «em Python (python-telegram-bot)» — a linguagem e biblioteca mais populares para bots: o ChatGPT já viu milhares de projetos assim, então os erros de geração são mínimos. Popularidade da stack = qualidade do código que você receberá.
• «token de uma variável de ambiente» — uma variável de ambiente é uma configuração nomeada que o programa recebe do sistema no lançamento, em vez de seu próprio texto. Assim, o token (lembra da chave de ignição da lição anterior?) nunca aparece no texto do código. Um hábito desde o primeiro dia: no módulo 24/7, você verá o desastre que isso evita.
• «comentar em palavras simples» — o código se torna legível: você vê o que acontece onde sem conhecer Python.
• «uma funcionalidade por vez» — código simples é fácil de verificar. Quer dez funcionalidades? Peça-as uma por uma, cada uma em sua própria mensagem de acompanhamento.
• «Não sou programador: instruções de lançamento» — coloca o ChatGPT no modo mentor paciente, sem jargões.

Por que python-telegram-bot especificamente

Uma biblioteca é um kit de peças prontas a partir das quais os programas são construídos: em vez de «ditar ao Telegram letra por letra o que eu quero», você obtém comandos prontos como «responder» e «mostrar botões». python-telegram-bot foi desenvolvida por mais de dez anos e acompanha cada nova versão da Bot API: a 10.0 é totalmente suportada, e o suporte a Rich Messages da 10.1 está a caminho. Para você, isso significa que a biblioteca está viva, e o código que o ChatGPT gera não vai desmoronar de velhice em um mês.

O que volta — e um detalhe

O ChatGPT responderá ao prompt mestre em três partes: o código em si (um bloco, o arquivo bot.py), uma breve explicação do que está dentro e instruções de lançamento passo a passo. Salve o código em um arquivo bot.py no seu computador — vamos executá-lo na próxima lição.

Um detalhe que vale a pena saber de antemão: o ChatGPT às vezes produz código com confiança em um estilo desatualizado — as bibliotecas de bot mudaram ao longo dos anos, e a internet está cheia de exemplos antigos. O sinal de alerta: o código menciona a biblioteca telebot ou algo que você não pediu. Uma resposta resolve: «Use python-telegram-bot especificamente, uma versão recente, sintaxe da versão 21 ou mais nova». São exatamente esses exemplos desatualizados que fazem cursos em vídeo sobre bots apodrecerem em um ano — um texto e um prompt são fáceis de atualizar, regravar cem vídeos não é.

Aceitação: três perguntas do cliente

O código chegou. Você não precisa lê-lo — mas precisa aceitar o trabalho. Um cliente profissional não se debruça sobre plantas; ele pergunta «o que quebra se…». Pergunte ao ChatGPT na mesma conversa:

1. «O que o bot fará se um usuário enviar uma foto ou uma nota de voz em vez de texto?» — uma verificação de limite: um bom código não trava no inesperado.
2. «O que acontece se a internet cair por um minuto?» — uma verificação de resiliência: o programa deve sobreviver a um soluço, não morrer para sempre.
3. «Este código envia dados para algum lugar além do Telegram?» — uma verificação de honestidade: não deve haver destinatários extras no código.

Se alguma resposta não te satisfizer, pergunte imediatamente: «corrija o código para que…». Esse é o seu papel: você é o cliente e o inspetor. Você especifica, executa, verifica, solicita correções. Isso é vibe coding (a abordagem onde a IA escreve o código e o humano define as tarefas e aceita o trabalho) — exceto que o produto aqui é um bot.

Experimente no sandbox: anatomia do código

Veja como o código de bot é construído antes mesmo de você instalar o Python. O prompt é autocontido:

You are ChatGPT and I'm commissioning a bot. My order: «Write
a Telegram bot in Python (python-telegram-bot library).
It replies to /start with a greeting and politely echoes any text.
Token from the BOT_TOKEN environment variable, one file bot.py,
every block commented in plain words. I'm not a programmer:
finish with launch instructions».
Generate the code, then dissect it as a teacher: show which line
reads the token; what a handler is and which handlers are here;
where the bot starts «listening» to Telegram; and what breaks
if each block is removed in turn.

Após essa explicação, a palavra handler (um pedaço de código responsável por um tipo de mensagem: o comando /start, texto simples, um clique de botão) deixa de ser mágica — e qualquer bot é construído precisamente a partir de handlers.

O que vem a seguir

Você tem o prompt e o ritual de aceitação. Na próxima lição, vamos executar o código gerado no seu computador — e o bot responderá a você no Telegram pela primeira vez.