Telegram Bot Komut Menüsü ve Başlangıç Bağlantısı Nasıl Kurulur?

Telegram bot komut menüsü nasıl kurulmalı?

Telegram bot komut menüsü, kullanıcının hangi işlemleri yapabileceğini keşfetmesini sağlayan bir giriş noktasıdır. Sağlıklı kurulum için komutları gerçek kullanıcı görevleriyle eşleştirin, menü listesini Bot API üzerinden tanımlayın, gelen komutu sunucuda doğrulayın ve başlangıç bağlantılarını ayrı test edin. Menüde görünmek, bir işlemi yapmaya yetkili olmakla aynı şey değildir.

Bu rehber, işletme botlarında komut keşfi ve başlangıç akışını uygulamak isteyen ekipler içindir. Mesaj teslimi, webhook tekrarları veya başka bir platformdaki temsilci devrinden farklı bir konuyu ele alır. Buradaki teslim çıktısı; komut listesi, başlangıç parametresi kuralları, sunucu kontrolleri ve kabul testleridir. Kullanıcıyı uzun bir açıklama duvarında bırakmak yerine ne yapabileceğini açıkça gösteren bir arayüz planlanır.

Önce görevleri komutlara dönüştürün

Botun yapacağı işi tanımlamadan komut adları seçmeyin. Bilgi görüntüleme, talep oluşturma ve yardım isteme farklı görevlerdir. Her komut için girdiyi, beklenen sonucu ve işlemin tamamlanamadığı durumu yazın. Kullanıcının komut adını bilmeden de işlevini anlayabileceği kısa bir açıklama hazırlayın. Teknik ekip içinde anlamlı olan bir kısaltma, müşterinin ne yapacağını açıklamayabilir.

Varsayımsal bir destek botunda yardım, talep oluşturma ve talep durumunu öğrenme akışları ayrı komutlarla sunulabilir. Bu örnek, her işletmenin aynı menüyü kullanması gerektiği anlamına gelmez. Sadece gerçekten çalışan işlevleri menüye koyun. Henüz geliştirilmemiş bir özelliği kullanılabilir gibi göstermek, kullanıcının yanlış beklentiyle işlem başlatmasına neden olabilir.

Komut listesini API ile tanımlayın

Telegram'ın güncel Bot API belgesindeki setMyCommands yöntemi, botun komut listesini değiştirmek için kullanılır. Uygulama kapsamı içinde hangi komutların yayımlanacağı ve açıklamaların hangi dillerde hazırlanacağı belirlenmelidir. Kullanılan istemci kütüphanesinin bu yöntemi nasıl çağırdığı, güncel resmî belgeyle karşılaştırılmalıdır. Bir kod örneğinin çalışması bütün menü koşullarının doğru olduğunu göstermez.

Menü yapılandırmasını sürüm kaydının parçası yapın. Komut ekleme, ad değiştirme ve kaldırma kararları uygulama kodundaki karşılıklarla birlikte yayımlansın. Listeyi değiştirip sunucudaki işleyiciyi unutmak, kullanıcıya işlevsiz bir seçenek gösterebilir. Tersine yalnızca kodu değiştirmek de menüde eski işlemlerin kalmasına yol açabilir. Kabul testi iki tarafın tutarlılığını kontrol etmelidir.

Menü kapsamını erişim yetkisi sanmayın

Telegram'ın bot özellikleri belgesi, gelen güncellemelerde komut kapsamının belirtilmediğini ve botunuzda bulunmayan komutların da gelebileceğini açıklar. Bu nedenle menüde gizlediğiniz bir komutun sunucuya hiç ulaşmayacağını varsaymayın. Kullanıcı komutu elle yazabilir; alıcı kod her isteği kendi kurallarıyla değerlendirmelidir.

Sunucuda tanınmayan komuta anlaşılır bir yardım yanıtı verin. Tanınan fakat yetkisiz işlemde ise güvenli bir ret veya uygun doğrulama adımı uygulayın. Menü listesinin kullanıcıya göre değişmesi, hassas veri kontrolünün yerini tutmaz. Hesap bilgisi döndüren işlemlerde mevcut uygulamanızın erişim modelini kullanın; sırf bir mesaj geldiği için başka bir kişinin kaydını göstermeyin.

Başlangıç bağlantısını ayrı bir giriş yolu olarak tasarlayın

Telegram özellik belgesi, deep linking ile bot başlatılırken ek parametre geçirilebildiğini anlatır. Bu mekanizma, kullanıcının hangi yardım akışından geldiğini veya hangi başlangıç seçeneğini istediğini belirlemek için değerlendirilebilir. Parametrenin ne anlama geldiğini kendi uygulamanızda açıkça tanımlayın. Her bağlantıyı doğrudan hassas bir işlem başlatan kısa yol haline getirmeyin.

Örneğin bir web sayfasındaki destek bağlantısının botu belirli bir genel yardım akışına yönlendirmesi planlanabilir. Kullanıcı bağlantıyı açtığında bağlamı anlatan kısa bir mesaj ve devam seçeneği sunmak yararlı olabilir. Bu bir tasarım önerisidir; kullanıcıyla konuşmadan her işlemin otomatik tamamlanacağını göstermez. İlk temasın hangi noktada kullanıcı onayı gerektirdiğini ayrıca kararlaştırın.

Başlangıç parametresini güvenilir kullanıcı girdisi saymayın. Beklenen değerleri doğrulayın, bilinmeyen değerleri güvenli genel başlangıca yönlendirin ve gizli anahtarları bağlantının içine koymayın. Parametre bir hesap bağlantısı amacıyla kullanılacaksa bunun doğrulama tasarımını ayrıca inceleyin. Genel yönlendirme bağlamıyla hesap sahipliği kanıtını birbirine karıştırmayın.

Durum ve vazgeçme akışını açık tutun

Komut birden fazla adım başlatıyorsa botun hangi bilgiyi beklediği kullanıcıya anlatılmalıdır. Kullanıcı yeni komut verdiğinde önceki akışın devam mı edeceği, duracağı mı yoksa onay isteyeceği mi belirlenmelidir. Eksik durum yönetimi, bir akış için gönderilen metnin başka bir işleme aktarılmasına yol açabilir. Bu olasılığı test senaryosu olarak ele alın.

Vazgeçme ve yardıma dönme yollarını görünür tutun. Süreci yarıda bırakan kullanıcı daha sonra geri geldiğinde botun kaldığı adımı anlaşılır biçimde açıklamasını planlayın. Eski veya artık geçersiz bir başlangıç bağlamı varsa yeni seçim isteyin. Kullanıcıyı anlamadığı bir adımda döndürmek yerine, güvenli bir yeniden başlama yolu sunun.

Komut, bağlantı ve dil testlerini birlikte çalıştırın

Testi menüde görünen seçeneklere dokunmakla sınırlamayın. Aynı komutu elle gönderin, bilinmeyen bir komut deneyin ve farklı başlangıç parametrelerini kontrol edin. Kullanıcının dili için hazırlanmış açıklama ile çalıştırılan işlevin aynı olduğunu doğrulayın. Grup ve özel sohbet kullanımı kapsamdaysa ayrı senaryolar oluşturun; bir ortamda alınan sonucu diğerine otomatik taşımayın.

Kabul listesinde şu durumlar bulunabilir:

• Menüdeki her seçenek doğru işleyiciye ulaşıyor mu?
• Elle yazılan yetkisiz komut güvenli biçimde reddediliyor mu?
• Bilinmeyen komut yardım yolunu açıklıyor mu?
• Başlangıç bağlantısındaki geçersiz parametre hata yerine güvenli akışa gidiyor mu?
• Yeni komut, önceki sürecin verisini yanlış kullanıyor mu?
• Vazgeçen kullanıcı yeniden başlayabiliyor mu?

Hataları kullanıcı göreviyle ilişkilendirerek kaydedin. Komut adı, başlangıç bağlamı, beklenen sonuç ve gözlenen davranış yeterli bir test kaydı oluşturabilir. Kayıtlara gereksiz kişisel veri veya bot anahtarı eklemeyin. Düzeltme sonrasında aynı senaryoyu tekrar çalıştırın; menünün güncel sürümde yayımlandığını da kontrol edin.

İşletme botu için kapsamı netleştirin

Webinle'nin bot yazılımları ve entegrasyon hizmeti üzerinden kullanıcı görevlerini, komut menüsünü ve bağlı sistemlere erişim sınırlarını birlikte değerlendirebilirsiniz. Botun taşıdığı olayların teslim güvenilirliğini ayrıca planlamak için webhook yeniden deneme rehberini inceleyin. Komut arayüzü kullanıcıya doğru kapıyı gösterir; güvenli işleyici ve kabul testleri ise o kapının arkasındaki işlemi doğrular.