Discord Bot Doğrulama ve Privileged Intent İncelemesi: Güncel Kurallar

Kısa cevap: 10 Haziran 2026'da ne değişti?

Discord'un değişiklik günlüğüne (change log) ve yeni inceleme rehberine göre dört temel değişiklik var:

• Eşik artık kullanıcı tabanlı: Botunuzun bulunduğu tüm sunucularda onu görebilen benzersiz kullanıcı sayısı 10.000'i aştığında privileged intent erişimi için başvuru yapmanız gerekir.
• Yıllık yeniden başvuru: Daha önce incelemeden geçip erişim almış uygulamalar, erişimi sürdürmek için her yıl Developer Portal üzerinden yeniden başvurur.
• İnceleme sırasında büyüme durmuyor: Başvurunuz incelenirken botunuz istediği intent'lerle çalışmaya, yeni sunuculara katılmaya devam edebilir.
• Doğrulama ile intent incelemesi ayrıldı: Önceden App Verification ve privileged intent incelemesi aynı sürecin parçasıydı; artık ayrı yürütülüyor.

Eski kural: 75 ve 100 sunucu sınırı nereden geliyor?

Değişiklik günlüğünde 2022 tarihli bir kayıt, MESSAGE_CONTENT intent'inin 31 Ağustos 2022'den itibaren 75 ve üzeri sunucudaki doğrulanmış botlar için privileged hâle geleceğini duyuruyor. Haziran 2026 öncesindeki düzende ise 100'den az sunucudaki uygulamalar intent'leri portaldan açabiliyor, 100 ve üzeri sunucudaki uygulamalar başvuru yapmak zorunda kalıyordu. Pycord gibi topluluk rehberlerinde gördüğünüz "75 sunucuda doğrulama başvurusu yapın, doğrulanmamış bot 100 sunucuyu geçemez" tavsiyesi bu dönemden kalma.

Bugün resmî Gateway sayfasında doğrulamanın 100 ve üzeri sunucudaki uygulamalar için gerekli olduğunu söyleyen bir not hâlâ duruyor. Yani sunucu sayısına bağlı doğrulama ile kullanıcı sayısına bağlı intent incelemesi artık iki farklı konu. Doğrulama gereksinimlerinin güncel listesini her zaman Developer Portal'daki "App Verification" sayfasında görürsünüz; bu yazıda o sayfada yazmayan bir eşik uydurmuyoruz.

10.000 kullanıcı eşiği nasıl işliyor?

Discord, uygulamanızın kurulu olduğu tüm sunuculardaki benzersiz kullanıcıları sayar. Resmî rehberin verdiği örnekle: 50 büyük sunucudaki bir bot eşiği aşabilirken 200 küçük sunucudaki bir bot aşmayabilir. Ölçülen şey kurulum sayısı değil, botun ulaştığı kişi sayısıdır.

10.000 kullanıcının altındaysanız

Başvuru gerekmez. Developer Portal'da uygulamanızı seçip Bot sekmesine girin, "Privileged Gateway Intents" bölümüne inin ve gerçekten ihtiyaç duyduğunuz intent'i açın. Belgeler burada önemli bir uyarı yapıyor: teknik olarak açabiliyor olmanız, her intent'i açmanız gerektiği anlamına gelmiyor. Yalnızca işlevin gerektirdiği intent'leri açmalısınız, çünkü eşiği geçtiğinizde her intent için kullanım gerekçesi sunmanız gerekecek.

Eşiğe yaklaştıysanız veya aştıysanız

Uygulamanız 10.000 kullanıcıya ulaştığında ve açık bir privileged intent varsa (ya da açmaya çalışırsanız) uygulama ya da takım sahibi bir sistem DM'i ve/veya e-posta alır, Developer Portal'da da uygulamanın üzerinde bir uyarı görünür. Bildirim tarihinden itibaren başvuru için 90 gününüz var. Bu süre içinde başvurmazsanız mevcut privileged intent erişiminiz kaldırılır, ancak istediğiniz zaman yeniden başvurabilirsiniz.

Erişiminiz zaten onaylıysa

Önceki bir incelemeden geçmiş uygulamalar yıllık yeniden başvuru yapar. Zamanı geldiğinde bildirim alırsınız ve yine 90 günlük bir pencere açılır. Discord, bildirim gelmeden "bir yıl doldu" diye kendiliğinden başvurmamanızı, bildirimi beklemenizi öneriyor.

App Verification: uygulama doğrulaması ayrı bir süreç

Uygulama doğrulaması, intent incelemesinden bağımsız olarak şu işler için gerekiyor:

• Discovery: Uygulamanızın App Directory ve App Launcher'da listelenmesi için takım sahibinin kimlik ve uygulama doğrulamasını tamamlaması gerekir.
• Monetization: Abonelik ve tek seferlik satış gibi ücretli özellikler için doğrulanmış bir uygulama şart. Ayrıntılar Discord premium abonelik yazımızda.

Gereksinim listesini görmek için Developer Portal'da uygulamanızı seçip sol menüden "App Verification" sayfasını açın, listelenen kriterleri tamamlayın ve ardından doğrulama için gönderin. Kriterler hesabınıza ve uygulamanıza göre portalda gösterildiği için en güvenilir kaynak o sayfadır.

Adım adım privileged intent başvurusu

1. Nerede olduğunuzu belirleyin

Portalda bir uyarı veya bildirim yoksa ve intent anahtarları kilitli değilse eşiğin altındasınız. Kilitli bir anahtar ve başvuru çağrısı görüyorsanız eşiği geçmişsiniz demektir.

2. Hangi intent'leri gerçekten kullandığınızı denetleyin

Resmî rehbere göre en sık yapılan hata bu adımı atlamak. Kodunuzda hangi özelliğin hangi veriye dayandığını çıkarın. Örneğin hoş geldin mesajı GUILD_MEMBER_ADD olayına, yani Guild Members intent'ine dayanır; prefix komutları ise Message Content intent'ine.

3. Alternatif mi, başvuru mu?

Her intent için iki yol var. A yolu bağımlılığı kaldırmak: intent'e ihtiyacınız kalmazsa başvuru, yıllık yenileme ve erişim kaybı riski de ortadan kalkar. B yolu başvurmak: verinin uyumlu bir kullanım için gerçekten gerekli olduğunu ve başka yolu olmadığını gösterirsiniz.

Slash komutlarına geçiş, Message Content talebinin en yaygın nedenini ortadan kaldırıyor. Nasıl yapılacağını slash komut oluşturma rehberimizde, buton ve modal tarafını da buton, select menu ve modal yazımızda anlattık.

4. Başvuruda inceleme ekibi ne bekliyor?

Discord'un rehberi başarılı bir başvuru için şunları sıralıyor:

• Kullanım gerekçesini somut yazın. "Botumun mesaj içeriğine ihtiyacı var" bir gerekçe değil. "Botum, mesajları phishing bağlantıları ve bilinen dolandırıcılık kalıpları için tarayarak otomatik moderasyon yapıyor" gibi, veriyle ne yaptığınızı ve neden interaction ile çözülemediğini açıklayan bir metin bekleniyor.
• Yalnızca ihtiyacınız olanı isteyin. Moderasyon için Message Content gerekiyor ama Guild Presences gerekmiyorsa ikincisini istemeyin. Gerekçelendiremediğiniz intent'ler başvurunuzu zayıflatır.
• Veriyi nasıl koruduğunuzu anlatın. Veriyi saklıyorsanız neden gerekli olduğunu, saklama süresi politikanızı ve güvenlik önlemlerinizi yazın. Bellekte işleyip atıyorsanız bunu belirtin.
• Yıllık incelemeyi baştan düşünün. Cevaplarınızı kolay güncellenecek şekilde yazın, botun veriyi nasıl kullandığının kaydını tutun.
• Eksiksiz ve doğru bilgi verin. Belirsiz veya eksik başvurular gecikmeye ya da redde yol açabilir.

5. Onaydan sonra iki yerde açın

Erişiminiz varsa intent'i hem Developer Portal'da (Bot sekmesi, "Privileged Gateway Intents") hem de kodunuzda açmanız gerekir. Biri eksik olursa bağlantı hatası alırsınız.

const { Client, GatewayIntentBits } = require('discord.js');

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMembers, // privileged: portalda da açık olmalı
  ],
});

client.login(process.env.DISCORD_TOKEN);

discord.py tarafında aynı şey Intents nesnesiyle yapılır:

import os
import discord

intents = discord.Intents.default()
intents.members = True  # privileged: portalda da açık olmalı

client = discord.Client(intents=intents)
client.run(os.getenv('DISCORD_TOKEN'))

6. Test edin

• Botu yeniden başlatın. Intent değişiklikleri yalnızca yeni bir Gateway bağlantısında geçerli olur.
• Loglarda DisallowedIntents hatası arayın; bu, kod ile portal ayarı arasında uyuşmazlık demektir.
• Kaldırdığınız intent'e bağlı özellikleri yeni yöntemle test edin.
• İkinci bir Discord hesabıyla gerçek kullanıcı gibi deneyin.

4014 ve DisallowedIntents hatası

Kodunuzda portalda açık olmayan ya da onaylanmadığınız bir privileged intent istediğinizde Gateway bağlantısı 4014 kapanma koduyla (Disallowed intent(s)) kapanır ve belgelere göre bu kodda yeniden bağlanılmamalıdır. Kütüphaneler bunu genellikle DisallowedIntents adlı bir hata olarak gösterir. Çözüm: portaldaki anahtarı kontrol edin; eşiğin üstündeyseniz ve anahtar kilitliyse başvuru yapmanız gerekir. Diğer kapanma kodları için Discord API hata kodları yazımıza bakabilirsiniz.

_LIMITED bayrakları ne anlama geliyor?

Application nesnesinin flags alanında her privileged intent için iki bayrak bulunur. Referans tablosundaki açıklamalar hâlâ "100 sunucu" ifadesini kullanıyor; pratikte _LIMITED bayrağı intent'in portaldaki anahtarla açıldığını, eki olmayan bayrak ise inceleme sonrası verilen erişimi temsil eder.

Edit Current Application uç noktasıyla API üzerinden yalnızca bu üç _LIMITED bayrağı güncellenebilir. Botunuzun hangi bayraklara sahip olduğunu discord.js ile şöyle görebilirsiniz:

const { Client, Events, GatewayIntentBits } = require('discord.js');

const client = new Client({ intents: [GatewayIntentBits.Guilds] });

client.once(Events.ClientReady, async (c) => {
  const app = await c.application.fetch();
  const names = [
    'GatewayPresence', 'GatewayPresenceLimited',
    'GatewayGuildMembers', 'GatewayGuildMembersLimited',
    'GatewayMessageContent', 'GatewayMessageContentLimited',
    'VerificationPendingGuildLimit',
  ];
  for (const name of names) console.log(name, app.flags.has(name));
  console.log('Yaklaşık sunucu sayısı:', app.approximateGuildCount);
});

client.login(process.env.DISCORD_TOKEN);

Başvurunuz reddedilirse

Belgelere göre ret genellikle iki nedenle olur: başvuru, kullanımın gerçekten intent gerektirdiğini göstermiyordur (interaction veya başka bir yolla yapılabiliyordur) ya da gereksinimlerle uyumlu değildir (belirsiz, eksik veya politikaya aykırı bir kullanım). Bazı durumlarda mevcut erişiminizi korurken yeniden göndermeniz için ek süre tanınır, bazı durumlarda erişim kaldırılır ama yeni bir talep her zaman gönderilebilir. Yeniden başvururken daha somut bilgi ekleyin ve özelliğin çalıştığını gösteren ekran görüntüsü veya video kanıtı ekleyin. Özellik slash komut, component veya modal ile yeniden yazılabiliyorsa bunu tercih edip intent talebinden vazgeçmek daha kalıcı bir çözüm.

Başvurunun politika tarafını, yani veri kullanımı ve gizlilik politikasıyla ilgili beklentileri Discord Developer Policy özetimizde ayrıca ele aldık.

Sık Sorulan Sorular

Botum 100 sunucuya ulaştı, intent'lerim kapanacak mı?

Intent incelemesi için ölçüt artık sunucu sayısı değil, 10.000 benzersiz kullanıcı. Eşiği geçtiğinizde bildirim alırsınız ve başvuru için 90 gününüz olur. Doğrulama gereksinimleri için Developer Portal'daki "App Verification" sayfasını kontrol edin.

Başvuru incelenirken botum çalışmaya devam eder mi?

Evet. Yeni kurallara göre inceleme sürerken uygulamanız istediği intent'lerle çalışmaya ve yeni sunuculara katılmaya devam edebilir.

Doğrulanmış bir bot için intent onayı otomatik mi gelir?

Hayır. Haziran 2026 itibarıyla App Verification ve privileged intent incelemesi ayrı süreçler. Doğrulanmış olmanız intent erişimi verildiği anlamına gelmez.

Message Content olmadan bot mesajları hiç okuyamaz mı?

Belgelere göre intent olmadan da botun kendi gönderdiği mesajların, bota gelen DM'lerin, botu etiketleyen mesajların ve mesaj bağlam menüsü komutunun kullanıldığı mesajın içeriği gelir. Diğer mesajlarda content gibi alanlar boş döner.

Her yıl ne zaman yeniden başvuracağımı nasıl bilirim?

Discord yenileme zamanından önce bildirim gönderir. Bildirim geldikten sonra 90 gün içinde ilk başvurudaki aynı süreçle Developer Portal üzerinden başvurursunuz.

Marka adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen kuruluşlarla bayilik veya ortaklık ilişkisi bulunduğu anlamına gelmez.

İlgili içerikler: Discord intent nedir · Slash komut oluşturma · AutoMod moderasyon botu · Developer Policy özeti · Premium abonelik ve SKU · Sharding nedir · API hata kodları