Base de Conhecimento

Bot em Python na VPS: como deixar o seu rodando

  • telegram, bot, python, systemd, vps
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Bot em Python na VPS: como deixar o seu rodando

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, e WorkingDirectory= 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. O RestartSec=5 é uma escolha do exemplo, já que o padrão é 100 milissegundos.
  • Wants= e After= com network-online.target fazem o serviço esperar a rede.
  • WantedBy=multi-user.target liga o serviço quando você roda systemctl 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.env com permissão restrita.
  • Unit com Restart=on-failure e ExecStart apontando para o Python do venv.
  • systemctl enable --now executado, e systemctl status sem 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.

Esta resposta lhe foi útil?

Artigos Relacionados