Cek token bot Telegram dan dapatkan chat ID

Token bot dan chat ID adalah dua nilai yang diminta setiap integrasi Telegram: token menentukan bot mana yang berbicara, chat ID menentukan ke mana. Halaman ini mengecek yang pertama dan menemukan yang kedua dengan bertanya langsung ke Telegram — dari browser Anda, tanpa perantara.

Chat ID tanpa token

Kotak di bagian atas menjawab pertanyaan yang paling sering muncul — ID sebuah kanal atau grup — tanpa perlu bot sendiri. Untuk chat publik, tempel @username atau link t.me-nya: server AdminHub bertanya ke Telegram dengan getChat, metode yang didokumentasikan Bot API untuk «username supergrup atau kanal tujuan», lalu menampilkan ID beserta judul chat, supaya Anda bisa melihat bahwa itu memang chat yang benar. Untuk kanal atau supergrup privat, tempel link ke postingan mana pun di dalamnya: link t.me/c/ memuat nomor internal chat, dan ID Bot API disusun dari nomor itu langsung di browser Anda — minus dari jumlah 1.000.000.000.000 dan nomor tersebut.

Ada hal-hal yang tidak akan dicari halaman ini. Username milik seseorang atau sebuah bot dijawab tanpa ID: mengubah username publik seseorang menjadi ID permanennya bukan urusan sebuah halaman, dan bot yang dibahas di bawah hanya melakukannya ketika Anda sendiri yang memilih orang itu. Link undangan (t.me/+…) sama sekali tidak memuat ID. Untuk semua itu, @getid_adminhub_bot membaca daftar chat Anda sendiri lewat pemilih chat Telegram. Username yang Anda cari tidak disimpan lebih lama dari cache singkat.

Apa itu token bot

Token bot adalah kunci untuk satu bot. @BotFather memberikannya saat Anda membuat bot dengan /newbot, dan bentuknya seperti 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw — angka, titik dua, lalu deretan panjang huruf, angka, tanda hubung, dan garis bawah. Setiap permintaan ke Bot API membawanya di alamat, di belakang kata bot: https://api.telegram.org/bot<token>/getMe. Dokumentasi Telegram terus terang soal akibatnya: token mengautentikasi bot, bukan akun Anda, siapa pun yang memegangnya bisa mengendalikan bot, dan token harus diperlakukan seperti kata sandi. Token bisa dicabut kapan saja di @BotFather; kalau bocor atau hilang, perintah /token di sana membuat token baru, dan Mini App @BotFather melakukan hal yang sama lewat tombol.

Langkah pertama di halaman ini adalah getMe, metode yang disediakan Bot API justru untuk ini — menguji token. Kalau token berfungsi, Telegram menjawab dengan bot pemilik token itu: namanya, username-nya, ID-nya, dan dua pengaturan yang perlu diketahui sebelum melangkah lebih jauh — apakah bot itu bisa ditambahkan ke grup sama sekali, dan apakah mode privasi (privacy mode) aktif. Kalau token salah ketik atau sudah diganti, Telegram menolaknya, dan halaman ini menyampaikannya dengan kata-kata yang jelas.

Dari mana chat ID berasal

Bot API tidak punya metode yang menampilkan daftar chat sebuah bot. Bot baru mengetahui ID sebuah chat ketika sesuatu dari chat itu sampai kepadanya sebagai update — pesan, postingan, bot ditambahkan atau dikeluarkan — dan getUpdates adalah metode yang menyerahkan update tersebut. Telegram menyimpannya selama 24 jam, jadi chat yang Anda butuhkan harus melakukan sesuatu baru-baru ini. Apa yang perlu dilakukan tergantung chatnya:

Untuk mendapatkan ID	Lakukan ini	Muncul sebagai
Diri Anda sendiri	Kirim /start ke bot	Chat pribadi, angka positif
Grup	Tambahkan bot ke grup	Grup atau supergrup, angka negatif
Kanal	Jadikan bot admin, atau teruskan postingan dari kanal ke bot	Kanal, diawali -100
Orang lain	Teruskan salah satu pesannya ke bot	Chat pribadi, kecuali pengaturan privasinya menyembunyikan dirinya

Menambahkan bot ke grup saja sudah cukup: bot diberi tahu tentang keanggotaannya sendiri, dan aturan mode privasi Telegram membuat setiap bot bisa melihat pesan layanan dan pesan dari kanal tempat ia menjadi anggota, apa pun pengaturannya. Yang memang disembunyikan mode privasi adalah obrolan biasa di grup — kalau mode ini aktif, bot menerima perintah yang ditujukan kepadanya, balasan atas pesannya sendiri, dan pesan layanan, jadi «halo» biasa di grup bisa saja tidak pernah sampai. Perintah yang ditujukan ke bot dengan namanya, seperti /start@your_bot_name, selalu sampai. Meneruskan postingan berhasil untuk kanal yang tidak dimasuki bot, karena postingan yang diteruskan membawa kanal asalnya; orang yang membatasi penerusan pesannya akan muncul sebagai pengirim tak dikenal, tanpa ID yang bisa ditampilkan.

Belum punya bot sendiri, atau chat yang Anda perlukan tidak dimasuki bot Anda? @getid_adminhub_bot membalas dengan ID orang, bot, grup, atau kanal mana pun yang Anda pilih dari daftar chat Anda sendiri lewat pemilih chat Telegram — tanpa token, tanpa meneruskan pesan, kanal privat juga bisa. Bot ini tidak bergabung ke chat mana pun yang Anda pilih dan tidak menyimpan ID chat tersebut. Karena sebuah chat punya ID yang sama untuk setiap bot, angka yang diberikannya juga berlaku untuk bot Anda.

Arti angka-angka itu

Chat ID tidak sembarangan. Referensi Telegram tentang ID dialog di Bot API menaruh orang, grup, dan kanal di satu garis bilangan, sehingga tanda dan besar angka menunjukkan jenis chatnya: ID seseorang bernilai positif dan sekaligus menjadi ID chat pribadinya dengan bot mana pun; ID grup biasa adalah ID internalnya dengan tanda minus; ID supergrup atau kanal adalah minus dari jumlah 1.000.000.000.000 dan ID internalnya. Dengan ID internal sepanjang saat ini, aturan terakhir itulah yang membuat ID kanal terbaca sebagai -100 diikuti digit lainnya — dan itulah sebabnya generator link membuang persis -100 itu saat menyusun link t.me/c/ ke postingan di kanal privat. Salin angka lengkapnya beserta tanda minus: itulah yang diharapkan chat_id. Referensi yang sama mencatat bahwa ID bisa lebih panjang dari 32 bit tetapi tidak pernah lebih dari 52, jadi integer 64-bit bisa menyimpannya dengan aman.

Sebuah chat juga bisa berganti ID satu kali. Saat grup biasa ditingkatkan menjadi supergrup, grup itu mendapat ID baru yang diawali -100, dan ID lama tidak lagi menjadi alamat yang benar: Telegram menjawab permintaan ke ID lama dengan error yang menyebutkan ID baru. Kalau bot menyaksikan momen peningkatan itu, halaman ini menampilkan ID baru di samping ID lama.

Saat update tidak bisa dibaca

Ada dua cara bot menerima update, dan dokumentasi Telegram menyebut keduanya saling eksklusif: getUpdates, yang dipakai halaman ini, atau webhook, di mana Telegram mengirim setiap update ke sebuah server. Kalau bot punya webhook, getUpdates ditolak, dan halaman ini memberi tahu Anda alih-alih menghapus webhook-nya — menghapusnya akan memutus server Anda dari botnya sendiri. Ada dua jalan keluar: baca chat.id di update yang sudah diterima server Anda, atau tambahkan bot kedua sebagai cadangan ke chat yang sama dan cek tokennya di sini, karena sebuah chat punya ID yang sama untuk setiap bot.

Bot yang sudah berjalan dengan getUpdates — skrip atau framework yang terus meminta update — mengambil setiap update begitu update itu masuk dan mengonfirmasinya, jadi tidak ada yang tersisa untuk dibaca halaman ini, dan daftarnya tetap kosong berapa kali pun Anda mengecek. Hentikan bot sebentar, lakukan langkah yang membuat chat muncul, cek di sini, lalu jalankan lagi botnya: update yang dilihat halaman ini masih menunggu bot, karena halaman ini tidak pernah mengeluarkan update dari antrean bot. Menghentikan bot lebih dulu penting karena satu alasan lagi. Saat dua permintaan getUpdates untuk satu bot tumpang tindih, Telegram bisa menjawab salah satunya dengan error Conflict, dan sebagian framework bot berhenti meminta update saat menerimanya; kalau error itu justru jatuh ke halaman ini, halaman ini akan memberi tahu Anda.

Apa yang dikirim halaman ini, dan ke siapa

Bagian halaman yang memakai token memanggil dua metode, getMe dan getUpdates, dan keduanya hanya membaca. getUpdates dipanggil tanpa parameter sama sekali, dengan sengaja: offset akan mengonfirmasi update, yang mengeluarkannya dari antrean yang dibaca bot Anda, dan daftar update yang diizinkan akan disimpan Telegram sebagai pengaturan bot itu sendiri. Halaman ini tidak pernah memasang atau menghapus webhook dan tidak pernah mengirim pesan. Permintaan dikirim dari browser Anda ke api.telegram.org dan tidak ke mana pun selain itu — tab Network di developer tools browser Anda menampilkannya — jadi server AdminHub tidak pernah menerima token. Halaman ini menyimpan token hanya di tab yang terbuka, tidak pernah di penyimpanan browser, dan kolom serta hasilnya dikecualikan dari analitik situs dan rekaman sesi. Kalau Anda lebih suka melakukannya secara manual, buka https://api.telegram.org/bot<token>/getUpdates di browser dengan token Anda menggantikan <token>: itu permintaan yang sama, dijawab dalam JSON mentah, dengan ID setiap chat di bawah “chat” dan “id”. Pencarian username di bagian atas adalah satu-satunya bagian yang lewat server AdminHub — yang dikirim ke sana adalah username, tidak pernah token.

Kalau token dan chat ID itu untuk agen AI yang harus memposting ke kanal Anda, ada cara untuk sama sekali tidak menyerahkan token ke agen: server MCP AdminHub menghubungkan Claude, ChatGPT, atau Cursor ke kanal, dan postingan terkirim lewat bot Anda sendiri.

---

Sumber, diperiksa Oktober 2026: Telegram Bot API — Authorizing your bot untuk format token dan alamat permintaan, getMe, getUpdates untuk halaman berisi 100 update, konfirmasi lewat offset, dan pengaturan allowed_updates yang tersimpan, Getting updates untuk penyimpanan 24 jam dan dua cara yang saling eksklusif, Update dan ChatMemberUpdated untuk perubahan keanggotaan bot itu sendiri, MessageOrigin untuk pesan yang diteruskan, ResponseParameters untuk migrate_to_chat_id; Bot features untuk mode privasi serta pembuatan bot dan token baru di @BotFather; Bot API dialog IDs untuk rentang ID orang, grup, supergrup, dan kanal; Bot tutorial untuk pencabutan token dan memperlakukannya seperti kata sandi; Bots FAQ untuk getUpdates yang tidak berfungsi selama webhook terpasang.