Telegram bot token nasıl alınır, bulunur ve korunur

Kısaca. Telegram bot token’ı @BotFather’dan gelir: /newbot gönderin, bir ad ve bot ile biten bir kullanıcı adı seçin, token gelir — 110201543:AAHdq…. Kaybettiniz mi? /mybots → botunuz → API Token. Sızdı mı? Aynı yerden iptal edin, eskisi çalışmayı bırakır. Herhangi bir token’ı getMe ile kontrol edin — ya da botunuzun chat ID’lerini de listeleyen ücretsiz token kontrol aracında. Ve Bot API için ihtiyacınız olan tek şey budur: my.telegram.org’daki api_id / api_hash, Telegram ile MTProto üzerinden iletişim kuran uygulamalar içindir.

Token, beş satırlık bir betikten otomasyon servisine ve yapay zeka ajanına kadar her Telegram bot entegrasyonunun istediği tek şeydir. Almak bir dakika sürer; sıkıntının çoğu sonra başlar — onu yeniden bulmak, Telegram’ın diğer kimlik bilgilerinden ayırt etmek ve olmaması gereken bir yere düştüğü gün ne yapacağınızı bilmek.

Adım adım: BotFather’dan token almak

1. @BotFather’ı açın — Telegram’ın bot oluşturmak ve yönetmek için kendi botu — ve Başlat’a (Start) basın.
2. /newbot gönderin.
3. Bir görünen ad gönderin. Sohbetlerde ve kişilerde görünür, sonradan değiştirilebilir.
4. Bir kullanıcı adı gönderin. bot ile bitmeli (tetris_bot, TetrisBot), Latin harfleri, rakamlar ve alt çizgilerden oluşan 5–32 karakter olmalı ve — addan farklı olarak — sonradan değiştirilemez. Bir adın boşta olup olmadığını görmenin hızlı yolu kullanıcı adı kontrol aracı.
5. BotFather token’la yanıt verir.

Token şöyle görünür: 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw — 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 adreste, bot kelimesinin arkasında taşır: https://api.telegram.org/bot<token>/getMe.

BotFather’ın bütün bunları komut yerine düğmelerle yapan bir Mini App’i de var — sonuç aynı, token aynı.

Var olan bir botun token’ını bulmak

@BotFather’a /mybots gönderin, botu seçin ve API Token’ı açın. Telegram’ın onu gösterdiği tek yer burası: botun profili değil, sohbeti değil, Telegram ayarları değil. Botu uzun zaman önce oluşturduysanız ve hangi hesaba ait olduğunu hatırlamıyorsanız: sahibi, BotFather sohbetinde botun /mybots altında göründüğü hesaptır.

Token’ın çalıştığını kontrol etmek

Bot API’de tam da bunun için yapılmış bir yöntem var: getMe, «botunuzun kimlik doğrulama token’ını test etmek için basit bir yöntem». Token doğruysa botun adı, kullanıcı adı ve ID’siyle yanıt verir. Çağırmanın iki yolu var:

• tarayıcıda https://api.telegram.org/bot<token>/getMe adresini, <token> yerine kendi token’ınızı koyarak açın;
• token’ı bot token kontrol aracına yapıştırın; araç aynı isteği doğrudan tarayıcınızdan api.telegram.org’a gönderir, ardından botun son güncellemelerini okuyup her sohbeti chat ID’siyle listeler.

Yanıtlar ne anlama gelir:

Telegram’ın yanıtı	Anlamı
botun adı, kullanıcı adı ve ID’si	token çalışıyor
Unauthorized (401)	token yanlış yazılmış ya da BotFather’da iptal edilip yenisiyle değiştirilmiş
Not Found (404)	adreste hiç token yok — iki nokta üst üste ya da önündeki bot kelimesi eksik

Sızan token: hemen iptal edin

Token’a sahip olan herkes botu kontrol eder: ona gönderilenleri okur, onun adına yazar, ayarlarını değiştirir. Telegram’ın bot rehberi, token’a bir parola gibi davranılması gerektiğini ve @BotFather üzerinden her an iptal edilebileceğini söyler.

Bir token herkese açık bir depoya, bir ekran görüntüsüne, paylaşılan bir belgeye ya da güvenmediğiniz bir sohbete yapıştırıldıysa, onu @BotFather → /mybots → botunuz → API Token yolundan iptal edin. Bot yeni bir token alır ve eskisi çalışmayı bırakır — eski token’la çalışan her şeyin, kendi kodunuz dahil, bağlantısı kesilir; bu yüzden hemen ardından yeni token’ı botunuzun çalıştığı yere koyun.

Baştan nerede saklanmalı: Telegram’ın rehberi kodun kendisi yerine bir ayar dosyası ya da ortam değişkenleri önerir. Kod paylaşılır, fork’lanır ve sorulara yapıştırılır; sunucudaki bir ortam değişkeninin başına bunlar gelmez.

Token, API ID ve hash değildir

Sık yapılan bir karışıklık: my.telegram.org, «API development tools» altında bir api_id ve api_hash verir. Bunlar Telegram ile MTProto API üzerinden iletişim kuran bir uygulamayı tanımlar — çoğunlukla bir kullanıcı hesabı olarak giriş yapan özel istemcileri, ayrıca bunları token’a ek olarak isteyen MTProto bot kütüphanelerini ve kendi barındırdığınız Bot API sunucusunu. Çoğu bot servisinin ve otomasyonun kullandığı, api.telegram.org adresindeki standart Bot API ise BotFather’dan gelen token’ı alır, başka hiçbir şeyi değil.

Token’ı kopyalamanız gerekiyor mu?

Her zaman değil. Telegram bir botun başka botlar oluşturmasına ve onları yönetmesine izin veriyor — yönetilen botlar (managed bots): bir uygulama size bir bağlantı gönderir, Telegram yeni botun adını ve kullanıcı adını içeren bir pencere gösterir, siz onaylarsınız ve uygulama botun token’ını doğrudan Telegram’ın kendisinden alır. Token panonuza hiç ulaşmaz; yapıştıracak ya da sızacak bir şey kalmaz. AdminHub bir kanalın botunu bu şekilde bağlar — kanalınız için bot oluşturma rehberi iki yolu da gösterir, kod yazmadan bot oluşturma da botun arkasında neyin çalışacağını anlatır.

Token’la bundan sonra ne yapılır

Çoğu entegrasyon iki değer ister: token ve bir chat ID — botun nereye yayın yapacağı. Chat ID rehberi her tür sohbeti ele alır; token kontrol aracı botunuzun zaten konuştuğu sohbetlerin ID’lerini bulur.

---

Kaynaklar, Ekim 2026’da kontrol edildi: Telegram Bot API — Authorizing your bot (token biçimi ve istek adresi), getMe; Bot features — BotFather (/newbot, kullanıcı adı kuralları, yeni token üretme, BotFather Mini App’i), Managed Bots; Bot tutorial — token’ı iptal etme, ona parola gibi davranma, onu kodun dışında tutma; Obtaining api_id — api_id ve api_hash’in ne işe yaradığı.