Pular para o conteúdo
Hospedagem de bot de Telegram

Hospedagem de bot de Telegram, por polling ou webhook

Rode o seu bot de Telegram o dia todo, do jeito que ele foi escrito: long polling como um processo contínuo ou webhook com endereço HTTPS pronto, sem configurar certificado.

Começar teste grátisComo funciona

14 dias grátis no primeiro workspace, sem cartão.

Os dois modos do Telegram, sem servidor para cuidar

sem pausa por inatividade
24/7
automático para o webhook
HTTPS
no token do BotFather
AES-256
de teste grátis, sem cartão
14 dias

Escolha o modo do seu bot

O Telegram entrega mensagens de dois jeitos. O Hydro tem um tipo de aplicação para cada um.

  • Long polling como worker

    O bot pergunta ao Telegram por mensagens novas o tempo todo. Roda como worker, sem porta pública, e é o jeito mais simples de começar.

  • Webhook como app web

    O Telegram chama o seu endereço a cada mensagem. A app web ganha um subdomínio em acq.lat com HTTPS, ou o seu domínio próprio.

  • Logs ao vivo

    Acompanhe cada comando e erro em tempo real, com filtro por nível.

  • Reinício automático

    Se o processo cair, ele volta com espera crescente. Depois de 5 quedas em 10 minutos, para e mostra o motivo.

  • Um processo por vez no polling

    O Telegram recusa dois getUpdates ao mesmo tempo. Em workers, a versão antiga para antes de a nova subir, sem erro de conflito no deploy.

Bibliotecas que você pode usar

  • Telegraf e grammYNode.js com npm, pnpm, yarn ou bun, iniciado pelo script start do package.json.
  • python-telegram-bot e aiogramPython com requirements.txt, Poetry ou uv. Um main.py na raiz já basta.
  • Token do BotFatherCadastrado como segredo, cifrado e nunca mostrado de volta.
  • Dados e arquivosSQLite e arquivos na pasta do projeto, com backup diário, ou um banco gerenciado.

Como colocar o bot de Telegram no ar

Polling ou webhook, os passos são quase os mesmos.

  1. 01

    Crie a aplicação

    Worker para long polling; web para webhook. Conecte o GitHub ou envie um .zip.

  2. 02

    Cadastre o token

    Adicione o token do BotFather como variável, por exemplo TELEGRAM_BOT_TOKEN.

  3. 03

    Faça o deploy

    No webhook, registre o endereço da app no Telegram (setWebhook). No polling, é só acompanhar os logs.

Prefere com código? Veja o guia passo a passo do bot de Telegram

Perguntas sobre hospedagem de bot de Telegram

Long polling ou webhook: qual escolher?
Long polling é o mais simples e roda como worker, sem endereço. Webhook responde mais rápido em bots muito usados e roda como app web, com HTTPS automático. Os dois funcionam no Hydro.
Preciso de certificado SSL para o webhook?
Não. Toda app web ganha um endereço em acq.lat com HTTPS automático, e você pode ligar um domínio próprio, também com certificado automático.
Por que aparece “Conflict: terminated by other getUpdates request”?
É quando duas cópias do bot fazem polling ao mesmo tempo. No Hydro, workers rodam uma cópia por vez, inclusive durante o deploy. Se o erro aparecer, confira se o bot não está rodando também no seu computador.
Funciona com python-telegram-bot e Telegraf?
Sim. Python e Node.js são detectados no build, assim como Go, Java, Rust e outras linguagens, ou a sua imagem Docker pública.
O bot fica online com o meu computador desligado?
Sim. O bot roda num servidor da AcquaCloud, 24 horas por dia, sem pausa por inatividade.
Dá para testar de graça?
Sim. O primeiro workspace tem 14 dias de teste grátis, sem cartão. Depois, os planos são mensais, pagos por Pix, boleto ou cartão.

Coloque o seu bot de Telegram no ar hoje

Polling ou webhook, com token protegido e reinício automático.

Começar teste grátisVer planos
  • Dois modosWorker para polling, web para webhook.
  • HTTPS prontoEndereço com certificado automático.
  • Uma cópia por vezSem conflito de getUpdates no deploy.