Telegram Botu Nasıl Çalışır? Token, Sunucu ve API Mantığı

Bir Telegram botu kurma fikri aklınıza geldiğinde önünüzde duran ilk engel teknik değil kavramsal. "Token ne işe yarar?", "Sunucu şart mı?", "AI nasıl bağlanıyor?" — bu soruları yanıtlamadan hiçbir rehber işe yaramaz. Bu yazı tam olarak o boşluğu dolduruyor.

Telegram Botu Aslında Nedir?

Telegram botları, Telegram hesabı gibi görünen ama bir uygulama tarafından kontrol edilen özel hesaplardır. Kullanıcı size mesaj atar; siz yerine bir yazılım yanıtlar. O yazılımın nerede çalıştığı, ne kadar akıllı olduğu ve ne zaman dinlediği tamamen size bağlıdır.

Arka planda şu dört parça olmadan hiçbir bot çalışmaz:

1. Bot Token — Telegram'ın size verdiği kimlik kartı
2. Telegram API — Mesajları almak ve göndermek için kullandığınız köprü
3. Daima Açık Sunucu — Mesajları işleyen, kodu çalıştıran bilgisayar
4. AI / LLM Bağlantısı — Bota zeka katan katman (opsiyonel, ama istenen şey bu)

Şimdi her birini sırayla çözelim.

---

1. Bot Token: Telegram'ın Kimlik Kartı

Her bot, BotFather adlı resmi Telegram botundan alınan bir token ile kimliğini kanıtlar. Token şöyle görünür:

7491234567:AAFxyz123abc456def789ghi

Bu dizi hem botu tanımlar hem de o bota özel API erişimini açar. Token olmadan Telegram API'ına tek bir istek bile atamazsınız; token sızdığında ise botunuz ele geçirilmiş demektir.

Önemli: Token bir şifre gibidir. .env dosyasına koyun, asla kod içine yazmayın, versiyon kontrolüne göndermeyin.

BotFather'dan token almak beş dakika sürer: /newbot komutu, bir isim, bir kullanıcı adı — ve token size gelir. Zor olan kısım bu değil. Zor olan kısım sıradaki adım.

---

2. Telegram API: Mesajlar Nasıl Akar?

Telegram, botlarla iletişim için iki yöntem sunar:

Polling (Yoklama)

Botunuz periyodik olarak Telegram sunucularına "Yeni mesaj var mı?" diye sorar. Basit ama verimsiz — botunuz uyursa mesajlar birikir, sunucu meşgulse cevaplar geç gelir.

Bot → GET https://api.telegram.org/bot<TOKEN>/getUpdates
          ↓
      Telegram sunucusu: "İşte son 5 mesaj"

Webhook (Anlık Tetikleme)

Telegram, yeni bir mesaj geldiğinde doğrudan sizin sunucunuza bir HTTP POST isteği atar. Gecikme sıfıra yakın, yük minimum.

Kullanıcı mesaj atar
       ↓
Telegram sunucusu → POST https://sizin-sunucunuz.com/webhook
                              ↓
                        Botunuz anında işler

Webhook kullanmak için iki şeye ihtiyacınız var: genel erişime açık bir URL ve o URL'de her zaman çalışan bir süreç. Burası çoğu kişinin takıldığı noktadır.

---

3. Daima Açık Sunucu: En Sık Atlanan Parça

Botunuz sadece siz bilgisayarınızın başındayken değil, gece yarısı, hafta sonu, elektrikler gittiğinde de çalışmak zorunda. Bu yüzden yerel bir bilgisayarda bot çalıştırmak uzun vadede mümkün değildir.

Tipik çözüm bir bulut sunucusu kiralamak, üzerine Python/Node.js ortamı kurmak, botu bir systemd servisi ya da Docker konteyneri ile ayağa kaldırmak, SSL sertifikası almak (webhook için zorunlu) ve tüm bunları sürekli güncellemek. Minimum bir sunucu aylık ~5-8 dolar; kurulum birkaç saat.

Bunun yanı sıra sunucunun çökmesi, belleğin dolması, sertifikanın süresi dolması gibi operasyonel sorunlar da size düşer.

---

4. AI / LLM Bağlantısı: Bota Zeka Katmak

Bir bot kural tabanlı da çalışabilir ("eğer /fiyat yazarsa şunu döndür") ama asıl güç serbest dille anlayan, bağlamı hatırlayan ve akıl yürüten bir dil modeline bağlandığında ortaya çıkar.

Bunun için OpenAI, Anthropic, Mistral gibi bir sağlayıcıdan API anahtarı almanız, o anahtarı güvenli şekilde saklamanız ve API çağrı maliyetlerini takip etmeniz gerekir. Canlı ortamda aylık onlarca dolar harcamanız normaldir.

Yani bir AI Telegram botu için gerçek liste şu:

• BotFather'dan token al
• LLM sağlayıcısından API anahtarı al (OpenAI, Anthropic vb.)
• Bir sunucu kirala
• SSL sertifikası ayarla
• Botu yaz, webhook'u kaydet
• Her şeyi monitörle, güncellemeleri uygula

Bu liste sizi korkutuyorsa haklısınız. Teknik borç, zaman ve sürekli bakım gerektiren bir kurulum. Asıl yapmak istediğiniz şey botu çalıştırmak, bu listeyi tamamlamak değil.

---

AgentRoost'ta Bu Parçaların Tamamı Hazır Geliyor

AgentRoost tam olarak bu engeli kaldırmak için tasarlandı. Hermes veya OpenClaw framework'lerinden birini seçtiğinizde:

• Bot token otomatik sağlanır. BotFather'a gitmenize gerek yok; AgentRoost manager botunda /start yazarsınız, botunuz anında aktif olur.
• Sunucu her zaman açıktır. Webhook kaydı, SSL, process supervisor — hepsi hazır. Siz hiçbir şey yapmazsınız.
• AI kredisi dahil gelir. OpenAI, Anthropic veya 350'den fazla LLM modelinden herhangi birini bota bağlamak için ayrıca API anahtarı almanıza gerek yok. AI maliyeti aboneliğin içinde.

Nasıl Başlanır?

1. agentroost.app adresine gidin, hesap oluşturun.
2. Framework olarak Hermes (araştırma, izleme, zamanlanmış görevler için) veya OpenClaw (sohbet odaklı kişisel asistan için) seçin.
3. Agent'ınıza bir isim verin.
4. AgentRoost manager botunu açın ve /start yazın — botunuz hemen aktif olur.
5. Yaklaşık 2 dakika içinde botunuz Telegram'da canlıya geçer. AI soruları yanıtlar; ayrıca API anahtarı ya da sunucu düşünmezsiniz — dahil.

Fiyatlar $19.99/ay'dan başlar. Bu rakama sunucu, SSL, AI kredisi ve kurulum dahil. 14 gün içinde memnun kalmazsanız iade alırsınız; yıllık taahhüt yok.

Planları karşılaştır →

---

Kısa Özet: Hangi Parça Ne İşe Yarar?

Parça	Ne işe yarar	Kim sağlar?
Bot Token	Botu Telegram'da tanımlar	BotFather (ya da AgentRoost otomatik)
Telegram API	Mesajları iletir	Telegram (altyapı)
Webhook URL	Anlık mesaj iletimi	Sizin sunucunuz (AgentRoost'ta dahil)
Daima açık sunucu	Kodu çalıştırır	Sizin VPS'iniz (AgentRoost'ta dahil)
LLM API anahtarı	Zekayı bağlar	OpenAI vb. (AgentRoost'ta dahil)

Kendiniz kuruyorsanız beş parçanın beşini de temin etmeniz gerekir. AgentRoost'ta son dördü hazır gelir; siz sadece botunuzu şekillendirirsiniz.

---

Yaygın Bir Yanlış Anlama: "Token = AI Değil"

Bot token yalnızca Telegram'la iletişimi açar. Botunuzun "akıllı" olması için ayrıca bir LLM'e bağlanmanız gerekir. Bu iki ayrı şey: biri Telegram API anahtarı, diğeri AI API anahtarı. Çoğu kurulum rehberi bu ayrımı atlıyor; ilerledikçe insanlar şaşırıyor.

AgentRoost'ta bu ayrım sizin sorununuz değil. Platform her iki katmanı da yönetiyor.

---

Bir Sonraki Adım

Telegram botunun bileşenlerini artık biliyorsunuz. Sıradaki karar: bunları kendiniz mi kuracaksınız, yoksa zaten kurulu halde mi kullanmak istiyorsunuz?

Kendiniz kurmak isterseniz python-telegram-bot veya node-telegram-bot-api başlangıç için iyi seçenekler. Birkaç gün ayırmanız gerekecek.

Sadece botu çalıştırmak istiyorsanız → Hermes veya OpenClaw'a bakın ve 2 dakikada başlayın.