Telegram Bot API

Server Test Telegram: Cara Test Bot di Lingkungan Test Telegram

· 7 menit baca

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:

  1. Buat bot baru dengan /newbot di @BotFather (lihat cara membuat bot Telegram).
  2. Masukkan tokennya ke konfigurasi instance test, misalnya file .env tersendiri.
  3. 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:

ProduksiServer test
Akun userAkun Telegram biasa milikmuAkun baru yang dibuat di lingkungan test
Bot dan tokenDibuat lewat @BotFather di produksiDibuat lewat @BotFather di akun test; token terpisah
URL Bot API/bot<token>/METHOD_NAME/bot<token>/test/METHOD_NAME
Link Mini App dan Web LoginHanya HTTPSHTTP tanpa TLS diperbolehkan
Flood limitLimit standarTidak dinaikkan, kadang lebih ketat
Widget (Bot API 10.4)Hanya di chat pribadi dengan botJuga di grup, inline mode, dan pesan terusan

Membuat akun test di iOS, Desktop, atau macOS

Login ke lingkungan test Telegram dari aplikasi resmi:

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:

  1. Buka getMe di Bot API Tester.
  2. Tekan tombol TEST di samping kolom token, atau buka halaman tester dengan ?env=test di alamatnya.
  3. 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

Mengatasi masalah

GejalaKemungkinan penyebabSolusi
401 UnauthorizedToken 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 foundChat id berasal dari produksi; user dan chat tersebut tidak ada di server testKirim pesan ke bot test dari akun test, lalu ambil chat id dari getUpdates (lihat panduan chat id Telegram)
Bot tidak ditemukan di pencarianMencari dari akun produksiCari dari akun test, tempat bot itu dibuat
429 Too Many RequestsFlood limit, yang tidak dinaikkan di server testTunggu retry_after detik dan kurangi kecepatan request
Mini App lewat HTTP tidak terbukaBot atau akunnya ada di produksiPakai 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.

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.