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
- Telegram
- Python
- Node.js
- TypeScript
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
Crie o bot no BotFather
Guarde o token: ele vai numa variável de ambiente, não no código.
- 2
Escolha polling ou webhook
Polling: “Bot ou tarefa”. Webhook: “Site ou API”, com porta e subdomínio.
- 3
Envie o código
Um .zip ou o repositório do GitHub, com requirements.txt ou package.json.
- 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| Plano | Memória | vCPU | Cabem | Por mês |
|---|---|---|---|---|
| Starter | 1 GB | 1 | 4 projetos de 256 MB | R$ 7,99 |
| Hobby | 2 GB | 2 | 8 projetos de 256 MB | R$ 12,99 |
| Standard | 4 GB | 4 | 16 projetos de 256 MB | R$ 19,90 |
| Pro | 6 GB | 6 | 24 projetos de 256 MB | R$ 34,90 |
Precisa de mais? O plano Empresarial começa em 16 GB e custa R$ 6,00 por GB.
Perguntas frequentes
Documentação
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.