Discord'a bot ekleme ve erişim izinlerini yönetme

Discord sunucusuna bir bot eklemek için geliştirici sayfasındaki veya bot kataloğundaki "Davet Et" (Invite) düğmesini kullanın, hedef sunucuyu seçin ve gerekli izinlerin (OAuth2) verilmesini onaylayın. Güvenli çalışmanın anahtarı, bot için ayrı bir rol oluşturmak, bu rolü yönetilen rollerin listesinde daha yukarıya yerleştirmek ve minimum yeterli izin ilkesiyle hakları sınırlamaktır.

Doğru yapılandırma, izin çakışmalarını önler, kanalları spam'den korur ve otomasyonun istikrarlı çalışmasını sağlar. Aşağıda bot seçiminden ince ayarlı erişim izinlerinin yapılandırılmasına kadar tüm süreci ele alacağız.

Kurulum öncesi bilinmesi gerekenler

Herhangi bir üçüncü taraf yazılımı eklemeden önce görevlerini belirlemek önemlidir. Botlar birkaç kategoriye ayrılır:

• Moderasyon: Spam temizleme, uyarılar, yasaklamalar (örneğin Dyno, MEE6).
• Araçlar: Müzik, işlem kaydı, yeni katılımcıları karşılama.
• Entegrasyonlar: Twitch, YouTube, GitHub veya diğer hizmetlerle bağlantı.

Önemli: Bir botu eklemek için, onu davet etmek istediğiniz sunucuda "Yönetici" haklarına veya "Sunucuyu Yönet" iznine sahip olmanız gerekir.

Botun aktif olacağı kanalların listesini hazırlayın. Örneğin, bot moderasyon günlüklerini yazacaksa, tüm sunucu yerine yalnızca tek bir gizli metin kanalına erişimi olması yeterlidir.

Sunucuya bot ekleme adımları

Entegrasyon süreci çoğu genel bot için standarttır ve OAuth2 protokolü üzerinden gerçekleşir.

1. Botun sayfasını bulun. Botun resmi web sitesine veya güvenilir bir kataloga (örneğin Top.gg) gidin. Token'ınızı kötü niyetli kişilere vermemek için şüpheli kaynaklardan kaçının.
2. Daveti başlatın. Invite veya Add to Server düğmesine tıklayın.
3. Kimlik doğrulama. Hesabınıza giriş yapmadıysanız sistem bunu yapmanızı isteyecektir.
4. Sunucu seçimi. Açılır listede yönetici haklarına sahip olduğunuz sunucuyu seçin.
5. İzinleri seçme (Permissions).
   • Discord, botun talep ettiği izinlerin listesini gösterecektir.
   • İpucu: Temel işlev için açıkça gerekli olmayan izinlerin işaretini kaldırın (örneğin, bot yalnızca müzik çalıyorsa "Mesajları Yönet" iznine ihtiyacı yoktur).
6. Onaylama. "Yetkilendir" (Authorize) düğmesine tıklayın ve gerekirse CAPTCHA'yı tamamlayın.

Bundan sonra bot, etkinliğine bağlı olarak "Çevrimdışı" veya "Çevrimiçi" durumuyla sunucu üyeleri listesinde görünecektir.

Roller ve izin hiyerarşisinin yapılandırılması

Yeni başlayanların en sık karşılaştığı sorun, botun eklenmiş olmasına rağmen çalışmamasıdır. Vakaların %90'ında neden rol hiyerarşisinde yatar.

"Üstte olan daha güçlüdür" ilkesi

Discord'da izinler yukarıdan aşağıya doğru çalışır. Sunucu ayarları listesinde daha üstte bulunan rol, alttakiler üzerinde önceliğe sahiptir.

Doğru yapılandırma yöntemi:

1. Sunucu Ayarları -> Roller bölümüne girin.
2. Bot için oluşturulan rolü bulun (genellikle botun adıyla adlandırılır).
3. Bu rolü, botun hizmet vereceği normal üyelerin ve moderatörlerin rollerinin üstüne sürükleyin.
   • Örnek: Bot "Yeni Üye" rolünü atayacaksa, kendi rolü listede "Yeni Üye" rolünden daha yukarıda olmalıdır. Aksi takdirde bot bu rolü atayamaz.
4. Acil bir ihtiyaç yoksa botun rolünü "Yönetici" rolünün veya sunucu sahibinin rolünün üstüne koymayın. Bu bir güvenlik kuralıdır.

Minimum gerekli izinler

Bot rolünün "İzinler" bölümündeki gereksiz her şeyi devre dışı bırakın.

• Bot yalnızca komutları okuyorsa: "Mesajları/Kanalları Oku" ve "Mesaj Gönder" izinlerini bırakın.
• Bot moderasyon yapıyorsa: "Mesajları Yönet", dikkatli bir şekilde "Üyeleri Yasakla" veya "Üyeleri At" izinlerini ekleyin.

Kanal bazında ince ayarlı izin yapılandırması

Rolün genel izinleri belirli bir kanal için geçersiz kılınabilir. Bu, botun nerede yazabileceğini ve nerede yazamayacağını esnek bir şekilde yönetmenizi sağlar.

Senaryo 1: Günlük kanalı

Bot, işlemler hakkında raporlar yazmalı ancak kullanıcılar bu kanalı görmemeli veya oraya yazmamalıdır.

1. #bot-gunlukleri adında bir metin kanalı oluşturun.
2. Kanal ayarlarında @everyone rolü için erişimi kapatın (kanalı görüntüle: ❌).
3. Bot rolü için şunları etkinleştirin: "Mesajları Oku" (✅) ve "Mesaj Gönder" (✅).

Senaryo 2: Sesli kanalda müzik botu

1. Sesli kanalın ayarlarına girin.
2. Bot rolü için "Bağlan" ve "Konuş" izinlerinin etkin olduğundan emin olun.
3. Bot müzik için kullanıyorsa, kullanıcılar için "Öncelikli Konuşmacı" iznini kısıtlayabilirsiniz.

Senaryo 3: Komut spam'ini engelleme

Bot genel sohbetteki komutlara yanıt veriyorsa ancak bunu yalnızca belirli bir #bot-komutlari kanalıyla sınırlamak istiyorsanız:

1. Genel sohbette bot rolü için "Mesaj Gönder" iznini devre dışı bırakın (veya varsa botun kendi ayarlarında yoksayma kanalı sistemini kullanın).
2. #bot-komutlari kanalında bota tam etkinlik izni verin.

Yapılandırmada sık yapılan hatalar

SSS: Sorular ve cevaplar

Sunucu sahibi değilsem bot ekleyebilir miyim? Evet, eğer "Sunucuyu Yönet" veya "Davet Oluşturma" izniniz varsa (sunucu ayarlarına bağlı olarak). Ancak izinleri tam olarak yapılandırmak için yine de yönetici haklarına ihtiyacınız olacaktır.

Bot çevrimiçi ama komutlara yanıt vermiyor. Ne yapmalıyım?

1. Botun komut önekinin etkin olup olmadığını kontrol edin (eğik çizgi komutları / yerine önek kullanıyorsa).
2. Botun mevcut kanalda "Mesaj Geçmişini Oku" ve "Mesaj Gönder" iznine sahip olduğundan emin olun.
3. Botun izin ayarları üzerinden o kanalda engellenip engellenmediğini kontrol edin.

Bir botu sunucudan nasıl kaldırırım? Sunucu Ayarları -> Entegrasyonlar (veya mobil sürümde "Üyeler") bölümüne girin, botu bulun ve "Çıkar" veya "Sil" düğmesine tıklayın. Ayrıca, artık kullanmayı planlamıyorsanız botun izinlerini geliştirici panelinden iptal etmeniz önerilir.

Bota kişisel mesajlara erişim izni vermek güvenli mi? Standart sunucu botları, siz onlara kişisel mesaj göndermedikçe kişisel sohbetlerinize (DM) erişemez. Her zaman talep edilen izinlerin listesini kontrol edin: Basit bir müzik botu kişisel mesajlara erişim istiyorsa, bu onun kurulumunu reddetmek için bir nedendir.