BotFather ile Telegram Botu Oluşturma Rehberi
Telegram botları, mesajlaşma platformunda otomasyon, bilgi sağlama ve etkileşimli hizmetler sunmanın en etkili yollarından biridir. Bir bot oluşturmanın ilk ve en kritik adımı, resmî bot yöneticisi olan BotFather'ı kullanarak botunuzu kaydettirmek ve API token'ını almaktır. Bu makale, bota yeni başlayanlardan deneyimli geliştiricilere kadar herkese hitap edecek şekilde, BotFather'ın tüm özelliklerini, bot oluşturma sürecini, karşılaşılabilecek yaygın sorunları ve en iyi uygulamaları kapsamlı bir şekilde ele almaktadır.
BotFather Nedir ve Neden Kullanılır?
BotFather, Telegram'ın resmî bot yönetim botudur. Kullanıcıların yeni botlar oluşturmasına, mevcut botların özelliklerini değiştirmesine, botlarını silmesine ve API anahtarlarını yönetmesine olanak tanır. BotFather olmadan Telegram üzerinde bir bot oluşturmak mümkün değildir; çünkü her botun sisteme kaydedilmesi ve benzersiz bir token alması gerekir. Token, botunuzun kimliğidir; yetkisiz erişimi önlemek için gizli tutulması hayati önem taşır.
BotFather'ı kullanmak için Telegram hesabınızla @BotFather kullanıcı adına mesaj göndermeniz yeterlidir. BotFather, sohbet arayüzü üzerinden komutlarla yönlendirilir. Bu yaklaşım, herhangi bir kodlama bilgisi gerektirmez; bot oluşturma süreci tamamen grafiksel olmayan bir metin menüsü üzerinden ilerler.
Bot Oluşturma Adımları
1. BotFather ile Sohbet Başlatma
Telegram uygulamanızda (Android, iOS veya masaüstü) arama çubuğuna @BotFather yazın ve resmî botu bulun. Genellikle mavi tik işaretiyle doğrulandığını görebilirsiniz. Sohbet penceresini açın ve /start komutunu gönderin. BotFather size bir karşılama mesajı ve kullanılabilir komutların bir listesini gösterecektir.
2. Yeni Bot Oluşturma: /newbot
/newbot komutunu gönderin. BotFather sizden iki bilgi isteyecektir:
- Botun görünen adı: Kullanıcıların sohbet listesinde göreceği isim (örneğin: Hava Durumu Asistanı).
- Bot kullanıcı adı:
botile biten benzersiz bir kullanıcı adı (örneğin:HavaDurumuAsistaniBot). Kullanıcı adı daha önce alınmamış olmalıdır.
Başarılı olursa BotFather size bir API token gönderecektir. Bu token'ı güvenli bir yerde saklayın. Token, botunuza HTTP istekleri yaparken kimlik doğrulaması için kullanılır. Token'ı kimseyle paylaşmayın; aksi takdirde botunuz üzerinde kontrol kaybedebilirsiniz.
Önemli Uyarı: Token'ı kaybederseniz veya sızdırılırsa, /token komutuyla yeni bir token alabilirsiniz. Eski token otomatik olarak geçersiz kılınır.
3. Bot Özelliklerini Yapılandırma
BotFather, botunuzu daha kullanışlı hâle getirmek için çeşitli yapılandırma komutları sunar:
/setdescription– Botunuzun ne yaptığını kısaca açıklayan bir metin belirler (maksimum 512 karakter)./setabouttext– Botun profil sayfasında görünen kısa açıklama (maksimum 120 karakter)./setuserpic– Botunuz için bir profil fotoğrafı yükler. Önerilen boyut 512×512 piksel, JPEG veya PNG formatı./setcommands– Botunuza özel komut listesi tanımlar. Kullanıcılar/yazdığında bu komutlar öneri olarak görünür./setinline– Inline modu etkinleştirir. Kullanıcıların başka sohbetlerde botunuzu@botkullaniciadiile çağırarak sonuç almasını sağlar./setprivacy– Gizlilik modunu açar/kapatır. Açıkken bot yalnızca kendisine gönderilen mesajları görür; gruptaki diğer mesajları göremez.
4. Botu Canlıya Alma ve Test Etme
BotFather'dan token aldıktan sonra, botunuz teknik olarak aktiftir. Ancak, kod yazmadan botunuzun çalıştığını görmek isterseniz /start mesajına yanıt veren basit bir Python betiği yazabilir veya üçüncü taraf bir bot barındırma platformu kullanabilirsiniz. Telegram'ın resmî bot API'si HTTPS üzerinden çalışır; botunuzun sürekli olarak güncellemeleri alması için bir webhook veya long polling yöntemi kullanması gerekir.
İpucu: Geliştirme aşamasında ngrok gibi bir araç kullanarak yerel sunucunuzu geçici bir HTTPS URL'si ile internete açabilir ve webhook'u test edebilirsiniz.
Sık Karşılaşılan Sorunlar ve Çözümleri
| Sorun | Olası Neden | Çözüm |
|---|---|---|
| Token çalışmıyor | Yanlış kopyalanmış veya sıfırlanmış token | /token ile yeni token alın, doğru kopyalayın. |
| Bot mesajlara yanıt vermiyor | Sunucu kapalı veya webhook hatalı | Sunucu çalışıyor mu kontrol edin; webhook URL'sini https://api.telegram.org/botTOKEN/setWebhook ile doğrulayın. |
| Grup sohbetlerinde bot çalışmıyor | Gizlilik modu açık ve bot gruptaki tüm mesajları görmüyor | /setprivacy ile gizliliği kapatın veya botu gruba yönetici olarak ekleyin. |
En İyi Uygulamalar ve Güvenlik İpuçları
- Token'ı asla açık kaynak koduna veya istemci tarafına koymayın. Ortam değişkenleri veya güvenli bir yapılandırma dosyası kullanın.
- Webhook URL'si HTTPS olmalıdır. Telegram, yalnızca güvenli bağlantıları kabul eder. Kendi kendine imzalı sertifikalar da desteklenir, ancak genel CA'lar tercih edilir.
- Botunuzu gereksiz yetkilerle donatmayın. Örneğin, bir botun yalnızca mesaj göndermesi gerekiyorsa, mesaj silme izni vermeyin.
- Kullanıcı girdilerini her zaman doğrulayın. Botunuz kötü niyetli komutlara maruz kalabilir; tüm girdileri temizleyin.
- Rate limiting'e dikkat edin. Telegram, bot API'si için dakikada 30 mesaj sınırı uygular; bu sınırı aşmamak için istekleri uygun şekilde aralıklayın.
BotFather ile Otomasyon ve Gelişmiş Özellikler
BotFather, temel bot oluşturmanın ötesinde, botunuzun yeteneklerini genişletmek için çeşitli seçenekler sunar. Örneğin, /mybots komutuyla mevcut botlarınızın bir listesini görebilir ve her birinin ayarlarına erişebilirsiniz. Buradan botunuzun adını, açıklamasını, profil fotoğrafını ve komut listesini güncelleyebilirsiniz. Ayrıca, botunuzu bir kanala veya gruba yönetici olarak eklemek için gerekli izinleri ayarlayabilirsiniz.
Inline mod, botunuzu daha da kullanışlı hâle getirir. Örneğin, bir çeviri botu oluşturduysanız, kullanıcılar herhangi bir sohbette @ceviribotu İngilizce bu metni çevir yazarak doğrudan çeviri alabilir. Inline modu etkinleştirmek için /setinline komutunu kullanın ve ardından inline sorguları işleyecek kod yazın. Bu özellik, botunuzun görünürlüğünü ve kullanım sıklığını önemli ölçüde artırabilir.
Uygulanabilir ve Uygulanamaz Senaryolar
BotFather ile bot oluşturmak, birçok senaryo için uygundur, ancak her ihtiyaç için ideal değildir. Aşağıdaki tablo, tipik kullanım durumlarını özetlemektedir:
| Senaryo | Uygun mu? | Açıklama |
|---|---|---|
| Müşteri destek botu | Evet | Sık sorulan soruları yanıtlamak, bilet oluşturmak için idealdir. |
| Oyun botu | Evet | Basit metin tabanlı oyunlar veya çok oyunculu deneyimler için kullanılabilir. |
| Büyük ölçekli spam tespiti | Kısmen | Telegram'ın rate limitleri ve grup mesajlarına erişim kısıtlamaları nedeniyle sınırlı kalabilir. |
| Finansal işlem botu | Hayır | Güvenlik ve düzenleme gereksinimleri Telegram botları için uygun değildir; özel bir uygulama önerilir. |
Sonuç
BotFather, Telegram botu oluşturma sürecini basit ve erişilebilir hâle getirir. Birkaç dakika içinde bir bot kaydedebilir, temel özelliklerini yapılandırabilir ve API token'ınızı alabilirsiniz. Ancak botunuzu gerçekten kullanışlı kılmak, kodlama becerilerinize ve botunuzun amacına bağlıdır. Token güvenliğine dikkat ederek, rate limitleri hesaba katarak ve kullanıcı deneyimini ön planda tutarak başarılı bir Telegram botu geliştirebilirsiniz. Şimdi, BotFather ile sohbet başlatın ve ilk botunuzu oluşturmanın keyfini çıkarın.
Sıkça Sorulan Sorular
BotFather'ı kullanmak ücretsiz mi?
Evet, BotFather tamamen ücretsizdir. Telegram bot API'sini kullanmak için herhangi bir ücret ödemeniz gerekmez. Ancak botunuzu barındırmak için bir sunucuya ihtiyacınız varsa, bu bir maliyet doğurabilir.
Bir bot oluşturmak için kod bilmem gerekir mi?
BotFather ile bot oluşturmak için kod bilmenize gerek yoktur. Ancak botunuzun çalışması için bir sunucuda çalışacak bir kod yazmanız gerekir. Alternatif olarak, üçüncü taraf bot barındırma hizmetlerini kullanabilirsiniz.
BotFather token'ımı kaybettim, ne yapmalıyım?
BotFather ile sohbet edin ve /token komutunu kullanarak botlarınızın listesini görüntüleyin. Ardından token'ını sıfırlamak istediğiniz botu seçin. Yeni token eskiyi geçersiz kılacaktır.
Botum neden grup sohbetlerinde mesajları görmüyor?
Bu durum büyük olasılıkla gizlilik modunun etkin olmasından kaynaklanır. /setprivacy komutuyla gizliliği kapatın veya botu grup yöneticisi yapın. Gizlilik modu kapalıyken bot, gruptaki tüm mesajları görebilir.
Bir botun token'ını değiştirmek eski botu etkiler mi?
Evet, yeni bir token aldığınızda eski token geçersiz olur. Bu nedenle token sızdırıldıysa hemen değiştirmelisiniz. Eski token'ı kullanan tüm bağlantılar çalışmayı durdurur.
📺 Related Video Tutorial
TELEGRAM BOT YAPIMI : TÜRKÇE BOT YAPMA : TELEGRAM BOT KURMA