Bot em Python na VPS: como deixar o seu rodando
Veja como rodar um bot do Telegram numa VPS: BotFather, token, Python com venv, python-telegram-bot, serviço no systemd, logs com journalctl e webhook.
Por Redação Eleven Host · @robson.direitodigital · 2 de novembro de 2026 · 8 min de leitura

Capa da Redação Eleven Host para o guia: Bot em Python na VPS: como deixar o seu rodando Arte: Eleven Host
Bot em Python na VPS é o caminho para tirar o seu bot do Telegram do computador e deixá-lo rodando como serviço num servidor, que reinicia o programa se ele falhar. O guia usa Python, a biblioteca python-telegram-bot, um ambiente virtual e o systemd.
Você vê como criar o bot, guardar o token, escolher entre long polling e webhook, rodar o exemplo oficial e ler os logs. Se você ainda não conhece o servidor VPS, comece por O que é servidor VPS: guia simples para iniciantes. Os exemplos usam meubot como nome fictício.
Criar o bot no BotFather
A página de recursos de bots do Telegram manda usar o comando /newbot no BotFather para criar um bot novo. Você informa o nome e o username e recebe o token.
O username tem de ter de 5 a 32 caracteres, só com letras latinas, números e sublinhado, e precisa terminar em "bot", como tetris_bot ou TetrisBot. Diferente do nome, o username não pode ser mudado depois, então escolha com calma.
O token funciona como senha
O token tem o formato 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw, e esse é o exemplo da documentação, não um token de verdade. O Telegram avisa que ele pode ser usado por quem o tiver para controlar o bot, e o tutorial pede para tratá-lo como uma senha e não compartilhá-lo.
Não escreva o token dentro do código nem o envie para um repositório. Se ele vazar ou se perder, use o comando /token no BotFather para gerar um novo. O tutorial também diz que o token pode ser revogado pelo BotFather.
Long polling ou webhook
A Bot API tem duas formas de receber as mensagens, e elas são mutuamente exclusivas: o getUpdates (long polling) e o webhook. O método getUpdates não funciona se um webhook estiver configurado. As atualizações ficam guardadas no servidor do Telegram até o bot buscá-las, por no máximo 24 horas.
Nos passos abaixo, o bot usa long polling. Ele pergunta ao Telegram pelas novidades, então não precisa de porta aberta nem de HTTPS. O webhook faz o contrário: o Telegram envia as atualizações por POST para uma URL HTTPS sua, e você vê esse caminho mais abaixo.
Python, ambiente virtual e a biblioteca
Na versão 22.8, de 12 de junho, segundo a página de releases e o changelog do projeto, a biblioteca python-telegram-bot aparece marcada como "Latest" no GitHub. O README diz que ela é compatível com Python 3.11 ou superior, então confira a versão do Python da VPS antes de começar:
python3 --version
A biblioteca é licenciada sob a LGPLv3, e os tipos e métodos da Bot API 10.0 têm suporte nativo. A Bot API já está na 10.3, de 24 de agosto de 2026, e recursos novos podem não ter suporte na biblioteca ainda.
Crie uma pasta para o bot, um ambiente virtual dentro dela e instale a biblioteca. Em algumas distros pode ser preciso instalar antes o pacote do venv. Os caminhos abaixo são exemplos:
python3 -m venv /opt/meubot/venv
source /opt/meubot/venv/bin/activate
pip install python-telegram-bot --upgrade
A documentação do Python diz que você não precisa ativar o ambiente virtual: dá para chamar o Python do ambiente pelo caminho completo. É o que o systemd vai fazer mais adiante. Se um dia usar o webhook embutido da biblioteca, instale com pip install "python-telegram-bot[webhooks]".
Está avaliando onde o seu projeto vai ficar? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS
O código: o exemplo echobot oficial
O repositório da biblioteca traz o examples/echobot.py, que o cabeçalho do arquivo libera como CC0. Ele responde ao /start e repete as mensagens de texto. Abaixo está o trecho essencial, salvo como /opt/meubot/bot.py, com uma mudança: o token vem da variável de ambiente BOT_TOKEN, em vez de ficar no código.
import os
from telegram import ForceReply, Update
from telegram.ext import Application, CommandHandler, ContextTypes, MessageHandler, filters
async def start(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
user = update.effective_user
await update.message.reply_html(
rf"Hi {user.mention_html()}!",
reply_markup=ForceReply(selective=True),
)
async def echo(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
await update.message.reply_text(update.message.text)
def main() -> None:
application = Application.builder().token(os.environ["BOT_TOKEN"]).build()
application.add_handler(CommandHandler("start", start))
application.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, echo))
application.run_polling(allowed_updates=Update.ALL_TYPES)
if __name__ == "__main__":
main()
O run_polling é o long polling: o programa roda até alguém interrompê-lo. Para testar na mão, com o ambiente ativado, defina a variável só nesse terminal, rode o arquivo e mande /start ao bot pelo Telegram. Interrompa com Ctrl-C.
export BOT_TOKEN=cole_o_token_aqui
python /opt/meubot/bot.py
Rodar como serviço com systemd
Para o bot continuar rodando depois que você fechar o terminal, crie uma unit do systemd. O arquivo abaixo é um exemplo, e os nomes e caminhos são fictícios. Salve em /etc/systemd/system/meubot.service:
[Unit]
Description=Bot do Telegram (meubot)
Wants=network-online.target
After=network-online.target
[Service]
Type=simple
User=meubot
WorkingDirectory=/opt/meubot
EnvironmentFile=/etc/meubot.env
ExecStart=/opt/meubot/venv/bin/python /opt/meubot/bot.py
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
User=define o usuário que executa o processo, eWorkingDirectory=define a pasta de trabalho. O usuário informado precisa existir no servidor e conseguir ler os arquivos de/opt/meubot.ExecStart=aponta para o Python do ambiente virtual pelo caminho completo.Restart=on-failureé a escolha que a man page indica para serviços de longa duração. ORestartSec=5é uma escolha do exemplo, já que o padrão é 100 milissegundos.Wants=eAfter=comnetwork-online.targetfazem o serviço esperar a rede.WantedBy=multi-user.targetliga o serviço quando você rodasystemctl enable.
O EnvironmentFile= lê as variáveis de um arquivo de texto, com uma linha NOME=valor por linha. Crie o /etc/meubot.env com a linha do token e restrinja a permissão, por exemplo com chmod 600, com o root como dono:
BOT_TOKEN=cole_o_token_aqui
sudo chmod 600 /etc/meubot.env
A man page do systemd lembra que variáveis de ambiente não são adequadas para passar segredos e cita o LoadCredential= como alternativa mais segura. O arquivo com permissão restrita é o caminho simples deste exemplo.
Depois, recarregue o systemd, ative e inicie o serviço, e confira o estado:
sudo systemctl daemon-reload
sudo systemctl enable --now meubot
systemctl status meubot
Ver os logs com journalctl
A saída do bot vai para o journal do systemd, e o journalctl mostra o que o serviço escreveu:
journalctl -u meubot -f
journalctl -u meubot -n 100 --since today
A opção -u filtra pela unit, e -f acompanha as novas linhas conforme chegam. A -n 100 limita às 100 entradas mais recentes, e a --since today começa a mostrar a partir de hoje. Se o bot não responde, comece lendo esses logs. Para conferir se alguma porta ficou aberta no servidor, veja Portas abertas no Linux: como ver com ss e lsof na VPS.
Quando usar o webhook
No webhook, o Telegram envia as atualizações por POST para uma URL HTTPS que você informa pelo setWebhook. As portas aceitas são 443, 80, 88 e 8443. Um cabeçalho opcional, o X-Telegram-Bot-Api-Secret-Token, ajuda a conferir a origem. Para usar um certificado autoassinado, é preciso enviar a chave pública como arquivo (InputFile), porque enviar um texto não funciona.
Lembre que polling e webhook não funcionam juntos. Se um webhook já estiver configurado, o run_polling não recebe nada até ele ser removido. Para um bot pequeno, o long polling pode ser uma escolha prática, porque dispensa porta e certificado. Se escolher o webhook, que pede HTTPS, o guia Nginx Proxy Manager: vários sites numa VPS só mostra como colocar um proxy na frente.
Seja qual for o caminho, respeite os limites de envio do Telegram: em um chat, evite mandar mais de uma mensagem por segundo. Em um grupo, os bots não conseguem enviar mais de 20 mensagens por minuto. Para notificações em massa, o limite é de cerca de 30 mensagens por segundo.
Checklist do bot do Telegram na VPS
- Python 3.11 ou superior conferido com
python3 --version. - Ambiente virtual criado e a biblioteca instalada nele.
- Token lido de variável de ambiente, fora do código.
/etc/meubot.envcom permissão restrita.- Unit com
Restart=on-failureeExecStartapontando para o Python do venv. systemctl enable --nowexecutado, esystemctl statussem erro.- Logs conferidos com
journalctl -u. - Sem webhook configurado, se o bot usa polling.
Já sabe qual servidor vai usar? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer os planos
Perguntas frequentes
Como criar um bot do Telegram?
Use o comando /newbot no BotFather, informe o nome e o username e guarde o token que ele devolve.
O que fazer se o token vazar?
Use o comando /token no BotFather para gerar um novo. O tutorial do Telegram também diz que o token pode ser revogado pelo BotFather.
Qual a diferença entre long polling e webhook?
No long polling o bot busca as atualizações e não precisa de porta aberta. No webhook, o Telegram envia por POST para uma URL HTTPS, nas portas 443, 80, 88 ou 8443. Os dois não funcionam ao mesmo tempo.
Qual versão do Python o python-telegram-bot exige?
O README diz que a biblioteca é compatível com Python 3.11 ou superior. A versão 22.8, de 12 de junho, é a marcada como "Latest" no GitHub.
Como ver os logs do bot no systemd?
Use journalctl -u meubot -f, trocando meubot pelo nome da sua unit.