Telegram botu oluşturmak için hangi adımları izlemeliyim?

Telegram Botu Oluşturmak İçin Başlangıç Rehberi

Telegram botu oluşturmak için izlenmesi gereken adımlar, BotFather ile temel yapılandırmadan Python tabanlı bir bot geliştirmeye kadar uzanır. Bu rehberde, resmi Telegram Bot API'sini kullanarak sıfırdan nasıl bot oluşturulacağını, komutların nasıl ayarlanacağını ve botunuzu nasıl canlıya alacağınızı adım adım açıklıyoruz. Ayrıca her adımın gerekçesini, olası hataları ve en iyi uygulamaları da bulacaksınız.

Adım 1: BotFather ile Bot Oluşturma ve Token Alma

Telegram'da bot oluşturmanın ilk adımı, resmi BotFather botunu kullanmaktır. BotFather, tüm botların yöneticisidir ve size botunuz için benzersiz bir token (API anahtarı) verir. Bu token, botunuzun Telegram sunucularıyla iletişim kurmasını sağlar ve gizli tutulmalıdır.

İşlem Adımları

1. Telegram uygulamasında arama çubuğuna @BotFather yazın ve ilk sonuca tıklayın.
2. BotFather ile sohbet başlatın ve /newbot komutunu gönderin.
3. BotFather size botunuz için bir ad (örneğin Hava Durumu Botu) soracak. Bu ad, kullanıcıların botu listelerde göreceği isimdir.
4. Ardından bir kullanıcı adı isteyecek. Kullanıcı adı _bot ile bitmeli ve benzersiz olmalıdır. Örneğin HavaDurumuBot.
5. Başarılı olursa BotFather size şu formatta bir mesaj döndürür:

Done! Congratulations on your new bot.
You will find it at t.me/HavaDurumuBot.
Use this token to access the HTTP API:
1234567890:ABCdefGHIjklmNOPqrstUVwxyz

Token'ı güvenli bir yere kaydedin. Bu token, botunuzun kimliğidir ve herhangi biriyle paylaşılırsa botunuz kötüye kullanılabilir. Özellikle token'ı asla GitHub gibi herkese açık depolara eklemeyin.

Adım 2: Komut Ayarlarını Yapılandırma

BotFather ile botunuzun varsayılan komutlarını ayarlayabilirsiniz. Kullanıcılar sohbette / yazdığında bu komutlar öneri olarak görünür. Komut listesi, botunuzun kullanıcı deneyimini doğrudan etkilediği için dikkatlice seçilmelidir.

Komut Ekleme Adımları

1. BotFather ile sohbeti açın ve /setcommands komutunu gönderin.
2. BotFather, hangi bot için komut ayarlayacağınızı sorar. Botunuzu listeden seçin veya kullanıcı adını yazın.
3. Sonra aşağıdaki formatta komut listesini gönderin:

start - Botu başlat
help - Yardım menüsü
hava - Güncel hava durumu
ayarlar - Kullanıcı ayarları

Her satırda komut adı (alt çizgi ile başlar, küçük harf) ve kısa bir açıklama bulunur. Açıklamalar 256 karakteri geçmemelidir.

Adım 3: Botunuzu Kodlama (Python Örneği)

Botunuzu canlıya almak için bir programlama dili ve Telegram Bot API'sini kullanan bir kütüphane gerekir. Python için en yaygın kütüphane python-telegram-bot'tur. Bu bölümde, token ile bot oluşturma ve temel komutları işleme adımlarını göstereceğiz.

Kurulum

Öncelikle Python 3.7 veya üzeri bir sürüm yükleyin. Ardından terminal/powershell'de aşağıdaki komutu çalıştırın:

pip install python-telegram-bot --upgrade

Bu komut, en son kararlı sürümü yükler. Bu yazı yazılırken en son sürüm, resmi PyPI sayfasından kontrol edilebilir.

Basit Bir Bot Kod Örneği

import os
from telegram import Update
from telegram.ext import Application, CommandHandler, ContextTypes

TOKEN = os.environ.get("BOT_TOKEN")  # Token'ı çevre değişkeninden al

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("Merhaba! Ben Telegram botuyum. /help yazarak komutları görebilirsiniz.")

async def help_command(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("Mevcut komutlar: /start, /help, /hava, /ayarlar")

def main():
    app = Application.builder().token(TOKEN).build()
    app.add_handler(CommandHandler("start", start))
    app.add_handler(CommandHandler("help", help_command))
    print("Bot çalışıyor...")
    app.run_polling()

if __name__ == "__main__":
    main()

Bu kod, /start ve /help komutlarına yanıt veren basit bir bot oluşturur. Token'ı güvenli şekilde almak için os.environ.get kullanılmıştır.

Adım 4: Botu Canlıya Alma

Kodunuzu yazdıktan sonra botu çalıştırmak için script'i başlatmanız yeterlidir. Ancak botunuzun sürekli çalışması için bir barındırma (hosting) çözümüne ihtiyacınız olacak. İşte yaygın seçenekler:

Seçenek A: Kendi Sunucunuz (VPS)

Bir Linux VPS (DigitalOcean, Linode, AWS EC2 vb.) kiralayın. Python ve gerekli kütüphaneleri yükleyin. Bot script'ini nohup python bot.py & veya systemd servisi olarak başlatın.

Seçenek B: Platform Hizmetleri (PaaS)

Heroku (artık ücretsiz katman yoktur, ücretli planlar mevcut), Railway, Render gibi platformlarda botunuzu dağıtabilirsiniz. Genellikle GitHub repo bağlantısı yeterlidir. Uyarı: Ücretsiz katmanlar zaman sınırı veya bellek kısıtlaması getirebilir.

Seçenek C: Webhook Kullanımı

Polling yerine webhook kullanarak botunuzun daha hızlı yanıt vermesini sağlayabilirsiniz. Ancak bu, HTTPS sunucusu ve geçerli bir SSL sertifikası gerektirir. Telegram, 20 Haziran 2023 itibarıyla webhook'larda IPv4 desteğini sonlandırdığını duyurdu; bu nedenle IPv6 üzerinden erişim sağlamalısınız. Güncel bilgi için API dokümanını kontrol edin.

Adım 5: Bot Tanıtımı ve Kullanıcı Kazanma

Botunuz çalışır duruma geldikten sonra kullanıcıların botu bulması için bir tanıtım kanalına ihtiyacınız var. Telegram'da botunuzu tanıtmak için aşağıdaki yöntemleri kullanabilirsiniz:

• Bot profili: BotFather ile /setuserpic komutunu kullanarak botunuza bir profil fotoğrafı ekleyin. /setdescription ile botunuzun kısa bir açıklamasını yazın. /setabouttext ile bot hakkında daha detaylı bilgi verin.
• Kanal ve gruplar: Botunuzu ilgili kanallara veya gruplara ekleyerek potansiyel kullanıcılara ulaşabilirsiniz. Botunuz gruba eklendiğinde /start komutunu göndermesi için bot kodunda ChatMemberHandler kullanabilirsiniz.
• Web sitesi ve sosyal medya: Bot linkinizi (t.me/bot_kullanici_adi) web sitenizde, Twitter, Instagram gibi platformlarda paylaşın.

Bot API Sürüm Evrimi ve Geçiş Süreci

Telegram Bot API'si zamanla önemli değişiklikler geçirdi. Örneğin, API 2.0 sürümü Inline Mode'u tanıttı; 3.0 sürümü ile Payments entegrasyonu geldi; 4.0 sürümünde Polls ve Quiz desteği eklendi. Bu değişiklikler bot geliştiricilerinin yeni özelliklerden yararlanmasını sağladı ancak bazı eski yöntemlerin güncellenmesini gerektirdi.

Önemli Dönüm Noktaları

Eski bir sürümden geçiş yaparken, kullandığınız kütüphanenin (örneğin python-telegram-bot) yeni API değişikliklerini desteklediğinden emin olun. Kütüphane dokümantasyonu ve changelog'u incelemek en sağlıklı yöntemdir.

Bot Güvenliği ve Token Yönetimi

Bot token'ınız, botunuzun kontrolünü tamamen ele geçirebilecek bir anahtardır. Token sızıntısı durumunda kötü niyetli kişiler botunuz üzerinden spam yapabilir, kullanıcı verilerine erişebilir veya botunuzu tamamen devre dışı bırakabilir.

Alınması Gereken Önlemler

• Token asla kod içinde düz metin olarak saklanmamalıdır. Çevre değişkenleri, .env dosyası veya gizli yönetim hizmetleri (AWS Secrets Manager, HashiCorp Vault) kullanın.
• Token'ı .gitignore dosyasına ekleyin ve envanter kontrolü yapın. Geçmiş commit'lerde token varsa git filter-branch veya BFG Repo-Cleaner ile temizleyin.
• BotFather üzerinden token'ı sıfırlayın Eğer token sızdıysa, BotFather ile /revoketoken komutunu kullanarak eski token'ı iptal edin ve yenisini alın.
• İzinleri en aza indirin: Botunuzun ihtiyacı olmayan özellikleri (örneğin, mesaj düzenleme, kanal yönetimi) talep etmeyin. BotFather'dan /setjoingroup gibi komutlarla izinleri kısıtlayabilirsiniz.

Sorun Giderme

Bot geliştirirken karşılaştığınız yaygın sorunlar ve çözümleri aşağıda listelenmiştir.

Belirti: Bot mesajlara yanıt vermiyor

Olası nedenler: Token yanlış, bot çalışmıyor, webhook polling çakışması, internet bağlantısı yok.
Doğrulama: BotFather ile token'ın doğru olup olmadığını kontrol edin. Botunuzun çalıştığını terminal çıktısından teyit edin. curl https://api.telegram.org/bot<TOKEN>/getMe komutuyla token'ın geçerli olup olmadığını test edin. Eğer webhook ayarlıysa, polling ile çalışan botunuz yanıt vermez. /deleteWebhook API'sini çağırarak webhook'u temizleyin.
Çözüm: Webhook kullanıyorsanız, sadece bir yöntem (polling veya webhook) aktif olmalıdır. Polling ile çalışıyorsanız webhook'u sildiğinizden emin olun.

Belirti: Bot belirli komutları tanımıyor

Olası neden: Kodda komut handler'ı eklenmemiş veya CommandHandler yanlış yapılandırılmış.
Doğrulama: BotFather'dan /setcommands ile belirlediğiniz listedeki komutların hepsi için kodda bir handler olmalıdır. Her handler fonksiyonunun doğru async yapısına sahip olduğundan emin olun.
Çözüm: Eksik handler'ları ekleyin veya yazım hatalarını düzeltin. Kütüphane hata mesajlarını dikkatlice okuyun.

Belirti: Bot çok yavaş yanıt veriyor

Olası neden: Polling interval'ı çok kısa (varsayılan 0), sunucu yavaş, API rate limit'i aşılmış.
Doğrulama: app.run_polling(timeout=20) ile timeout değerini artırabilirsiniz. Sunucunuzun ping süresini kontrol edin. Telegram, bot başına saniyede yaklaşık 30 mesaj gönderme limiti uygular (ampirik gözlem).
Çözüm: Polling yerine webhook'a geçin. Botunuzun yoğunluğunu azaltmak için kullanıcı taleplerini kuyruğa alın.

Uygulanabilir ve Uygulanamaz Senaryo Kontrol Listesi

Her bot konsepti her senaryo için uygun değildir. Aşağıdaki kontrol listesi, bot projenize başlamadan önce karar vermenize yardımcı olacaktır.

Bot için uygun senaryolar

• Otomatik yanıt: Sık sorulan sorulara anında cevap vermesi gerekiyorsa (müşteri hizmetleri, sık kullanılan bilgiler).
• Veri toplama ve bildirim: Hava durumu, döviz kuru, RSS beslemesi gibi güncel bilgileri periyodik olarak kullanıcıya iletmesi.
• Kullanıcı etkileşimi: Quiz, anket, oyun gibi etkileşimli içerik sunmak.
• Küçük ekipler için basit görevler: Örneğin, bir ekip için toplantı hatırlatmaları, otomatik check-in mesajları.

Bot için uygun olmayan senaryolar

• Gerçek zamanlı sohbet desteği: Botlar insan benzeri duygusal zeka ve yanıt esnekliği sağlayamaz; canlı müşteri hizmetleri insan desteği gerektirir.
• Karmaşık çok aşamalı işlemler: Örneğin, e-ticaret sipariş yönetimi (ödeme, stok, lojistik) genellikle özel bir web arayüzü ve entegrasyon gerektirir; bot arayüzü kısıtlayıcı olabilir.
• Yüksek güvenlik gereksinimleri: Finansal işlemler veya kişisel veri işleme gibi durumlarda bot güvenlik modeli yetersiz kalabilir; şifrelenmiş bir web uygulaması tercih edilmelidir.
• Geniş kitlelere aynı anda bildirim: Telegram botları tüm kullanıcılara toplu mesaj atamaz (spam koruması). 10.000+ kullanıcıya aynı anda mesaj iletmek için Telegram Broadcast Botları kullanılabilir ancak bunların kullanım sınırları vardır.

Sıkça Sorulan Sorular

En İyi Uygulamalar Kontrol Listesi

• Token güvenliği: Token'ı çevre değişkeni veya gizli yönetim hizmetinde saklayın. Kodda düz metin olarak asla bulunmamalıdır.
• Hata yönetimi: Her handler'da try-except blokları kullanarak hataları yakalayın ve kullanıcıya anlaşılır bir hata mesajı döndürün.
• Loglama: Python logging modülü ile botunuzun aktivitesini kaydedin. Hata ayıklama ve performans izleme için kritik.
• Rate limit uyumu: Botunuzun saniyede 30'dan fazla mesaj göndermemeye özen gösterin. Yoğun durumlarda mesajları kuyruğa alarak bir süre dağıtın.
• Düzenli güncelleme: Kullandığınız kütüphaneyi (python-telegram-bot gibi) düzenli olarak güncelleyin. Eski sürümler güvenlik açıkları taşıyabilir.
• Kullanıcı gizliliği: Topladığınız kullanıcı verilerini (kullanıcı ID, mesaj içeriği) yalnızca botun çalışması için gerekli olduğu sürece saklayın. GDPR gibi yasal düzenlemelere uygun hareket edin.
• Dökümantasyon hazırlayın: Botunuzun komutlarını, kullanım amacını ve veri politikasını açıklayan bir yardım mesajı (/help) her zaman bulunsun.