Telegram bot, Telegram üzerinde komut ve mesajlara otomatik yanıt veren, bir sunucudaki yazılıma Bot API ile bağlanan özel bir hesaptır. Bu rehberde nasıl çalıştığını, BotFather ile nasıl kurulduğunu, webhook ile getUpdates farkını, mesaj gönderim sınırlarını ve işletmeler için kullanım örneklerini anlatıyoruz.
Bilgiler Telegram'ın geliştirici sitesi core.telegram.org'dan alındı; okuma tarihi 2026-11-14. Sınırlar ve özellikler değişebildiği için kuruluma başlamadan önce güncel belgelere bakın.
Telegram bot nedir?
Telegram'ın bot sayfasına göre botlar, kurulumu için telefon numarası gerekmeyen özel hesaplardır. Bot, kullanıcıdan gelen mesajı Telegram sunucuları üzerinden sizin yazılımınıza iletir; yazılımınız yanıtı yine Telegram üzerinden gönderir. Aynı sayfaya göre Telegram bot platformu kullanıcılar ve geliştiriciler için ücretsizdir.
Önemli bir sınır var: Telegram'a göre botlar kullanıcıyla sohbet başlatamaz. Kullanıcının bota önce mesaj göndermesi ya da botu bir gruba eklemesi gerekir. Bu kural, istenmeyen mesajı engellediği için işletme kullanımında da belirleyicidir.
Telegram bot ne işe yarar?
Aşağıdakiler bir Telegram bot için genel senaryolardır; her işletmenin ihtiyacı farklıdır.
- Bildirim: Yeni sipariş, düşen stok ya da sunucu hatası gibi olayları ekibin Telegram grubuna iletmek.
- Müşteri sorusu: Sık sorulan sorulara ve sipariş durumuna otomatik yanıt vermek.
- Kanal ve grup yönetimi: Duyuru paylaşmak, yeni üyeyi karşılamak, kuralları hatırlatmak.
- İç araç: Saha ekibinin fotoğraf, konum ya da form verisini bir komutla sisteme göndermesi.
- Yapay zekâ asistanı: Bir dil modeline bağlanıp belirli bir bilgi tabanından yanıt üretmek.
Bot özellikleri belgesine göre kullanıcılar bota metin, dosya, konum ve sesli mesaj gibi her türden içerik gönderebilir; botlar komut listesi, menü düğmesi ve satır içi klavyelerle etkileşim sunabilir.
Telegram bot nasıl yapılır?
Telegram'ın belgesine göre başlamak için @BotFather'a yazılır, bot kaydedilir ve bir erişim anahtarı (token) alınır. Bot hesabı tek başına bir şey yapmaz; asıl işi, bu anahtarla Bot API'ye bağlanan sunucu tarafındaki yazılım yapar. Bot API, Telegram'ın tanımıyla bot geliştirmek isteyenler için hazırlanmış HTTP tabanlı bir arayüzdür.
Telegram bot nasıl yapılır? 5 adım
Adımlar Telegram'ın bot belgelerine göre genel bir sıradır.
BotFather ile botu oluşturun
Telegram'da @BotFather'a yazın, botunuzu kaydedin ve erişim anahtarını (token) alın. Anahtarı kimseyle paylaşmayın.
Komutları ve açıklamayı tanımlayın
Botun adını, açıklamasını ve kullanıcıya önerilecek komut listesini BotFather üzerinden ayarlayın.
Sunucu tarafını yazın
Bot API'ye HTTP istekleri gönderen ve gelen güncellemeleri işleyen yazılımı geliştirin.
Güncelleme yöntemini seçin
Geliştirmede getUpdates, canlıda genellikle HTTPS webhook kullanın; ikisi aynı anda çalışmaz.
Sınırlara göre test edin
Toplu bildirimlerde Telegram'ın mesaj gönderim sınırlarını aşmayacak bir kuyruk kurun ve test edin.
Telegram bot webhook mu, getUpdates mi?
Bot API belgesine göre bir botun güncellemeleri almasının birbirini dışlayan iki yolu vardır: getUpdates yöntemi ve webhook. getUpdates'te sunucunuz Telegram'a sürekli sorar (long polling); webhook'ta Telegram yeni güncellemeyi sizin adresinize gönderir. Bot SSS sayfasına göre getUpdates, onaylanmamış en eski 100 güncellemeyi döndürür; işlenen güncellemeler offset parametresiyle onaylanır.
Telegram bot güncelleme yöntemleri: getUpdates ve webhook
Telegram Bot API belgesinden özet (okundu 2026-11-14).
| Ölçüt | getUpdates (long polling) | Webhook |
|---|---|---|
| Nasıl çalışır? | Sunucunuz Telegram'a düzenli istek atıp yeni güncellemeleri sorar | Telegram yeni güncellemeyi sizin HTTPS adresinize gönderir |
| Kurulum | Herkese açık adres gerekmez | Herkese açık HTTPS adresi gerekir |
| Ne zaman uygun? | Geliştirme ve küçük botlar | Canlı ve yoğun botlar |
| Birlikte kullanım | Webhook açıkken kullanılamaz | getUpdates ile birlikte kullanılamaz |
"Ne zaman uygun?" satırı bizim değerlendirmemizdir. Telegram'a göre iki yöntem birbirini dışlar.
Telegram bot mesaj gönderim sınırları
Telegram'ın SSS sayfasına göre botlar kullanıcılarına ücretsiz mesaj gönderebilir, ama belirli aralıklarda gönderebilecekleri mesaj sayısı sınırlıdır: Tek bir sohbette saniyede birden fazla mesaj gönderilmemesi önerilir. Bir grupta bot dakikada 20'den fazla mesaj gönderemez. Toplu bildirimlerde sınır yaklaşık saniyede 30 mesajdır; ücretli yayın (paid broadcast) açılırsa bu sınır saniyede 1.000 mesaja kadar çıkabilir.
Sınır aşıldığında Telegram 429 hatası döndürür. Bu yüzden duyuru ya da kampanya gönderecek bir Telegram bot, mesajları bir kuyruğa alıp sınırlara uygun hızda göndermelidir.
Telegram bot yayın öncesi kontrol listesi
Botu canlıya almadan önce bu maddeleri kontrol edin.
- Token yalnızca sunucuda, ortam değişkeninde saklanıyor
- Webhook adresi HTTPS ve doğrulanmış
- Bot yalnızca kullanıcı başlattıktan sonra mesaj gönderiyor
- Toplu gönderimde hız sınırına uygun kuyruk var
- Hata ve zaman aşımı durumları kayda geçiyor
- Kişisel veri için aydınlatma metni hazır
- Komut listesi ve yardım mesajı tanımlı
Telegram bot kurarken sık yapılan hatalar
- Token'ı kodun içine yazmak: Anahtar sızarsa bot başkasının kontrolüne geçebilir.
- İki güncelleme yöntemini birlikte denemek: Webhook açıkken getUpdates çalışmaz.
- Sınırları hesaba katmamak: Toplu gönderim kuyruksuz yapılırsa 429 hataları başlar.
- Kullanıcıya ilk mesajı atmaya çalışmak: Bot, kullanıcı başlatmadan sohbet açamaz.
- Kişisel veriyi düşünmemek: Botun topladığı ad ve telefon gibi bilgiler için KVKK yükümlülükleri geçerlidir.
Duman Dijital önerimiz: Telegram botunu önce ekip içi bildirim gibi dar bir işle başlatın, canlıda HTTPS webhook kullanın ve toplu gönderimler için baştan bir kuyruk kurun. Gerekçemiz: Telegram'ın belgesine göre iki güncelleme yöntemi birbirini dışlıyor ve grup ile toplu gönderimde açık hız sınırları var; bu kurallara göre tasarlanmayan bot büyüdükçe hata vermeye başlar.
Telegram, WhatsApp ve Instagram botlarını CRM, sipariş ya da stok sisteminize bağlı olarak geliştiriyoruz. Yaklaşımımızı otomasyon ve bot yazılımı ile yapay zekâ entegrasyonu sayfalarımızda anlattık. Diğer kanallar için WhatsApp Business API ve Instagram bot rehberlerimize, genel kavramlar için chatbot nedir yazımıza bakabilirsiniz.
Kaynaklar
- Telegram: Bots: An introduction, Bot API referansı, Bots FAQ, Telegram Bot Features (okundu 2026-11-14).
Sıkça sorulan sorular
Telegram bot ücretli mi?
Telegram'a göre bot platformu kullanıcılar ve geliştiriciler için ücretsizdir. Botun çalıştığı sunucu ve geliştirme ise ayrı bir maliyettir.
Telegram bot nasıl oluşturulur?
Telegram'da @BotFather'a yazılır, bot kaydedilir ve erişim anahtarı alınır. Ardından bu anahtarla Bot API'ye bağlanan sunucu yazılımı geliştirilir.
Telegram bot kullanıcıya ilk mesajı atabilir mi?
Hayır. Telegram'a göre kullanıcının bota önce mesaj göndermesi ya da botu bir gruba eklemesi gerekir.
Telegram bot için telefon numarası gerekir mi?
Hayır. Telegram'ın belgesine göre botlar telefon numarası gerektirmeyen özel hesaplardır.
Telegram bot kaç mesaj gönderebilir?
Telegram'ın SSS sayfasına göre tek sohbette saniyede birden fazla mesaj önerilmez, grupta dakikada 20 mesaj sınırı vardır, toplu bildirimde sınır yaklaşık saniyede 30 mesajdır.
Telegram bot mu, WhatsApp bot mu?
Müşterilerinizin ve ekibinizin hangi kanalı kullandığına göre seçin. İki kanalın kuralları farklıdır, ama ikisi aynı arka uç sistemiyle yönetilebilir.
İlgili hizmetler
Otomasyon ve Bot Yazılımı: İş Akışı Otomasyonu ve WhatsApp Botu
Otomasyon ile ekibinizin her gün tekrarladığı ekran işlerini, sistemler arası veri taşımayı ve raporlamayı yazılıma devrediyoruz. Önce API ile, gerekmedikçe bot ile değil.
İnceleyinYapay Zeka Entegrasyonu
Yapay zeka entegrasyonu ile dil modellerini ve tahminleme modellerini mevcut iş akışlarınıza bağlıyoruz. Amacımız gösterişli bir demo değil, ekibinizin her gün kullandığı ve ölçülebilen bir iyileşme.
İnceleyin