Cara Deploy Bot Telegram: Hosting di VPS, Docker, dan Serverless
Untuk deploy bot Telegram, jalankan kodenya di mesin yang selalu menyala dan bisa menjangkau api.telegram.org, lalu pilih cara menerima update: long polling dengan getUpdates, yang jalan di server mana pun tanpa domain, atau webhook, yang butuh URL HTTPS publik. VPS kecil dengan systemd atau container Docker adalah pilihan umum untuk bot polling; platform serverless seperti Cloudflare Workers cocok untuk bot webhook. Panduan ini membahas setiap opsi dengan konfigurasi siap salin, plus logging, restart, dan checklist sebelum bot online.
Polling atau webhook di server
Telegram menyediakan dua cara menerima update yang tidak bisa dipakai bersamaan, dan apa pun pilihannya, update yang belum terkirim disimpan Telegram maksimal 24 jam. Pilihan ini menentukan kebutuhan hosting bot Telegram kamu:
Long polling (getUpdates) | Webhook (setWebhook) | |
|---|---|---|
| Jaringan | Hanya HTTPS keluar; jalan di balik NAT | URL HTTPS publik, port 443, 80, 88, atau 8443, IPv4 |
| Proses | Loop yang berjalan terus | Handler HTTP; bisa serverless |
| Instance | Tepat satu per token | Beberapa di balik satu URL tidak masalah |
| Hosting yang cocok | VPS, Docker, server rumahan | VPS dengan reverse proxy, Cloudflare Workers, AWS Lambda, Vercel |
Jika polling sudah jalan di komputermu, pertahankan saja: panduan webhook resmi Telegram sendiri menyebut tidak ada yang salah dengan memakai getUpdates. Pindah ke webhook jika platformmu mewajibkannya atau jika ingin beberapa instance berbagi beban.
Bot polling yang siap di-deploy
Kode yang siap produksi punya tiga ciri: membaca token dari environment variable, menulis log ke stdout, dan tetap hidup saat ada error jaringan alih-alih crash. Bot echo ini memenuhi ketiganya dan memanggil deleteWebhook saat start, karena getUpdates tidak berfungsi selama webhook terpasang:
import logging
import os
import time
import requests
logging.basicConfig(level=logging.INFO, format="%(asctime)s %(levelname)s %(message)s")
log = logging.getLogger("bot")
TOKEN = os.environ["BOT_TOKEN"] # jangan pernah hardcode token
API = f"https://api.telegram.org/bot{TOKEN}"
def call(method, **params):
data = requests.post(f"{API}/{method}", json=params, timeout=40).json()
if not data["ok"]:
raise RuntimeError(f"{method}: {data['error_code']} {data['description']}")
return data["result"]
def main():
call("deleteWebhook") # polling dan webhook tidak bisa dipakai bersamaan
log.info("started as @%s", call("getMe")["username"])
offset = 0
while True:
try:
updates = call("getUpdates", offset=offset, timeout=30)
except Exception:
log.exception("getUpdates failed, retrying in 5 s")
time.sleep(5)
continue
for update in updates:
offset = update["update_id"] + 1
msg = update.get("message")
if msg and "text" in msg:
try:
call("sendMessage", chat_id=msg["chat"]["id"], text="Echo: " + msg["text"])
except Exception:
log.exception("update %s failed", update["update_id"])
if __name__ == "__main__":
main()const TOKEN = process.env.BOT_TOKEN; // jangan pernah hardcode token
if (!TOKEN) throw new Error("BOT_TOKEN is not set");
const API = `https://api.telegram.org/bot${TOKEN}`;
const log = (...args) => console.log(new Date().toISOString(), ...args);
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
async function call(method, params = {}) {
const res = await fetch(`${API}/${method}`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(params),
signal: AbortSignal.timeout(40_000),
});
const data = await res.json();
if (!data.ok) throw new Error(`${method}: ${data.error_code} ${data.description}`);
return data.result;
}
await call("deleteWebhook"); // polling dan webhook tidak bisa dipakai bersamaan
log("started as @" + (await call("getMe")).username);
let offset = 0;
while (true) {
let updates;
try {
updates = await call("getUpdates", { offset, timeout: 30 });
} catch (err) {
log("getUpdates failed, retrying in 5 s:", err.message);
await sleep(5000);
continue;
}
for (const update of updates) {
offset = update.update_id + 1;
const msg = update.message;
if (!msg?.text) continue;
try {
await call("sendMessage", { chat_id: msg.chat.id, text: "Echo: " + msg.text });
} catch (err) {
log(`update ${update.update_id} failed:`, err.message);
}
}
}Simpan sebagai bot.py (dengan requests di requirements.txt) atau bot.mjs (Node.js 18+, tanpa dependency). Framework dari daftar library sudah mengurus loop-nya, tetapi langkah deploy di bawah tetap sama.
Bot Telegram di VPS dengan systemd
VPS memberimu mesin Linux biasa. Biarkan systemd menjalankan bot saat boot dan me-restart-nya saat crash:
- Buat user tanpa hak login dan salin kode ke
/opt/mybot; untuk Python, buat virtual environment di sana dan install requirements. - Simpan token di
/etc/mybot.envsebagai barisBOT_TOKEN=123456789:AAEexampleTokenReplaceWithYoursdan batasi aksesnya denganchmod 600. - Buat file unit
/etc/systemd/system/mybot.service:
[Unit]
Description=Telegram bot
After=network-online.target
Wants=network-online.target
[Service]
User=mybot
WorkingDirectory=/opt/mybot
EnvironmentFile=/etc/mybot.env
ExecStart=/opt/mybot/.venv/bin/python -u bot.py
# Node.js: ExecStart=/usr/bin/node bot.mjs
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
Aktifkan service dan pantau log-nya:
sudo systemctl daemon-reload
sudo systemctl enable --now mybot
journalctl -u mybot -f # log langsung
sudo systemctl restart mybot # setelah kode diperbarui
Untuk webhook di VPS yang sama, jalankan bot sebagai server HTTP di port lokal dan pasang nginx atau Caddy di depannya untuk menangani TLS di port 443; panduan webhook telegram bot berisi handler dengan pengecekan secret token.
Deploy bot Telegram dengan Docker
Container membungkus runtime dan dependency, jadi bot berjalan sama persis di laptop dan di host Docker mana pun. Dockerfile untuk bot Python:
FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY bot.py .
CMD ["python", "-u", "bot.py"]
# Node.js: FROM node:22-slim, COPY bot.mjs ., CMD ["node", "bot.mjs"]
Build dan jalankan dengan token yang diberikan saat runtime, jangan dimasukkan ke image:
docker build -t mybot .
docker run -d --name mybot --restart unless-stopped --env-file .env mybot
docker logs -f mybot
--restart unless-stopped menghidupkan bot kembali setelah crash dan reboot host. Jauhkan .env dari Git dan dari image (tambahkan ke .dockerignore). Saat redeploy bot polling, hentikan container lama sebelum menjalankan yang baru: dua container yang polling dengan token yang sama membuat getUpdates gagal dengan 409 Conflict.
Serverless: bot Telegram di Cloudflare Workers
Platform serverless hanya menjalankan kode saat ada request masuk, jadi butuh mode webhook. Di Cloudflare Workers, alamat default workers.dev sudah melayani HTTPS di port 443. Worker ini mengecek header secret token, langsung membalas, lalu menyelesaikan pekerjaan di background dengan ctx.waitUntil:
// worker.js: deploy dengan "npx wrangler deploy"
export default {
async fetch(request, env, ctx) {
const url = new URL(request.url);
if (request.method !== "POST" || url.pathname !== "/telegram/webhook") {
return new Response("Not found", { status: 404 });
}
const enc = new TextEncoder();
const received = enc.encode(request.headers.get("X-Telegram-Bot-Api-Secret-Token") ?? "");
const expected = enc.encode(env.WEBHOOK_SECRET);
if (received.byteLength !== expected.byteLength ||
!crypto.subtle.timingSafeEqual(received, expected)) {
return new Response("Forbidden", { status: 403 });
}
const update = await request.json();
ctx.waitUntil(handleUpdate(update, env)); // balas 200 sekarang, lanjutkan proses
return new Response("OK");
},
};
async function handleUpdate(update, env) {
const msg = update.message;
if (!msg?.text) return;
const res = await fetch(`https://api.telegram.org/bot${env.BOT_TOKEN}/sendMessage`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ chat_id: msg.chat.id, text: "Echo: " + msg.text }),
});
if (!res.ok) console.error("sendMessage failed", res.status, await res.text());
}
Simpan kedua nilai sebagai Worker secret, deploy, lalu daftarkan URL Worker dengan secret yang sama:
npx wrangler secret put BOT_TOKEN
npx wrangler secret put WEBHOOK_SECRET
npx wrangler deploy
curl -X POST "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/setWebhook" \
-H "Content-Type: application/json" \
-d '{"url": "https://mybot.example.workers.dev/telegram/webhook", "secret_token": "replace-with-your-random-secret"}'
Atau isi setWebhook di Bot API Tester. Pola yang sama berlaku di AWS Lambda (di balik function URL HTTPS atau API gateway) dan Vercel functions: parsing body JSON, verifikasi header, balas 2XX dengan cepat. Platform membatasi berapa lama function dan pekerjaan background-nya boleh berjalan, jadi pindahkan tugas lambat ke antrean. Telegram mengulang setiap respons non-2XX, sehingga function yang timeout atau crash akan menerima update yang sama lagi.
Opsi hosting bot Telegram gratis dan murah
- Free tier serverless cocok untuk bot webhook dengan trafik sedang dan handler yang singkat.
- VPS kecil adalah opsi paling fleksibel: polling atau webhook, bahasa apa pun, database di samping bot.
- Server rumahan atau single-board computer bisa dipakai dengan polling karena tidak perlu koneksi masuk; uptime bergantung pada listrik dan internetmu.
- Platform container yang menjaga proses tetap berjalan bisa meng-host bot polling; pastikan aplikasi yang idle tidak ditidurkan.
Syarat webhook di hosting mana pun
- Hanya HTTPS, TLS 1.2 atau lebih baru, sertifikat yang cocok dengan domain beserta rantai lengkapnya, atau sertifikat self-signed yang diunggah lewat
certificate. - Port 443, 80, 88, atau 8443; IPv4 (IPv6 tidak didukung untuk webhook); tanpa redirect.
- Request datang dari
149.154.160.0/20dan91.108.4.0/22; Telegram mencatat bahwa rentang ini bisa berubah. - Isi
secret_token(1–256 karakterA-Z a-z 0-9 _ -) dan verifikasi headerX-Telegram-Bot-Api-Secret-Token.
Setelah setiap deploy, buka getWebhookInfo di Bot API Tester: pending_update_count yang terus naik atau last_error_message yang baru muncul berarti Telegram tidak bisa mengirim update.
Environment variable, logging, dan restart
- Token: hanya di environment variable atau secret store, jangan di Git, image, atau kode client. Jika bocor, cabut seperti dijelaskan di panduan token bot Telegram lalu perbarui di server.
- Log: tulis ke stdout/stderr dan biarkan journald, Docker, atau platform mengumpulkannya. Jangan mencatat URL request lengkap, karena berisi token.
- Restart: supervisor (
Restart=always,--restart unless-stopped) menangani crash. Telegram menyimpan status konfirmasi update di sisinya: update dianggap terkonfirmasi setelahgetUpdatesdipanggil denganoffsetyang lebih tinggi, jadi setelah restart bot hanya menerima update yang belum terkonfirmasi. Batch terakhir sebelum crash bisa datang dua kali; lakukan deduplikasi berdasarkanupdate_idjika penting. - Rate limit: tangani
429 Too Many Requestsdengan menungguretry_afterdetik; lihat limit Telegram Bot API.
Checklist deploy
- Token diambil dari environment variable atau secret;
getMeberhasil di server. - Tepat satu instance polling per token, atau webhook dengan
secret_token, jangan keduanya. - Proses otomatis restart setelah crash dan reboot.
- Log dikumpulkan dan tidak berisi token.
- Error di satu update dicatat, tidak membuat bot mati; handler webhook membalas 2XX dengan cepat.
- Untuk webhook,
getWebhookInfomenampilkan URL yang benar dan tidak ada error baru. - Eksperimen memakai bot uji terpisah atau server tes Telegram, bukan token produksi.
Troubleshooting masalah deploy
| Gejala | Penyebab dan solusi |
|---|---|
409 Conflict: terminated by other getUpdates request | Dua instance polling dengan satu token (container lama, laptopmu). Hentikan semua kecuali satu. |
409 Conflict yang menyebut webhook aktif | Webhook masih terpasang. Panggil deleteWebhook sebelum polling. |
401 Unauthorized | Variabel token kosong, salah ketik, atau sudah dicabut. Cek dengan getMe. |
| Jalan di lokal, diam di server | HTTPS keluar ke api.telegram.org diblokir, atau file environment tidak dimuat. Cek log. |
| Bot webhook tidak menerima apa-apa | Lihat last_error_message di getWebhookInfo: TLS, port salah, 403 karena secret tidak cocok, atau handler crash. |
Baru mulai membuat bot? Mulai dari cara membuat bot Telegram, lalu kembali ke sini untuk deploy.
Pertanyaan umum
Di mana bisa hosting bot Telegram?
Di mana saja yang bisa membuat request HTTPS keluar: VPS, host Docker, server rumahan, atau platform serverless. Bot dengan getUpdates tidak butuh alamat publik; bot webhook butuh URL HTTPS publik di port 443, 80, 88, atau 8443.
Bot yang sudah di-deploy sebaiknya pakai polling atau webhook?
Keduanya bisa dipakai di produksi. Long polling dengan getUpdates paling sederhana di VPS atau Docker karena tidak perlu domain atau sertifikat. Webhook wajib di platform serverless, yang hanya menjalankan kode saat ada request masuk.
Kenapa muncul 409 Conflict setelah bot di-deploy?
Bisa karena webhook masih terpasang saat bot melakukan polling dengan getUpdates (panggil deleteWebhook), atau dua salinan bot polling bersamaan, misalnya container lama dan baru saat deploy, atau laptop dan server. Jalankan tepat satu instance polling per token.
Bagaimana agar bot Telegram berjalan 24/7?
Jalankan di bawah process supervisor yang me-restart bot setelah crash dan reboot: service systemd dengan Restart=always di VPS, atau container Docker dengan --restart unless-stopped. Tulis log ke stdout dan pantau dengan journalctl atau docker logs.
Apakah bot Telegram bisa dijalankan di Cloudflare Workers?
Bisa, dalam mode webhook. Worker menerima setiap update sebagai request POST, mengecek header X-Telegram-Bot-Api-Secret-Token, lalu memanggil Bot API dengan fetch. Daftarkan alamat HTTPS workers.dev-nya dengan setWebhook. Loop long polling tidak cocok dengan model ini.
Di mana sebaiknya token bot disimpan di server?
Di environment variable yang dimuat dari file yang hanya bisa dibaca user bot, atau di secret store platform (misalnya Worker secret). Jangan pernah commit token ke Git atau memasukkannya ke image Docker. Jika bocor, cabut di @BotFather.
Panduan terkait
Cara Membuat Bot Telegram: dari BotFather sampai Pesan Pertama
Cara membuat bot telegram langkah demi langkah: daftar di @BotFather, simpan token, cek dengan getMe, lalu kirim pesan pertama lewat curl dan Python.
Telegram Bot API 10.0–10.5: Pengaturan Bot, Widget, Rich Message, Ephemeral Message, Guest Mode, dan Lainnya
Fitur baru Telegram Bot API 10.0–10.5: setMySettings dan BotFullInfo, widget HTML, rich message, ephemeral message, guest mode, lengkap dengan contoh JSON.
Error Telegram Bot API: Arti Setiap Error dan Cara Mengatasinya
Daftar error Telegram Bot API: 400 chat not found, 403 bot was blocked by the user, 409 Conflict, 429 retry_after. Penyebab, solusi, dan kode penanganan.
Limit Telegram Bot API: Rate Limit, Error 429, Ukuran File, dan Panjang Pesan
Limit Telegram Bot API: 30 pesan/detik, 1 pesan/detik per chat, 20/menit di grup, cara menangani 429 retry_after, batas ukuran file dan panjang pesan.
Perintah Bot Telegram: setMyCommands, Scope Perintah, dan Deep Link /start
Cara membuat perintah bot Telegram: /setcommands di @BotFather, setMyCommands dengan scope dan bahasa, parameter deep link /start, dan /cmd@bot di grup.
Keyboard Bot Telegram: Inline Keyboard, Tombol Callback, dan Reply Keyboard
Cara membuat tombol bot Telegram: inline keyboard dengan callback_data, answerCallbackQuery, edit pesan setelah tombol ditekan, reply keyboard, ForceReply.
Integrasi n8n Telegram: Hubungkan Bot, Jalankan Workflow, dan Kirim Pesan
Cara menghubungkan n8n ke Telegram: token bot sebagai Access Token, webhook Telegram Trigger via HTTPS publik, kirim pesan via chat id, dan solusi error.
Kirim Pesan Bot Telegram dengan Telegram Bot API (sendMessage)
Kirim pesan bot telegram lewat Bot API: contoh sendMessage dengan curl, Python, dan JavaScript, format HTML/MarkdownV2, tombol inline, dan solusi error.
Telegram Bot Token: Cara Mendapatkan, Mengecek, dan Mencabut Token
Cara mendapatkan token bot telegram dari @BotFather, melihat token bot lama, mengecek dengan getMe, dan me-revoke token yang bocor. Lengkap dengan contoh.
Webhook Telegram Bot: Cara Setting setWebhook, Secret Token, dan Mengatasi Error
Panduan webhook telegram bot: syarat HTTPS dan port, setWebhook dengan secret_token, cek getWebhookInfo, deleteWebhook, serta solusi error 409 dan n8n.
Chat ID Telegram Dimana? Cara Mendapatkan Chat ID User, Grup, dan Channel
Chat id telegram dimana? Cara mendapatkan chat id user, grup, supergroup, dan channel lewat getUpdates, plus solusi saat result kosong atau error 409.
Bot Inline Telegram: Cara Mengaktifkan Mode Inline dan Menjawab Inline Query
Cara membuat bot inline Telegram: aktifkan mode inline lewat @BotFather atau setMySettings, tangani update inline_query, lalu balas via answerInlineQuery.
Pembayaran Telegram Stars untuk Bot: Invoice, Pre-Checkout, Refund, dan Langganan
Cara menerima pembayaran Telegram Stars di bot: sendInvoice dengan XTR, pre_checkout_query, successful_payment, refund, langganan, plus kode Python/JS.
Server Test Telegram: Cara Test Bot di Lingkungan Test Telegram
Cara memakai server test Telegram untuk bot: login ke lingkungan test, buat bot test, panggil Bot API lewat /test/, lalu aktifkan TEST di tester kami.
Widget Telegram untuk Website: Login dengan Telegram, Embed Post, Komentar, dan Tombol Share
Pasang widget telegram untuk website: login dengan Telegram (OIDC), Login Widget lama dengan cek hash, embed post, komentar channel, dan tombol share.
API JavaScript TelegramWidget: Referensi, Event, Kode Error, dan Batasan
Referensi API JavaScript TelegramWidget: properti, request(), event, kode error, variabel CSS, widget_query dan answerWidgetQuery, plus semua batasannya.
Contoh Widget Telegram: Kode HTML dan Bot Python Lengkap
Contoh widget telegram lengkap dengan kode: kartu pesanan statis, counter dengan request widget_query, polling live sebagai widget shared, preview lokal.
Widget Telegram: HTML Interaktif di Dalam Pesan Bot
Widget telegram (Bot API 10.4): apa itu, cara kerja sendWidget, chat_data dan public_data, di mana bisa dipakai saat ini, dan bedanya dengan Mini App.
Cara Tes Telegram Mini App: Dari Mock di Browser sampai Telegram Asli
Cara tes Telegram Mini App: mode mock di browser, localhost lewat tunnel HTTPS, test environment, DevTools per platform, dan validasi initData di server.