Server Test Telegram: Cara Test Bot di Lingkungan Test Telegram
Server test Telegram adalah lingkungan test terpisah dengan akun dan bot sendiri, tempat bot kamu memanggil Bot API di https://api.telegram.org/bot<token>/test/METHOD_NAME. Gunakan server ini kalau kamu butuh link HTTP biasa untuk Mini Apps atau Web Login, sekumpulan user test sekali pakai, atau fitur Bot API yang untuk sementara hanya aktif di sana. Untuk test bot Telegram sehari-hari, bot kedua di produksi sering kali sudah cukup. Panduan ini membahas kedua opsi, cara login ke lingkungan test di iOS, Desktop, dan macOS, serta cara memanggil API test dari curl, Python, JavaScript, dan Bot API Tester kami.
Opsi 1: bot test terpisah di produksi
Cara tercepat untuk menguji bot Telegram tanpa mengganggu user-nya adalah menjalankan instance kedua dari kode kamu dengan akun bot lain:
- Buat bot baru dengan
/newbotdi @BotFather (lihat cara membuat bot Telegram). - Masukkan tokennya ke konfigurasi instance test, misalnya file
.envtersendiri. - Debug sendiri dengan bot baru itu; bot produksi tetap berjalan seperti biasa.
Satu hal yang perlu diingat: file_id terikat ke satu ID bot. Bot test tidak bisa memakai ulang nilai file_id yang disimpan bot utama, jadi media harus diunggah ulang oleh bot test.
Opsi 2: lingkungan test khusus Telegram
Telegram juga menyediakan lingkungan test khusus untuk pengujian yang lebih lanjut. Lingkungan ini sepenuhnya terpisah dari lingkungan utama (produksi): akun, bot, chat, dan token produksi tidak ada di sana. Ini perbedaannya:
| Produksi | Server test | |
|---|---|---|
| Akun user | Akun Telegram biasa milikmu | Akun baru yang dibuat di lingkungan test |
| Bot dan token | Dibuat lewat @BotFather di produksi | Dibuat lewat @BotFather di akun test; token terpisah |
| URL Bot API | /bot<token>/METHOD_NAME | /bot<token>/test/METHOD_NAME |
| Link Mini App dan Web Login | Hanya HTTPS | HTTP tanpa TLS diperbolehkan |
| Flood limit | Limit standar | Tidak dinaikkan, kadang lebih ketat |
| Widget (Bot API 10.4) | Hanya di chat pribadi dengan bot | Juga di grup, inline mode, dan pesan terusan |
Membuat akun test di iOS, Desktop, atau macOS
Login ke lingkungan test Telegram dari aplikasi resmi:
- iOS: ketuk ikon Settings 10 kali → Accounts → Login to another account → Test.
- Telegram Desktop: buka ☰ Settings, tahan Shift+Alt lalu klik kanan "Add Account", kemudian pilih "Test Server".
- macOS: klik ikon Settings 10 kali untuk membuka Debug Menu, lalu ⌘+klik "Add Account" dan login dengan nomor telepon.
Akun test ditambahkan di samping akun biasa, jadi kamu bisa berpindah lingkungan di aplikasi yang sama. Semua yang kamu lakukan di sana, termasuk chat dengan bot test, tetap berada di lingkungan test.
Membuat bot di server test dan mendapatkan tokennya
Di akun test, buka @BotFather dan buat bot seperti biasa: /newbot, nama tampilan, lalu username yang diakhiri bot. BotFather membalas dengan token untuk lingkungan test. Bentuknya sama seperti token lain, tetapi hanya bisa dipakai dengan URL API /test/. Simpan dengan nama terpisah, misalnya TEST_BOT_TOKEN, supaya tidak tertukar dengan token produksi; aturan di panduan token bot juga berlaku di sini.
Memanggil Bot API di server test Telegram
Semua method Bot API bekerja dengan cara yang sama; bedanya hanya /test/ setelah token. Cek token dengan getMe:
curl "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/test/getMe"
Di kode, simpan base URL di satu konstanta supaya pindah lingkungan cukup dengan mengubah satu baris. Echo bot sederhana ini mengecek token, lalu menerima update lewat long polling getUpdates dan menunggu saat dapat 429 sesuai nilai retry_after:
import os
import time
import requests
TOKEN = os.environ["TEST_BOT_TOKEN"]
API = f"https://api.telegram.org/bot{TOKEN}/test" # hapus "/test" untuk produksi
def call(method, **params):
while True:
data = requests.post(f"{API}/{method}", json=params, timeout=40).json()
if data["ok"]:
return data["result"]
if data.get("error_code") == 429: # flood limit: tunggu sesuai instruksi
time.sleep(data["parameters"]["retry_after"])
continue
raise RuntimeError(f"{method}: {data['error_code']} {data['description']}")
me = call("getMe")
print("Berjalan di server test sebagai @" + me["username"])
offset = 0
while True:
for update in call("getUpdates", offset=offset, timeout=30):
offset = update["update_id"] + 1
msg = update.get("message")
if msg and "text" in msg:
call("sendMessage", chat_id=msg["chat"]["id"], text="Echo test: " + msg["text"])const TOKEN = process.env.TEST_BOT_TOKEN;
const API = `https://api.telegram.org/bot${TOKEN}/test`; // hapus "/test" untuk produksi
async function call(method, params = {}) {
while (true) {
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) return data.result;
if (data.error_code === 429) { // flood limit: tunggu sesuai instruksi
await new Promise((resolve) => setTimeout(resolve, data.parameters.retry_after * 1000));
continue;
}
throw new Error(`${method}: ${data.error_code} ${data.description}`);
}
}
const me = await call("getMe");
console.log("Berjalan di server test sebagai @" + me.username);
let offset = 0;
while (true) {
for (const update of await call("getUpdates", { offset, timeout: 30 })) {
offset = update.update_id + 1;
const msg = update.message;
if (msg?.text) {
await call("sendMessage", { chat_id: msg.chat.id, text: "Echo test: " + msg.text });
}
}
}Kirim /start ke bot dari akun test kamu, dan bot akan membalas. Versi JavaScript memakai top-level await, jadi simpan sebagai bot.mjs dan jalankan dengan Node.js 18 atau lebih baru.
Webhook bekerja dengan cara yang sama: panggil setWebhook lewat URL test, dan aturan biasa untuk url, port, serta secret_token tetap berlaku (lihat panduan webhook Telegram bot). Cek hasilnya dengan getWebhookInfo, juga lewat /test/:
curl "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/test/setWebhook" \
-d "url=https://example.com/telegram/webhook"
curl "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/test/getWebhookInfo"
Library bot biasanya menyusun URL request dari sebuah base address. Kalau library kamu mengizinkan base URL Bot API diganti, atur supaya request berakhir di …/bot<token>/test/METHOD_NAME; nama opsinya berbeda-beda di tiap library, jadi cek dokumentasi library yang kamu pakai.
Mencoba server test di Bot API Tester
Bot API Tester kami bisa mengirim request ke lingkungan test tanpa menulis kode:
- Buka getMe di Bot API Tester.
- Tekan tombol TEST di samping kolom token, atau buka halaman tester dengan
?env=testdi alamatnya. - Tempel token bot test kamu lalu tekan Execute. Sekarang request dikirim ke
https://api.telegram.org/bot<token>/test/METHOD.
Selama tombol itu aktif, semua method memakai URL test, termasuk long polling getUpdates, jadi kamu bisa melihat update dari akun test masuk ke riwayat update. Tester mengingat posisi tombol di browser; matikan dulu sebelum menempel token produksi. Seperti biasa, token hanya disimpan di localStorage browser kamu dan request langsung dikirim ke api.telegram.org.
Mini Apps dan Web Login lewat HTTP biasa
Alasan utama developer Mini App memakai lingkungan test: di sana, url pada WebAppInfo (Mini Apps) dan LoginUrl (tombol Web Login) boleh berupa link HTTP tanpa TLS. Dengan begitu, menu button atau tombol web_app milik bot test bisa langsung diarahkan ke dev server di jaringan lokal tanpa mengurus sertifikat atau tunnel. Di produksi link wajib HTTPS. Sebelum membuka halaman di dalam Telegram, kamu bisa mengecek pemanggilan Telegram.WebApp di browser biasa dengan Mini App Tester dalam mode mock.
Widget Bot API 10.4 di server test
Widget HTML di dalam pesan, yang ditambahkan di Bot API 10.4, saat ini di produksi hanya berfungsi di chat pribadi dengan bot. Widget di grup, inline mode, dan pesan terusan untuk sementara hanya berjalan di server test, jadi skenario itu bisa dicoba di sana. Cara kerja widget dijelaskan di panduan widget Telegram.
Limit dan praktik yang baik
- Jangan load test di sana. Flood limit tidak dinaikkan di lingkungan test dan kadang malah lebih ketat. Tangani
429denganretry_afterdan jangan bergantung pada nilai limit yang di-hardcode. - Pisahkan lingkungan di konfigurasi. Pakai variabel terpisah untuk token dan base URL, dan catat di log lingkungan mana yang dipakai saat bot dijalankan.
- Uji ulang di produksi. Sebelum rilis, jalankan skenario yang sama dengan bot test di produksi lewat HTTPS, karena link HTTP dan fitur khusus server test tidak akan berfungsi untuk user asli.
Mengatasi masalah
| Gejala | Kemungkinan penyebab | Solusi |
|---|---|---|
401 Unauthorized | Token produksi dikirim ke /test/, atau token test dikirim tanpa /test/ | Lingkungannya terpisah: cocokkan token dengan URL (atau tombol TEST di tester) |
400 Bad Request: chat not found | Chat id berasal dari produksi; user dan chat tersebut tidak ada di server test | Kirim pesan ke bot test dari akun test, lalu ambil chat id dari getUpdates (lihat panduan chat id Telegram) |
| Bot tidak ditemukan di pencarian | Mencari dari akun produksi | Cari dari akun test, tempat bot itu dibuat |
429 Too Many Requests | Flood limit, yang tidak dinaikkan di server test | Tunggu retry_after detik dan kurangi kecepatan request |
| Mini App lewat HTTP tidak terbuka | Bot atau akunnya ada di produksi | Pakai bot yang dibuat di lingkungan test dan buka dari akun test |
Pertanyaan umum
Apa itu server test Telegram?
Lingkungan test khusus yang sepenuhnya terpisah dari Telegram produksi. Di sana ada akun user dan bot tersendiri, dan bot memanggil Bot API di https://api.telegram.org/bot<token>/test/METHOD_NAME.
Bagaimana cara login ke lingkungan test Telegram?
Di iOS, ketuk ikon Settings 10 kali → Accounts → Login to another account → Test. Di Telegram Desktop, buka ☰ Settings, tahan Shift + Alt lalu klik kanan Add Account → Test Server. Di macOS, klik ikon Settings 10 kali untuk membuka Debug Menu, lalu ⌘ + klik Add Account.
Apakah token bot produksi bisa dipakai di server test?
Tidak. Kedua lingkungan terpisah, jadi bot yang dibuat di produksi tidak ada di server test, begitu juga sebaliknya. Buat bot baru lewat @BotFather di akun test kamu; token yang salah lingkungan biasanya berujung 401 Unauthorized.
Apakah limit request lebih longgar di server test Telegram?
Tidak. Flood limit tidak dinaikkan di lingkungan test dan kadang malah lebih ketat, jadi tangani 429 Too Many Requests dengan retry_after dan jangan hardcode nilai limit.
Apakah Mini App boleh memakai HTTP biasa di lingkungan test?
Boleh. Di lingkungan test, url pada WebAppInfo (Mini Apps) dan LoginUrl (Web Login) boleh berupa link HTTP tanpa TLS. Di produksi link wajib HTTPS.
Apakah untuk test bot Telegram selalu perlu server test?
Tidak. Untuk sebagian besar pekerjaan, bot kedua yang dibuat lewat @BotFather di produksi sudah cukup: tokennya sendiri dan tidak mengganggu user asli. Pakai server test kalau kamu butuh link HTTP, akun test terpisah, atau fitur yang baru tersedia di sana.
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.
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.
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.