Discord Ayrıcalıklı Intent'ler: Presence, Üyeler ve Mesaj İçeriği
Ayrıcalıklı intent'ler, hassas verileri açan üç gateway intent'idir: çevrimiçi durum güncellemeleri, sunucu üye listesi ve mesajların içeriği. Bir bot bunların her birini Developer Portal'da açmalıdır. 100 sunucuyu aştığında, bunları kullanmaya devam etmek için Discord tarafından doğrulanmalı ve onaylanmalıdır.
Üç intent
- Presence: üyelerin çevrimiçi, boşta ya da çevrimdışı olup olmadığı ve etkinlik durumları.
- Sunucu üyeleri: üye katılma ve ayrılma olayları ile tam üye listesi. Karşılama mesajları, doğrulama ve otomatik roller için gereklidir.
- Mesaj içeriği: mesajların gerçek metni, embed'leri ve ekleri. Önek komutlarını okumak ve metin tarayan her şey için gereklidir.
Mesaj içeriği olmadan bir bot yine de kendisinden bahsedilen mesajları, özel mesajları ve kendi mesajlarını, ayrıca slash komutları gibi etkileşimleri alır. Modern botların slash komutlarına yaslanmasının nedeni budur.
Onay nasıl işler
100'den az sunucudaki bir bot için, Developer Portal'da botun sayfasındaki anahtarı açmanız yeterlidir. Bir bot 100 sunucuya ulaştığında Discord, botun doğrulanmasını ister ve ayrıcalıklı intent'ler için belirtilen bir gerekçeyle onay gerekir. Onay olmadan bot bunları kaybeder. Discord her durumu tek tek değerlendirir, bu yüzden verinin gerektiği özelliğin net bir açıklaması yardımcı olur.
Bir bot, açmadığı bir ayrıcalıklı intent isteyerek bağlanırsa, Discord bağlantıyı 4014 hatasıyla kapatır. Bu, bir botun kurulumdan hemen sonra çevrimdışı olmasının sık nedenidir. Bkz. 4014 açıklaması.
Sunucu sahipleri neden önemser
Bu intent'ler, bir botun üyelerinizin verilerine dokunan kısmıdır. En çok düşünülmesi gereken mesaj içeriğidir: mesajları okuyan bir bot spam ve bağlantıları filtreleyebilir, ama erişimi olan yerlerde söylenen her şeyi de görür. Bunu, özel alanlarda botun Kanalı Görüntüle iznini reddederek sınırlayabilirsiniz.
Bu aynı zamanda güvenilirliği etkiler. Onaylı bir intent'i kaybeden bir bot, sessizce üyeleri karşılamayı ya da kuralları uygulamayı bırakabilir.
Noxyr ve ayrıcalıklı intent'ler
Kendi uygulamanızı kullanan bir Noxyr özel botu için kurulum, Developer Portal'da Server Members Intent ve Message Content Intent'in açık olmasını ister. Bunlara bağlı Noxyr özellikleri arasında karşılama mesajları, doğrulama ve anti-spam bulunur. ayrıcalıklı gateway intent'lerine dair tam rehberi okuyun; daha geniş fikir için gateway intent'lerine bakın.
Bir bot kurmadan önce kontrol edin
Bir botun hangi ayrıcalıklı intent'leri ne için kullandığını sorun. Bir müzik botunun presence verisine nadiren ihtiyacı olur, bir anket botunun da tüm mesajları okumaya nadiren ihtiyacı olur. Cevap belirsizse, başka bir bot seçin.
Sık sorulan sorular
Hangi intent'ler ayrıcalıklıdır?
Presence, sunucu üyeleri ve mesaj içeriği.
Botum neden 4014 hatasıyla bağlantısı kopuyor?
Developer Portal'da açık olmayan bir ayrıcalıklı intent istedi. Onu açın ve botu yeniden başlatın.
Bir Noxyr özel botu hangi intent'lere ihtiyaç duyar?
Kendi uygulamanız için Server Members Intent ve Message Content Intent açık olmalıdır.