Telegram bot token kontrolü ve chat ID bulma

Bot token’ı ve chat ID, her Telegram entegrasyonunun istediği iki değerdir: token hangi botun konuştuğunu, chat ID nereye konuştuğunu söyler. Bu sayfa birincisini kontrol eder, ikincisini bulur — Telegram’ın kendisine sorarak, tarayıcınızdan, arada hiçbir şey olmadan.

Token olmadan chat ID

En üstteki kutu en sık sorulan soruyu — bir kanalın ya da grubun ID’sini — kendi botunuz olmadan yanıtlar. Herkese açık bir sohbet için @kullanıcı adını ya da t.me bağlantısını yapıştırın: AdminHub’ın sunucusu Telegram’a getChat ile sorar — Bot API bu yöntemi «hedef süper grubun ya da kanalın kullanıcı adı» için belgeler — ve ID’yi sohbetin adıyla birlikte gösterir; böylece doğru sohbet olduğunu görürsünüz. Özel bir kanal ya da süper grup için herhangi bir gönderisinin bağlantısını yapıştırın: t.me/c/ bağlantısı sohbetin iç numarasını taşır ve Bot API ID’si doğrudan tarayıcınızda bu numaradan kurulur — 1.000.000.000.000 ile bu numaranın toplamının eksilisi olarak.

Sayfanın aramayacağı bazı şeyler var. Sayfa, bir kişiye ya da bota ait bir kullanıcı adına ID vermeden yanıt verir: birinin herkese açık kullanıcı adını onun kalıcı ID’sine çevirmek bir sayfanın işi değildir; aşağıda anlatılan bot da bunu yalnızca kişiyi siz kendiniz seçtiğinizde yapar. Davet bağlantısı (t.me/+…) hiç ID taşımaz. Bunların hepsi için @getid_adminhub_bot, Telegram’ın sohbet seçicisiyle sizin kendi sohbet listenizi okur. Aradığınız kullanıcı adları kısa bir önbellek süresinden fazla tutulmaz.

Bot token’ı nedir

Bot token’ı tek bir botun anahtarıdır. @BotFather onu /newbot ile bir bot oluşturduğunuzda verir ve 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw gibi görünür — rakamlar, iki nokta üst üste, ardından harf, rakam, kısa çizgi ve alt çizgilerden oluşan uzun bir dizi. Bot API’ye yapılan her istek onu adresin içinde, bot kelimesinin hemen arkasında taşır: https://api.telegram.org/bot<token>/getMe. Telegram’ın belgeleri bundan çıkanları açıkça söyler: token hesabınızı değil botu doğrular, ona sahip olan herkes botu kontrol edebilir ve ona bir parola gibi davranılmalıdır. Token @BotFather’da her an iptal edilebilir; sızdıysa ya da kaybolduysa oradaki /token komutu yenisini üretir, @BotFather Mini App’i de aynısını düğmelerle yapar.

Bu sayfadaki ilk adım getMe; Bot API’nin tam da bunun için, yani bir token’ı sınamak için ayırdığı yöntem. Token çalışıyorsa Telegram ait olduğu botla yanıt verir: adı, kullanıcı adı, ID’si ve devam etmeden önce bilmeye değer iki ayar — botun gruplara eklenip eklenemediği ve gizlilik modunun açık olup olmadığı. Token yanlış yazılmışsa ya da yenisiyle değiştirilmişse Telegram onu reddeder ve sayfa bunu açık bir dille söyler.

Chat ID’ler nereden gelir

Bot API’de bir botun sohbetlerini listeleyen bir yöntem yoktur. Bot bir sohbetin ID’sini ancak o sohbetten bir şey ona güncelleme (update) olarak ulaştığında öğrenir — bir mesaj, bir gönderi, botun eklenmesi ya da çıkarılması — ve bu güncellemeleri dağıtan yöntem getUpdates’tir. Telegram onları 24 saat saklar; yani ihtiyacınız olan sohbette yakın zamanda bir şey olmuş olmalı. Bunun ne olacağı sohbete bağlıdır:

ID’si gereken	Yapılacak	Listede görünüşü
Siz	Bota /start gönderin	Özel sohbet, pozitif sayı
Bir grup	Botu gruba ekleyin	Grup ya da süper grup, negatif sayı
Bir kanal	Botu yönetici yapın ya da kanaldan bir gönderiyi bota iletin	Kanal, -100 ile başlar
Başka bir kişi	Onun mesajlarından birini bota iletin	Özel sohbet; kişinin gizlilik ayarları onu gizlemiyorsa

Botu bir gruba eklemek tek başına yeterlidir: bot kendi üyeliğinden haberdar edilir ve Telegram’ın gizlilik modu kuralları, ayar ne olursa olsun her botun servis mesajlarını ve üyesi olduğu kanalların mesajlarını görmesine izin verir. Gizlilik modunun gerçekten gizlediği şey gruplardaki sıradan sohbettir — mod açıkken bot kendisine yönelik komutları, kendi mesajlarına verilen yanıtları ve servis mesajlarını alır; dolayısıyla gruba yazılmış düz bir «merhaba» hiç gelmeyebilir. /start@your_bot_name gibi bota adıyla seslenen bir komut ise her zaman gelir. İletme, botun içinde olmadığı kanallar için de işe yarar, çünkü iletilen bir gönderi geldiği kanalı yanında taşır; mesajlarının iletilmesini kısıtlayan bir kişi ise gösterecek bir ID’si olmadan, bilinmeyen gönderen olarak gelir.

Henüz kendi botunuz yok mu, yoksa botunuz ihtiyacınız olan sohbette değil mi? @getid_adminhub_bot, kendi sohbet listenizden Telegram’ın sohbet seçicisiyle seçtiğiniz herhangi bir kişinin, botun, grubun ya da kanalın ID’sini gönderir — token gerekmeden, mesaj iletmeden, özel kanallar da dahil. Seçtiğiniz sohbetlerin hiçbirine katılmaz ve onların ID’lerini saklamaz; bir sohbetin ID’si her bot için aynı olduğundan, verdiği sayı kendi botunuz için de geçerlidir.

Sayılar ne anlama gelir

Chat ID’ler rastgele değildir. Telegram’ın Bot API diyalog ID’leri referansı kişileri, grupları ve kanalları tek bir sayı doğrusuna yerleştirir; böylece bir sayının işareti ve büyüklüğü sohbetin türünü söyler: bir kişinin ID’si pozitiftir ve aynı zamanda herhangi bir botla özel sohbetinin ID’sidir; basit bir grubun ID’si, iç ID’sinin eksi işaretlisidir; bir süper grubun ya da kanalın ID’si ise 1.000.000.000.000 ile iç ID’sinin toplamının eksilisidir. Bugünkü uzunluktaki iç ID’lerle kanal ID’lerinin -100 ve ardından gelen başka rakamlar şeklinde okunmasının nedeni bu son kuraldır — bağlantı oluşturucunun özel bir kanaldaki gönderiye t.me/c/ bağlantısı kurarken tam da bu -100’ü atmasının nedeni de. Sayının tamamını eksi işaretiyle kopyalayın: chat_id’nin beklediği budur. Aynı referans, bir ID’nin 32 bitten uzun olabileceğini ama hiçbir zaman 52 biti aşmadığını belirtir; bu yüzden 64 bitlik bir tamsayı onu güvenle saklar.

Bir sohbet ID’sini bir kez de değiştirebilir. Basit bir grup süper gruba yükseltildiğinde grup -100’lü yeni bir ID alır ve eski ID artık doğru adres olmaz: Telegram ona yapılan bir isteği, yeni ID’yi belirten bir hatayla yanıtlar. Bot yükseltme anını gördüyse bu sayfa yeni ID’yi eskisinin yanında gösterir.

Güncellemeler okunamadığında

Bir botun güncelleme almasının iki yolu vardır ve Telegram’ın belgeleri bunları birbirini dışlayan yollar olarak tanımlar: bu sayfanın kullandığı getUpdates ya da Telegram’ın her güncellemeyi bir sunucuya gönderdiği webhook. Botun bir webhook’u varsa getUpdates reddedilir ve bu sayfa webhook’u kaldırmak yerine bunu söyler — onu silmek sunucunuzu kendi botundan koparırdı. İki çıkış yolu var: sunucunuzun zaten aldığı güncellemelerdeki chat.id değerini okuyun ya da aynı sohbete ikinci, yedek bir bot ekleyip onun token’ını burada kontrol edin; çünkü bir sohbetin ID’si her bot için aynıdır.

getUpdates ile zaten çalışan bir bot — güncellemeleri sürekli soran bir betik ya da framework — her güncellemeyi geldiği anda alır ve onaylar; bu yüzden bu sayfaya okuyacak bir şey kalmaz ve ne kadar kontrol ederseniz edin liste boş kalır. Botu bir dakikalığına durdurun, sohbetin görünmesini sağlayan adımı yapın, burada kontrol edin, sonra botu yeniden çalıştırın: sayfanın gördüğü güncellemeler hâlâ botu bekler, çünkü bu sayfa güncellemeleri botun kuyruğundan asla çıkarmaz. Botu önce durdurmanın bir nedeni daha var. Bir bot için iki getUpdates isteği çakıştığında Telegram bunlardan birine Conflict hatasıyla yanıt verebilir ve bazı bot framework’leri bu hatayı alınca güncelleme istemeyi bırakır; hata bunun yerine bu sayfaya düşerse sayfa bunu söyler.

Sayfa neyi, kime gönderir

Sayfanın token’la çalışan yarısı iki yöntem çağırır, getMe ve getUpdates, ve ikisi de yalnızca okur. getUpdates’i bilerek hiçbir parametre olmadan çağırır: bir offset güncellemeleri onaylardı, bu da onları botunuzun okuduğu kuyruktan çıkarır; izin verilen güncellemelerin listesi ise Telegram tarafından botun kendi ayarı olarak kaydedilirdi. Sayfa hiçbir zaman webhook kurmaz ya da silmez ve hiçbir zaman mesaj göndermez. İstekler tarayıcınızdan api.telegram.org’a gider, başka hiçbir yere değil — tarayıcınızın geliştirici araçlarındaki Ağ (Network) sekmesi onları gösterir — dolayısıyla AdminHub’ın sunucusu token’ı hiç almaz. Sayfa token’ı yalnızca açık sekmede tutar, tarayıcı depolamasında asla; token alanı ve sonuçlar sitenin analitiğinin ve oturum kayıtlarının dışında tutulur. Elle yapmayı tercih ederseniz https://api.telegram.org/bot<token>/getUpdates adresini <token> yerine kendi token’ınızı koyarak bir tarayıcıda açın: aynı istektir, yanıtı ham JSON olarak gelir ve her sohbetin ID’si “chat” ve “id” altında durur. En üstteki kullanıcı adı araması, AdminHub’ın sunucusundan geçen tek kısımdır — oraya giden kullanıcı adıdır, asla token değil.

Token ve chat ID, kanalınıza gönderi paylaşması gereken bir yapay zeka ajanı içinse ajana hiç token vermeden de olur: AdminHub’ın MCP sunucusu Claude, ChatGPT ya da Cursor’ı kanala bağlar ve gönderiler kendi botunuz üzerinden çıkar.

---

Kaynaklar, Ekim 2026’da kontrol edildi: Telegram Bot API — token biçimi ve istek adresi için Authorizing your bot, getMe, 100 güncellemelik sayfa, offset onayı ve kaydedilen allowed_updates ayarı için getUpdates, 24 saatlik saklama süresi ve birbirini dışlayan iki yol için Getting updates, botun kendi üyelik değişiklikleri için Update ve ChatMemberUpdated, iletilen mesajlar için MessageOrigin, migrate_to_chat_id için ResponseParameters; gizlilik modu ile @BotFather’da bot oluşturma ve yeni token üretme için Bot features; kişilerin, grupların, süper grupların ve kanalların ID aralıkları için Bot API dialog IDs; token’ı iptal etme ve ona parola gibi davranma için Bot tutorial; webhook kuruluyken getUpdates’in çalışmaması için Bots FAQ.