Hospedagem de bot Telegram, por polling ou webhook

O Telegram aceita dois jeitos de entregar mensagens ao bot, e a Campos Cloud roda os dois: como tarefa, perguntando por novidades, ou como site, recebendo cada mensagem num endereço HTTPS.

A partir de R$ 7,99 por mês

  • TelegramTelegram
  • PythonPython
  • Node.jsNode.js
  • TypeScriptTypeScript
main.pyUm exemplo que roda
import os
from telegram import Update
from telegram.ext import Application, CommandHandler, ContextTypes


async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("Olá! Estou online.")


app = Application.builder().token(os.environ["TELEGRAM_TOKEN"]).build()
app.add_handler(CommandHandler("start", start))
app.run_polling()

Como funciona

No long polling, o bot pergunta ao Telegram se há mensagens novas. Ele não precisa de endereço, então roda como “Bot ou tarefa”. É o jeito mais simples de começar.

No webhook, o Telegram envia cada mensagem para uma URL HTTPS sua. A aplicação roda como “Site ou API” e ganha o endereço seunome.camposcloud.app, que você registra no Telegram com setWebhook.

Os dois funcionam com python-telegram-bot, aiogram, grammY ou Telegraf. O token do BotFather fica numa variável de ambiente.

Configuração na Campos Cloud

Tipo
Bot ou tarefa (polling) ou Site ou API (webhook)
Ambiente
Python, Node.js ou Bun
Endereço
https://seunome.camposcloud.app (no webhook)
Porta
A do seu servidor, quando usar webhook
Memória sugerida
256 MB para começar

O que você ganha

Polling sem endereço

Rode o bot como tarefa, sem porta nem domínio, e veja cada atualização no console.

Webhook com HTTPS

O endereço .camposcloud.app já sai com HTTPS, que é o que o Telegram exige para webhooks.

Token fora do código

Guarde o token do BotFather numa variável e troque quando precisar, sem mexer no repositório.

Deploy a cada push

Conecte o repositório e cada push na branch principal publica uma nova versão.

Para começar

  1. 1

    Crie o bot no BotFather

    Guarde o token: ele vai numa variável de ambiente, não no código.

  2. 2

    Escolha polling ou webhook

    Polling: “Bot ou tarefa”. Webhook: “Site ou API”, com porta e subdomínio.

  3. 3

    Envie o código

    Um .zip ou o repositório do GitHub, com requirements.txt ou package.json.

  4. 4

    Teste com /start

    O console ao vivo mostra o bot iniciando e cada mensagem que chega.

Planos e preços

Preço do pagamento mensal, lido dos planos atuais. Também dá para pagar por semestre ou por ano.

Comparar todos os planos
PlanoMemóriavCPUCabemPor mês
Starter1 GB14 projetos de 256 MBR$ 7,99
Hobby2 GB28 projetos de 256 MBR$ 12,99
Standard4 GB416 projetos de 256 MBR$ 19,90
Pro6 GB624 projetos de 256 MBR$ 34,90

Precisa de mais? O plano Empresarial começa em 16 GB e custa R$ 6,00 por GB.

Polling ou webhook: qual escolher?

Polling é mais simples e não precisa de endereço. Webhook evita perguntas constantes ao Telegram e combina com bots que também servem uma página ou API. Os dois rodam na Campos Cloud.

Qual URL registro no setWebhook?

O endereço da aplicação, https://seunome.camposcloud.app, seguido do caminho que o seu código trata. O servidor precisa escutar na porta configurada na aplicação.

Posso rodar polling e webhook ao mesmo tempo?

Não: é uma regra do Telegram. Com um webhook registrado, o getUpdates para de funcionar. Para voltar ao polling, apague o webhook com deleteWebhook.

O bot para quando eu fecho o painel?

Não. Ele roda no servidor até você desligar, o código encerrar ou o plano vencer.

Outros tipos de projeto

Coloque o seu projeto no ar hoje

Escolha um plano, envie o código ou conecte o GitHub e acompanhe tudo pelo console ao vivo.