Discord botunu yapılandırma: Eklemekten izin vermeye kadar

Discord'da bir botu yapılandırmak için, minimum gerekli izinlerle OAuth2 bağlantısı üzerinden sunucuya eklemeniz, listede yüksek önceliğe sahip ayrı bir rol oluşturmanız ve hassas kanallara erişimi kısıtlamanız gerekir. Kilit nokta şudur: Botun rolü, yönetmesi gereken rollerin hiyerarşisinde daha yukarıda olmalıdır, aksi takdirde moderasyon komutları çalışmaz.

Aşağıda, sunucunuzdaki otomasyon entegrasyonu sırasında tipik hatalardan kaçınmanıza yardımcı olacak detaylı bir talimat verilmiştir.

Sunucu hazırlığı ve bot seçimi

Eklemeden önce "Yönetici" veya "Sunucuyu Yönet" haklarına sahip olduğunuzdan emin olun. Rol yapısını hazırlamadan botsal kurulum yapmak genellikle izin çakışmalarına yol açar.

Hazırlık adımları:

1. Görevi belirleyin. Botun neden gerektiğini net bir şekilde anlayın: Moderasyon (spam silme, banlama), müzik, yeni üyeleri karşılama veya YouTube/Twitch entegrasyonu.
2. Hizmet rolü oluşturun. Sunucu Ayarları → Roller bölümüne gidin. Örneğin, Bot Yöneticisi veya OtoMod gibi yeni bir rol oluşturun.
3. Renk ve konumu ayarlayın. Görsel kontrol için role diğerlerinden farklı bir renk atayın. Henüz izinlerini değiştirmeyin, bunu botu ekledikten sonra yapacağız.

OAuth2 ile bot ekleme

Kurulum süreci, hazır bir genel bot (örneğin MEE6, Dyno, Carl-bot) mi yoksa kendi geliştirdiğiniz bir bot mu kullandığınıza bağlıdır.

Genel botlar için

1. Botun resmi web sitesine veya geliştirici hesabınız varsa Discord Geliştirici Portalı sayfasına gidin.
2. Davet Et veya Sunucuya Ekle düğmesini bulun.
3. Açılır listeden sunucunuzu seçin.
4. Önemli aşama — İzinlerin seçilmesi (Permissions). Sistem standart bir set önerecektir. Gereksiz öğelerden tikleri kaldırın.
   • Sohbet botu için minimum set: Mesaj Gönder, Mesaj Geçmişini Oku, Bağlantı Yerleştir.
   • Moderasyon için: Mesajları Yönet, Üyeleri At, Üyeleri Yasakla ekleyin.
   • Rol yönetimi için: Rolleri Yönet (özellikle dikkatli olunmasını gerektirir).
5. Yetkilendirmeyi onaylayın ve captcha'yı geçin.

Kendi botlarınız için

Botu kendiniz geliştiriyorsanız, geliştirici panelinde OAuth2 URL'sini oluşturun:

1. OAuth2 sekmesi → URL Oluşturucu.
2. bot ve applications.commands (slash komutları için) kapsamını seçin.
3. Aşağıda gerekli izinleri işaretleyin.
4. Elde edilen bağlantıyı kopyalayın ve tarayıcıda açın.

Rolleri ve izin hiyerarşisini yapılandırma

Botun çalışmamasının en yaygın nedeni yanlış rol hiyerarşisidir. Discord'da kural şudur: Daha yüksek role sahip varlık, daha düşük role sahip varlıkları yönetebilir.

Önceliği doğru şekilde ayarlama

1. Sunucu Ayarları → Roller bölümünü açın.
2. Bot giriş yaptığında otomatik olarak oluşturduğu rolü bulun (genellikle botun adını taşır).
3. Bu rolü normal kullanıcı rollerinin (@everyone, Üye, VIP) üstüne, ancak ana yönetici rolünün (Sahip veya Baş Yönetici) altına sürükleyin.
4. Bot moderatörlere rol verip alacaksa, botun rolü Moderatör rolünden daha yukarıda olmalıdır.

Rolün belirli izinlerini yapılandırma

Kesinlikle gerekli değilse bota küresel olarak Yönetici rolü vermeyin. Daha önce oluşturulan Bot Yöneticisi rolünün haklarını noktasal olarak ayarlamak daha iyidir:

• Genel izinler: Kanalları Görüntüle, Mesaj Gönder.
• Üyelik: Bağlan (sesli kanallar için), Konuş (bot konuşuyorsa).
• Moderasyon: Üyeleri At, Üyeleri Yasakla, Üyelere Süreli Ceza Ver (rollar üzerinden susturma yerine, çünkü süreli cezalar daha modern ve güvenlidir).
• Metin kanalları: Mesajları Yönet, Tepki Ekle.

Kanal bazında izinlerin ince ayarı

Küresel izinler bota tüm sunucuya erişim sağlar. Güvenlik için eylemlerini belirli kanallarla sınırlayın.

1. Bir metin kanalına sağ tıklayın → Kanalı Düzenle → İzinler.
2. Botun rolünü geçersiz kılmalar listesine ekleyin.
3. Noktasal izinleri yapılandırın:
   • #loglar kanalında Kanalı Görüntüle ve Mesaj Gönder izni verin, ancak Herkesi Etiketleyi yasaklayın.
   • Yönetimin özel kanallarında bota Kanalı Görüntüle iznini yasaklayın, böylece gizli tartışmaları okuyamaz.
   • Müzik için sesli kanallarda Bağlan ve Konuş izni verin, ancak Üyeleri Taşıyı yasaklayın, böylece bot insanları kazayla taşıyamaz.

Farklı bot türleri için önerilen izinler tablosu

Güvenlik ve sık yapılan hatalar

Bot güvenliği, tüm sunucunun güvenliğidir. Yönetici haklarına sahip bir bot token'ının ele geçirilmesi, sunucunun hacklenmesine eşdeğerdir.

Güvenlik kontrol listesi

• Kodda token bulundurmayın. Geliştiriciyseniz, token'ı betik dosyalarında değil, ortam değişkenlerinde (.env) saklayın.
• İki Faktörlü Kimlik Doğrulama (2FA). Sunucudaki tüm yöneticiler için 2FA'yı etkinleştirin. Discord, botun hakları olsa bile kritik eylemler (örneğin kanal silme) için 2FA gerektirir.
• Düzenli denetim. Ayda bir kez bota verilen izinlerin listesini kontrol edin. Kullanılmayan özellikleri devre dışı bırakın.
• Günlük tutma (Loglama). Günlük tutmak için botları kullanın (audit logs). Bot eylemleri ve izin değişiklikleri hakkında mesajların düşeceği ayrı bir kanal ayarlayın.

Yapılandırma sırasında sık yapılan hatalar

1. Bot sessiz kalıyor ve komutlara yanıt vermiyor.

   • Neden: Botun belirli bir kanalda Mesaj Gönder hakkı yok veya Uygulama Komutlarını Kullan hakkı küresel olarak kapalı.
   • Çözüm: Belirli kanalın ayarlarında izin geçersiz kılmalarını kontrol edin.

2. Bot rol veremiyor.

   • Neden: Rol hiyerarşisi bozuk (botun rolü hedef rolden aşağıda).
   • Çözüm: Sunucu Ayarları → Roller listesinde botun rolünü yukarı taşıyın.

3. Bot @everyone etiketleriyle spam yapıyor.

   • Neden: Gereksiz yere Herkesi Etiketle hakkı verilmiş.
   • Çözüm: Bu hakkı geri alın. Önemli bildirimler için @here kullanın veya haber aboneleri için özel bir rol oluşturun.

SSS: Popüler soruların cevapları

Bota "Yönetici" hakkı vermek gerekiyor mu? Hayır, %95 durumda bu gereksiz ve tehlikelidir. Bunun yerine gerekli kutucukları (Mesajları Yönet, At vb.) manuel olarak seçmek daha iyidir. "Yönetici" hakkı, belirli kanallardaki yasaklar dahil olmak üzere diğer tüm izin kısıtlamalarını yok sayar.

Neden slash komutları (/) eklendikten hemen sonra görünmüyor? Komutların küresel olarak senkronize edilmesi bazen 1 saate kadar sürebilir. Süreci hızlandırmak için Discord istemcisini yeniden başlatabilir veya geliştirici tarafından sağlanmışsa bot kontrol panelindeki "Komutları Yeniden Yükle" işlevini kullanabilirsiniz.

Sunucudan bot nasıl kaldırılır? Sunucu Ayarları → Entegrasyonlar → Botlar bölümüne gidin. İlgili botu bulun ve "Sil" veya "Çıkar" düğmesine basın. Ayrıca botu kullanıcı listesinden normal bir üye gibi atarak da çıkarabilirsiniz.

Bot mesajları görüyor ama tepki vermiyor. "Güvenli İçerik" modunun (Safe Mode) veya Discord'un oto-moderasyon filtrelerinin açık olup olmadığını kontrol edin; bunlar, bot yanıtları bağlantı veya yasaklı kelimeler içeriyorsa bot yanıtlarını engelleyebilir.