Telegram bot token nasıl alınır, nerede bulunur ve nasıl iptal edilir?

Güncellendi: 29 Ekim 2026 · 6 dk okuma

Telegram bot token'ı @BotFather'dan alınır: /newbot ile yeni bir bot oluşturduğunuzda BotFather token'ı mesaj olarak gönderir, mevcut bir botun token'ını ise /mybots → bot → API Token yolundan görürsünüz. Bu rehberde token'ın ne olduğunu, getMe ile nasıl test edileceğini, sızan bir token'ın nasıl iptal edileceğini ve n8n ya da yapay zekâ asistanlarında nasıl güvenle kullanılacağını anlatıyoruz.

Telegram bot token nedir?

Token, botunuzun Bot API'deki kimlik bilgisidir. Resmî dokümantasyondaki örnek 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 biçimindedir; bu rehberde yer tutucu olarak 123456789:AAEexampleTokenReplaceWithYours kullanıyoruz. İki nokta üst üsteden önceki sayı botun kimliğidir, sonrası ise gizli kısımdır.

Her istek token'ı URL'nin içinde taşır:

https://api.telegram.org/bot<token>/METHOD_NAME

Token'ı bilen biri güncellemeleri okuyabilir, botunuz adına mesaj gönderebilir, webhook'u ve komutları değiştirebilir. Yani token bir şifre gibi korunmalıdır.

Token ile chat ID arasındaki fark

Yeni başlayanların sık yaptığı bir hata, token'daki sayıyı chat ID sanmaktır:

• Token botu tanımlar ve isteği yetkilendirir; URL'de bot kelimesinin hemen ardından gelir.
• Chat ID mesajın gideceği sohbeti tanımlar ve chat_id parametresiyle gönderilir. Kullanıcılar için pozitif, gruplar için negatif bir sayıdır.
• Token'ın başındaki sayı botun kendi kimliğidir, sizin chat ID'niz değildir. Kendi ID'nizi öğrenmek için bota yazıp getUpdates çağırmanız gerekir.

Telegram bot token alma: yeni bot için

1. Telegram'da @BotFather sohbetini açın.
2. /newbot gönderin ve botun görünen adını yazın.
3. Kullanıcı adını girin: 5–32 karakter, Latin harf, rakam ve alt çizgi, sonu bot ile biten bir ad (ör. siparis_takip_bot).
4. BotFather'ın tebrik mesajındaki 123456789:AA... biçimindeki satır token'ınızdır. Tamamını, başında ve sonunda boşluk olmadan kopyalayın.

Botu oluşturma sürecinin tamamı ve ilk mesaj için Telegram bot yapma rehberine göz atın.

Mevcut botun token'ını bulma

1. @BotFather'a /mybots yazın.
2. Listeden botunuzu seçin.
3. API Token düğmesine basın; BotFather mevcut token'ı gösterir.

Token'ı yalnızca botu yöneten hesap görebilir. Dikkat: /token komutu mevcut token'ı göstermek yerine yeni bir token üretir; sadece token'ı bulmak istiyorsanız bu komutu kullanmayın, yoksa eski token'la çalışan servisleriniz durur. Güncel komut listesini görmek için BotFather sohbetinde / yazmanız yeterli.

Token'ı getMe ile kontrol etme

curl "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/getMe"

Geçerli bir token şu yanıtı verir:

{
  "ok": true,
  "result": {
    "id": 123456789,
    "is_bot": true,
    "first_name": "Sipariş Takip",
    "username": "siparis_takip_bot",
    "can_join_groups": true,
    "can_read_all_group_messages": false,
    "supports_inline_queries": false
  }
}

Hatalı token'da ise şunu görürsünüz:

{"ok": false, "error_code": 401, "description": "Unauthorized"}

401 Unauthorized şu durumlarda çıkar: token eksik veya fazladan boşluk, tırnak ya da satır sonuyla kopyalanmış; token /revoke ile yenilenmiş; ya da bot test ortamında oluşturulmuş ve istek üretim adresine gidiyor. URL'de bot ön eki unutulursa yanıt 404 Not Found olur.

Komut satırı yerine tarayıcıda denemek için Bot API Tester'da getMe metodunu açın: token'ı üstteki alana yapıştırın ve Ctrl+Enter ile çalıştırın. Token tarayıcınızın localStorage'ında kalır, istekler doğrudan api.telegram.org'a gider.

Sızan token'ı iptal etme (revoke)

Token'ı herkese açık bir GitHub deposuna gönderdiyseniz, ekran görüntüsünde paylaştıysanız veya güvenmediğiniz bir siteye yapıştırdıysanız hemen yenileyin:

1. @BotFather'a /revoke gönderin ve botu seçin; ya da /mybots → bot → API Token → Revoke current token yolunu izleyin.
2. BotFather yeni bir token verir; eski token artık 401 Unauthorized döndürür.
3. Yeni token'ı sunucunuzdaki ortam değişkenlerine, CI gizli değişkenlerine ve bağlı tüm servislere girin.
4. Depodan silmek yetmez: token Git geçmişinde kalır, bu yüzden iptal etmek şarttır.

Token'ı güvenle saklama

• Token'ı koda değil ortam değişkenine koyun; .env dosyasını .gitignore'a ekleyin.
• Tarayıcıda çalışan JavaScript'e, mobil uygulamaya veya Mini App koduna asla koymayın: istemci kodunu herkes görebilir. Bot API çağrılarını sunucunuzdan yapın.
• Token URL'nin parçası olduğu için istek URL'lerini loglarken maskeleyin.
• Denemeler için ayrı bir test botu oluşturun; canlı botun token'ını paylaşmanız gerekmez.

export BOT_TOKEN="123456789:AAEexampleTokenReplaceWithYours"

import os
import requests

token = os.environ["BOT_TOKEN"]
r = requests.get(f"https://api.telegram.org/bot{token}/getMe", timeout=10)
print(r.json()["ok"])

Otomasyon ve yapay zekâ asistanlarında token ve chat ID

n8n'in Telegram düğümü gibi otomasyon araçları ve Telegram'a bağlanan yapay zekâ asistanları (ör. OpenClaw) genellikle iki bilgi ister: bot token'ı ve mesajların gideceği chat ID. Pratik bir düzen:

1. Entegrasyon için ayrı bir bot oluşturun; böylece gerekirse yalnızca onun token'ını iptal edersiniz.
2. Token'ı aracın kendi kimlik bilgisi alanına girmeden önce getMe ile doğrulayın.
3. Bota bir mesaj yazıp chat ID'yi öğrenin — adımlar Telegram chat ID rehberinde.
4. Bu araçlar çoğu zaman güncellemeleri webhook ile alır; aynı token'la ayrıca getUpdates çağırırsanız 409 Conflict görürsünüz. Ayrıntılar webhook rehberinde.