Discord Discord Botlarda Slash Command, Button ve Modal Yapısı Nasıl Planlanır?

Discord bot geliştirirken komutları sadece dosyalara bölmek yeterli olmaz; slash command, button, select menu ve modal akışının en baştan planlanması gerekir. Bu rehber, küçük ve orta ölçekli botlarda interaction tabanlı yapıyı daha okunabilir, genişletilebilir ve kullanıcı dostu kurmak için temel bir çerçeve sunar.

Interaction mantığı nedir?​

Discord tarafında slash command çalıştırmak, bir butona basmak, dropdown seçmek veya modal göndermek aynı ana fikre dayanır: Kullanıcı bir etkileşim başlatır, uygulama da buna uygun bir yanıt döner. Bu yüzden modern botlarda komut sistemi ile arayüz bileşenlerini ayrı dünyalar gibi değil, aynı akışın parçaları gibi düşünmek daha sağlıklıdır.

Hangi durumda hangi yapı kullanılmalı?​

• Slash command: Kullanıcının doğrudan bir işlem başlatacağı durumlar için uygundur. Örneğin ban, profil, kayıt, yardım veya ayar komutları.
• Button: Mesaj üzerindeki kısa ve net aksiyonlarda kullanılır. Onayla, iptal et, sayfa değiştir, rol al gibi işlemler buna örnektir.
• Select menu: Kullanıcının birkaç seçenek arasından tercih yapması gerektiğinde daha temiz görünür.
• Modal: Kullanıcıdan metin girişi almak için uygundur. Başvuru formu, destek talebi, sebep yazma veya uzun açıklama isteyen işlemlerde kullanılır.

Komut tasarımında önerilen ayrım​

Küçük botlarda bile her şeyi tek dosyada toplamak ileride bakım zorluğu çıkarır. Daha net bir yapı için komutun amacı, interaction yanıtı ve yardımcı servisler ayrı tutulabilir.


Bu yapı zorunlu bir standart değil, okunabilirlik için pratik bir ayrımdır. Önemli olan buton, modal ve select işlemlerinin rastgele dosyalara dağılmaması ve hangi interaction'ın hangi komut akışına bağlı olduğunun anlaşılır kalmasıdır.

Yetki ve hata mesajı planı​

Interaction akışında en çok yapılan hatalardan biri, sadece başarılı senaryoyu düşünmektir. Oysa kullanıcı yetkisiz olabilir, modal süresi dolabilir, botun rolü yetersiz kalabilir veya komut sadece belirli kanalda çalışmalıdır.

• Yetki kontrolünü komutun en başında yapın.
• Kullanıcıya gösterilecek hata mesajını kısa ve anlaşılır yazın.
• Gereksiz herkese açık hata mesajı yerine uygun yerlerde ephemeral yanıt kullanın.
• Log kanalına geliştirici için daha teknik bilgi gönderebilirsiniz.

Basit planlama örneği​

Discord bot mimarisinde amaç sadece komutun çalışması değil, kullanıcı etkileşiminin tahmin edilebilir olmasıdır. Slash command ana giriş noktası, button ve select menu hızlı seçim alanı, modal ise veri toplama aracı olarak düşünülürse proje büyüdükçe kontrol daha kolay kalır.