Você já imaginou ter seu próprio assistente virtual no Telegram que responde mensagens automaticamente? Eu também! Queria uma forma rápida de ser avisado quando eventos acontecessem, então decidi criar meu próprio assistente no Telegram. Parece coisa de programador experiente, mas a verdade é que qualquer pessoa pode criar um bot para Telegram, mesmo sem nunca ter escrito uma linha de código na vida. Neste artigo, vou te guiar passo a passo nessa jornada emocionante de criar seu primeiro bot usando Python, uma das linguagens de programação mais amigáveis para iniciantes.
O que é um bot ?
Os bots do são programas automatizados que podem interagir com usuários, responder perguntas, enviar notificações, gerenciar grupos e muito mais. Empresas usam bots para atendimento ao cliente, criadores de conteúdo usam para engajar sua audiência, e você pode usar para automatizar tarefas do seu dia a dia. O melhor de tudo? Vamos construir um bot funcional em menos de uma hora, e você não precisa de nenhum conhecimento prévio em programação.
O que você vai precisar ?
Antes de começarmos a programar, precisamos preparar nosso ambiente de trabalho. Pense nisso como organizar sua bancada antes de iniciar um projeto de artesanato. Você não precisa se preocupar com equipamentos caros ou softwares pagos. Tudo o que vamos usar é completamente gratuito.
Primeiramente, você precisará de um computador com Windows, Mac ou Linux. Qualquer computador razoavelmente moderno serve perfeitamente para este projeto. Além disso, você precisará de uma conexão com a internet para baixar os programas necessários e para que seu bot funcione.
Em termos de software, vamos precisar de três coisas principais: o Python (a linguagem de programação que vamos usar), um editor de código (onde vamos escrever nosso programa), e uma conta no Telegram (que você provavelmente já tem). Não se assuste com esses termos, vou explicar cada um deles em detalhes nas próximas seções.
Por fim, reserve cerca de 30 a 60 minutos do seu tempo. Sei que pode parecer muito, mas prometo que o tempo vai passar voando quando você ver seu bot funcionando pela primeira vez. A sensação de criar algo do zero é incrivelmente recompensadora!
Instalando o Python
O Python é uma linguagem de programação conhecida por sua simplicidade e legibilidade. Foi criada com o objetivo de ser fácil de aprender, o que a torna perfeita para iniciantes. Quando instalamos o Python no computador, estamos basicamente ensinando nossa máquina a entender e executar os comandos que vamos escrever.
Para usuários Windows
Acesse o site oficial do Python e clique no botão de download. O site automaticamente detectará que você está usando Windows e oferecerá a versão correta. Faça o download do instalador e execute-o.
Durante a instalação, você verá uma tela inicial com algumas opções. Marque obrigatoriamente a caixa que diz “Add Python to PATH” antes de clicar em “Install Now”. Essa opção é extremamente importante porque permite que você use o Python de qualquer lugar no seu computador. Se você esquecer de marcar essa caixa, terá problemas mais tarde.
Após a instalação, você pode verificar se tudo deu certo abrindo o Prompt de Comando e digite comando:
python --version
Se aparecer algo como “Python 3.11.4” (ou qualquer versão 3.x), parabéns! A instalação foi bem-sucedida.
Para usuários Mac
Se você usa Mac, o processo é igualmente simples. Acesse o site, baixe o instalador para macOS e execute-o. Siga as instruções na tela, clicando em “Continuar” e “Instalar”. Você precisará digitar sua senha de administrador para autorizar a instalação.
Para verificar a instalação, abra o Terminal e digite
python3 --version
A presença de um número de versão confirma que tudo está funcionando corretamente.
Para usuários Linux
Diferentemente dos outros sistemas operacionais, o Linux é um sistema que já tem nativamente o Python instalado, com isso não requer qualquer instalação no que diz repeito a linguagem. Para conferir a ver instalada, você pode digitar o mesmo comando que é usado no Mac.
Instalando um editor de código
Um editor de código é como um Microsoft Word para programadores. É onde vamos escrever nosso programa, mas com recursos especiais que facilitam a programação, como destaque de cores para diferentes partes do código e detecção de erros.
Recomendo fortemente o Visual Studio Code, que é gratuito, poderoso e muito amigável para iniciantes. Acesse o site oficial, baixe o instalador apropriado para seu sistema operacional e siga o processo de instalação padrão (basicamente, clique em “Próximo” até finalizar).
Quando você abrir o VS Code pela primeira vez, verá uma interface que pode parecer um pouco intimidadora, mas não se preocupe. Vamos usar apenas os recursos básicos. A área principal é onde você escreverá seu código, e o painel lateral esquerdo mostra seus arquivos e pastas. É só isso que você precisa saber por enquanto!
Uma dica útil: o VS Code possui uma extensão para Python que facilita muito a programação. Para instalá-la, clique no ícone de quadradinhos no painel lateral esquerdo (Extensions), digite “Python” na barra de busca e instale a extensão oficial da Microsoft. Essa extensão adiciona recursos como autocompletar e verificação de erros em tempo real.
Criando o Bot no telegram
Agora chegamos à parte divertida: vamos criar oficialmente nosso bot no Telegram! Para isso, utilizaremos um bot especial chamado BotFather, que é o bot oficial do Telegram responsável por criar e gerenciar outros bots. Sim, é um bot que cria bots.
Abra o Telegram no seu celular ou computador e procure por “@BotFather” na barra de busca. Certifique-se de selecionar o perfil verificado (aquele com o selo azul de verificação). Inicie uma conversa com ele clicando em “Iniciar” ou “Start”.
Digite o comando /newbot e envie. O BotFather pedirá primeiro um nome para seu bot. Esse nome é o que aparecerá nas conversas, então escolha algo amigável como “Meu Primeiro Bot” ou “Assistente do João”. Pode usar espaços e emojis se quiser.
Em seguida, ele pedirá um username para o bot. Esse precisa ser único em todo o Telegram e obrigatoriamente terminar com “bot”. Por exemplo: “meu_primeiro_bot”, “joao_assistente_bot” ou “teste2026_bot”. Se o nome que você escolher já estiver em uso, tente adicionar números ou palavras diferentes até encontrar um disponível.
Após escolher um username válido, o BotFather enviará uma mensagem de parabéns contendo informações importantes, incluindo o Token de API. Esse token é como a “senha mestre” do seu bot, ele permite que seu programa se comunique com o Telegram. O token se parece com algo assim: 6123456789:ABCdefGHIjklMNOpqrSTUvwxYZ12345678.
Guarde esse token em um lugar seguro e nunca compartilhe com ninguém! Quem tiver acesso a esse token pode controlar seu bot completamente. Se você acidentalmente compartilhar seu token, use o comando /revoke no BotFather para gerar um novo.
Instalando a biblioteca do telegram
Bibliotecas em programação são conjuntos de código pré-escrito que nos ajudam a realizar tarefas complexas de forma simples. Em vez de escrevermos centenas de linhas de código para nos comunicar com o Telegram, usamos uma biblioteca que já faz isso por nós. A biblioteca que vamos usar se chama python-telegram-bot.
Para instalar essa biblioteca, precisamos usar o pip, que é o gerenciador de pacotes do Python. Pense no pip como uma loja de aplicativos, mas para bibliotecas de programação. Ele vem instalado automaticamente junto com o Python.
Abra o Prompt de Comando se estiver no Windows ou Terminal se estiver no Linux/Mac e digite o seguinte comando:
pip install python-telegram-bot
Pressione Enter e aguarde. Você verá várias linhas de texto aparecendo na tela enquanto o pip baixa e instala a biblioteca. Quando o processo terminar e você ver seu cursor de volta, significa que a instalação foi concluída com sucesso.
Se você receber algum erro dizendo que o pip não foi encontrado, provavelmente a instalação do Python não foi feita corretamente. Volte ao processo de instalação do Python e refaça a instalação, lembrando-se de marcar a opção “Add Python to PATH”.
Escrevendo o código do Bot
Chegou o momento mais esperado: vamos finalmente escrever o código do nosso bot! Não se preocupe se parecer complicado à primeira vista.
Abra o Visual Studio Code e crie um novo arquivo clicando em “File” e “New File”. Salve esse arquivo com o nome bot.py em uma pasta fácil de encontrar.
Agora, copie e cole o seguinte código no seu arquivo:
from telegram import Update
from telegram.ext import Application, CommandHandler, MessageHandler, filters, ContextTypes
# Substitua pelo seu token (aquele que o BotFather enviou)
TOKEN = "SEU_TOKEN_AQUI"
async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
await update.message.reply_text(
"Olá! Eu sou seu primeiro bot! 🤖\n"
"Use /ajuda para ver o que posso fazer."
)
async def ajuda(update: Update, context: ContextTypes.DEFAULT_TYPE):
await update.message.reply_text(
"Aqui estão os comandos disponíveis:\n\n"
"/start - Inicia o bot\n"
"/ajuda - Mostra esta mensagem\n"
"/sobre - Informações sobre o bot\n\n"
"Você também pode me enviar qualquer mensagem e eu vou responder!"
)
async def sobre(update: Update, context: ContextTypes.DEFAULT_TYPE):
await update.message.reply_text(
"🤖 Meu Primeiro Bot\n\n"
"Este bot foi criado como projeto de aprendizado.\n"
"Desenvolvido com Python e muito entusiasmo!"
)
async def responder(update: Update, context: ContextTypes.DEFAULT_TYPE):
texto_recebido = update.message.text
await update.message.reply_text(
f"Você disse: {texto_recebido}\n\n"
"Ainda estou aprendendo, mas em breve serei mais inteligente! 😊"
)
def main():
# Cria a aplicação do bot usando o token
app = Application.builder().token(TOKEN).build()
app.add_handler(CommandHandler("start", start))
app.add_handler(CommandHandler("ajuda", ajuda))
app.add_handler(CommandHandler("sobre", sobre))
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, responder))
print("Bot está rodando! Pressione Ctrl+C para parar.")
app.run_polling()
if __name__ == "__main__":
main()
Antes de continuar, substitua “SEU_TOKEN_AQUI” pelo token que você recebeu do BotFather. Certifique-se de manter as aspas ao redor do token.
Entendendo o código
Pode parecer muita informação de uma vez, mas vamos destrinchar esse código para que você entenda exatamente o que cada parte faz. Compreender o código é fundamental para que você possa modificá-lo e criar suas próprias funcionalidades no futuro.
As primeiras duas linhas são chamadas de imports. Elas trazem as ferramentas da biblioteca python-telegram-bot para nosso programa. É como abrir uma caixa de ferramentas antes de começar um projeto.
A linha do TOKEN é onde guardamos a “senha” do nosso bot. Quando o programa se conecta ao Telegram, ele usa esse token para provar que tem permissão para controlar o bot.
As funções são blocos de código que executam ações específicas. Cada função tem um propósito:
- start(): É executada quando alguém envia o comando /start
- ajuda(): Responde ao comando /ajuda com uma lista de comandos disponíveis
- sobre(): Fornece informações sobre o bot quando alguém envia /sobre
- responder(): É executada quando alguém envia uma mensagem de texto normal (que não é um comando)
A palavra-chave async indica que essa função é assíncrona, o que significa que ela pode esperar por operações demoradas sem travar o programa. A palavra await é usada dentro dessas funções para indicar onde o programa deve esperar.
A função main() é o coração do nosso programa. Ela:
- Cria uma aplicação usando nosso token
- Registra cada comando e sua função correspondente
- Inicia o bot e o mantém rodando
Executando o Bot
Vamos colocar seu bot para funcionar. Salve o arquivo e abra o terminal do VS Code clicando em “Terminal” e “New Terminal” no menu superior.
No terminal, você precisa navegar até a pasta onde salvou o arquivo bot.py. Por exemplo, se você salvou na área de trabalho, digite:
cd Desktop
Se você receber uma mensagem “Diretório não existe” isso pode significar que as pastas estão com o nome em português, então use o comando abaixo.
cd Área\ de\ Trabalho/
Agora, execute o bot digitando:
python bot.py
Se você estiver no Mac ou Linux e o comando acima não funcionar, tente:
python3 bot.py
Se tudo der certo, você verá a mensagem “Bot está rodando! Pressione Ctrl+C para parar.” na tela. Isso significa que seu bot está vivo e esperando por mensagens!
Agora, abra o Telegram e procure pelo username do seu bot (aquele que você criou no BotFather). Inicie uma conversa e envie /start. Se o bot responder, você acabou de criar seu primeiro bot funcional!
Personalizando seu Bot
Agora que seu bot está funcionando, a diversão realmente começa! Você pode personalizá-lo de várias maneiras para torná-lo único e mais útil.
Adicionando novos comandos
Para adicionar um novo comando, você precisa de duas coisas: criar uma função que define o que o comando faz e registrar essa função na função main(). Por exemplo, vamos adicionar um comando /hora que mostra a hora atual:
Primeiro, adicione essa linha no topo do arquivo, junto com os outros imports:
from datetime import datetime
Depois, adicione essa nova função junto com as outras:
async def hora(update: Update, context: ContextTypes.DEFAULT_TYPE):
agora = datetime.now()
hora_formatada = agora.strftime("%H:%M:%S")
await update.message.reply_text(f"🕐 Agora são {hora_formatada}")
Por fim, registre o comando na função main(), adicionando essa linha junto com os outros add_handler:
app.add_handler(CommandHandler("hora", hora))
Mudando as mensagens
Você pode alterar qualquer texto dentro das funções para personalizar as respostas do seu bot. Depois disso, se executarmos o programa novamente e enviarmos a mensagem “/hora” o resultado será como apresentado na imagem abaixo.
Resolvendo problemas comuns
Durante sua jornada, você pode encontrar alguns obstáculos. Aqui estão os problemas mais comuns e como resolvê-los:
- “ModuleNotFoundError: No module named ‘telegram'”: Isso significa que a biblioteca não foi instalada corretamente. Execute pip install python-telegram-bot novamente.
- O bot não responde no Telegram: Verifique se o terminal ainda mostra “Bot está rodando!”. Se o programa tiver parado ou mostrado um erro, leia a mensagem de erro atentamente. Geralmente indica o problema.
- “Invalid token”: Você copiou o token incorretamente. Volte ao BotFather, copie o token novamente e certifique-se de colá-lo dentro das aspas no código.
- Erro de sintaxe (SyntaxError): Você provavelmente esqueceu algum caractere como aspas, parênteses ou dois-pontos. Compare seu código com o exemplo original linha por linha.
Lembre-se: erros são parte normal do aprendizado de programação. Cada programador experiente já enfrentou centenas de erros. O importante é ler as mensagens com calma e tentar entender o que elas estão dizendo.
Próximos passos e ideias para expandir
Você agora tem um bot funcional e o conhecimento básico para expandi-lo. Aqui estão algumas ideias para continuar seu aprendizado:
Você pode adicionar um comando de piadas que envia piadas aleatórias de uma lista predefinida. Para isso, você criaria uma lista de piadas no código e usaria a biblioteca random do Python para escolher uma aleatoriamente.
Outra ideia é criar um bot de lembretes que armazena notas dos usuários. Isso envolveria aprender sobre armazenamento de dados, seja em arquivos simples ou em bancos de dados.
Para usuários mais ambiciosos, é possível integrar seu bot com APIs externas para buscar informações em tempo real, como previsão do tempo, cotações de moedas ou notícias. Cada integração abre um mundo de possibilidades.
Se quiser que seu bot fique online 24 horas por dia, 7 dias por semana, você precisará hospedá-lo em um servidor. Existem opções gratuitas como PythonAnywhere, Replit e Render que são perfeitas para projetos iniciais.
Em conclusão, fizemos um bot simples que responde mensagens pré definidas ao usuário. Mas você pode evoluir esse código para coisas incríveis, como integrá-lo ao nosso script de cálculo de rentabilidade de FIIs, para que o bot te mande uma mensagem sempre que um dividendo cair na conta!”
