Discord Developer Portal Nasıl Kullanılır? Bot ve Uygulama Oluşturma
Kısa cevap: Discord developer portal üzerinden Discord hesabıyla oturum açılır, My Applications alanından uygulama kaydı açılır, Bot sekmesinde (yeni uygulamalarda bot kullanıcısı varsayılan olarak etkindir) Reset Token ile token üretilir. Ardından OAuth2 URL Generator ekranında bot scope'u ile gerekli izinler seçilerek sunucu davet bağlantısı hazırlanır. Uygulama kimliği General Information bölümünde, ekip kimliği ise Teams ekranında bulunur.
Bu akış, uygulama kaydından botun bir sunucuya eklenmesine kadar gereken temel yönetim işlemlerini aynı panelde toplar. Discord hesabıyla doğrudan oturum açıldığı için hesap şifresinin üçüncü taraflarla paylaşılması gerekmez. Botun kod tarafındaki bağlantısı token ile, sunucuya katılması ise OAuth2 davet adresiyle kurulur.
Discord Developer Portal Nedir?
Discord developer portal, botlar ve diğer Discord entegrasyonları için uygulama oluşturma ile yönetim araçlarını bir araya getiren resmi geliştirme alanıdır. Discord'un geliştirici dokümantasyonuna göre platform, bot ve entegrasyon geliştirmeyi destekler. Home ekranı başlangıç noktasıdır; My Applications ise oluşturulmuş uygulamaların seçildiği ve düzenlendiği yönetim alanı olarak kullanılır.
Discord developer portal login işlemi, geliştirici ana sayfasındaki Log In seçeneği üzerinden mevcut Discord hesabıyla tamamlanır. Hesabı olmayanlar aynı ekrandaki Create Account seçeneğiyle kayıt açabilir. Girişten sonra uygulama listesine geçilir ve her proje kendi panelinden yönetilir. Topluluk yapısına yönelik ek hizmetleri değerlendirmek isteyenler Discord sunucu büyütme hizmetleri içeriğine de ulaşabilir.
Discord Geliştirici Portalı Temel Kimlik Bilgileri
Application ID ile Client ID aynı uygulama kimliğini ifade eder; Discord'un geliştirici yardım merkezine göre Application ID, General Information bölümünde yer alır. Bu değerler uygulamanın Discord sistemindeki tanımıyla ilişkilidir. Public Key ise dışarıdan gelen etkileşim ve webhook isteklerinin imzasını doğrulamak için kullanılır.
Kimlik Alanı Portal Konumu Temel İşlevi Application ID General Information sekmesi Uygulamanın Discord sistemindeki benzersiz kimliği Public Key General Information sekmesi Gelen webhook ve etkileşimlerin imza doğrulaması Client ID OAuth2 sekmesi OAuth2 yetkilendirme akışlarında uygulama tanıtıcısı Team ID Teams sekmesi Ekip olarak yönetilen uygulamalarda çalışma grubu kimliği Discord developer portal teams alanı, birden fazla kişinin birlikte yönettiği projelerde ekip kimliğine erişim sağlar. Team ID, ekip temelli uygulama yönetiminde çalışma grubunu tanımlar. Kimlik değerlerini kullanırken ilgili alanın amacıyla eşleştirin; token gibi gizli bir anahtarı uygulama kimliğiyle karıştırmayın.
Discord Developer Portal Applications ile Yeni Uygulama Oluşturma
Discord developer portal applications ekranında yeni kayıt, My Applications içindeki New Application düğmesiyle başlar. Discord developer portal new application adımı uygulamanın adını girmenizi ve geliştirici şartlarını onaylamanızı ister. Kayıt tamamlandığında uygulamaya ait yönetim sayfası açılır.
- My Applications ekranını açın ve uygulama listesinin bulunduğu alanda New Application seçeneğini seçin.
- Açılan pencerede uygulama için ayırt edici bir ad yazın. Bu ad, yönetim panelindeki kaydın tanınmasını sağlar.
- Geliştirici şartlarının onay kutusunu işaretleyin ve oluşturma işlemini tamamlayın. Panel, yeni uygulamanın General Information sayfasına geçer.
- General Information alanında uygulama simgesini ve açıklamasını tanımlayın. Simge ile açıklama, projenin panelde ayırt edilmesini kolaylaştırır.
Uygulama kaydı, bot eklenmeden önce oluşturulur; bu nedenle her bot önce bir uygulamaya bağlıdır. Aynı hesap altında birden çok uygulama bulunabilir ve her biri ayrı ayarlar taşır. Uygulama listesi üzerinden doğru kaydı açmanız, sonraki yapılandırmaların doğru proje üzerinde yapılmasını sağlar.
Discord Developer Portal Bot Kurma Adımları
Discord developer portal bot kurma sürecinde uygulamanın Bot sekmesine geçilir; Discord’un başlangıç rehberine göre yeni oluşturulan uygulamalarda bot kullanıcısı varsayılan olarak etkin gelir. Bot kullanıcı adı ile profil görseli uygulamanın bu bölümünden düzenlenir. Public Bot ayarı, botun başka sunuculara eklenebilmesine ilişkin yapılandırmayı içerir.
- Uygulama panelinin sol menüsündeki Bot sekmesini açın. Bu bölüm, uygulamaya bağlı bot kullanıcısının ayarlarını toplar.
- Bot kullanıcısının oluşturulduğunu kontrol edin; yeni uygulamalarda bot varsayılan olarak etkindir, eski kayıtlarda Add Bot düğmesi görünebilir. Bot sayfasında token, kullanıcı adı, Public Bot ve Privileged Gateway Intents ayarları yer alır.
- Botun kullanıcı adını ve profil görselini belirleyin. Sunucularda görünen bot hesabı bu bilgilerle tanınır.
- Public Bot ayarını projenin davet yapısına göre düzenleyin. Bu ayar, davet bağlantısının kimler tarafından kullanılabileceğiyle ilişkilidir.
- Privileged Gateway Intents seçeneklerini botun ihtiyaç duyduğu olaylara göre yapılandırın. Mesaj içeriğine dayalı işlevler için Message Content Intent alanı özellikle önem taşır.
Gateway Intents, botun Discord'dan hangi olay türlerini alacağını belirleyen ayarlardır. Gereksiz seçenekler açılmadan yalnızca botun kullandığı olaylara yönelik yapılandırma yapılır. Bu ayarlar kod tarafındaki olay dinleyicileriyle uyumlu olmadığında bot beklenen veriyi alamaz.
Discord Bot Token Alma ve Güvenlik Kuralları
Discord bot token alma işlemi, bot kullanıcısı eklendikten sonra Bot sekmesindeki Reset Token düğmesiyle yürütülür. Discord'un bot dokümantasyonuna göre token, bot kullanıcısı oluşturulduktan sonra üretilen kimlik doğrulama anahtarıdır. Anahtar ilk kez görüntülendiğinde güvenli bir yerde saklanır ve botun kaynak kodunda açık biçimde paylaşılmaz.
Token, botun Discord API ile bağlantı kurmasını sağlayan gizli bilgidir. Panel token görüntüleme veya yenileme işleminde iki adımlı doğrulama isteyebilir. Bu bilgi başka biri tarafından görülürse Bot sekmesinden derhal Reset Token seçilir; önceki anahtar geçersizleşir ve uygulamadaki eski değer yeni token ile değiştirilir.
Token'ı sohbet mesajına, ekran görüntüsüne veya herkese açık kod deposuna eklemeyin. Çevresel değişken ya da erişimi sınırlandırılmış yapılandırma dosyası kullanılması, kaynak kod paylaşılırken anahtarın görünmesini önler. Uygulama kimliği ve genel bağlantılar paylaşılabilse de token aynı kapsamda değerlendirilmez.
Discord Bot Authorization Link Nasıl Oluşturulur?
Discord bot authorization link, OAuth2 menüsünün URL Generator ekranında bot scope'u seçildiğinde oluşturulur. Bu bağlantı, botun yetkili olduğunuz bir sunucuya eklenmesi için kullanılır. Davet adresi hazırlanırken botun yapacağı işlemlerle uyumlu izinler seçilir.
- Uygulama panelinde OAuth2 menüsünü açın ve URL Generator ekranına geçin. Bu alan, uygulama için yetkilendirme bağlantısı üretir.
- Scopes listesinden bot seçeneğini işaretleyin. Bot scope'u seçilmeden yalnızca bot daveti için gerekli bağlantı oluşmaz.
- Bot Permissions bölümünde botun kullanacağı izinleri seçin. Mesaj gönderme, kanal yönetimi veya rol işlemleri gibi yetkiler, botun görevine göre burada belirlenir.
- Ekranda üretilen bağlantıyı kopyalayın ve Sunucuyu Yönet yetkisine sahip olduğunuz sunucuda açın. Discord'un onay ekranında hedef sunucuyu seçip daveti tamamlayın.
İzinler, botun sunucuda gerçekleştirebileceği işlemlerin sınırını belirler. Bu nedenle yalnızca gerekli yetkilerin seçilmesi, botun görev alanını açık tutar. Sunucu takviyesi seçenekleriyle ilgilenenler Discord boost satın al seçenekleri üzerinden paket ayrıntılarını inceleyebilir.
Installation Sayfası: Install Link ve Yükleme Bağlamları
Discord developer portal’daki Installation sayfası, uygulamanın nereye yüklenebileceğini ve kullanıcıların hangi bağlantıyla yükleyeceğini belirler. Discord’un başlangıç rehberine göre uygulamalar sunuculara (Guild Install), kullanıcı hesaplarına (User Install) ya da her ikisine yüklenebilir. Sunucuya yüklenen uygulamayı Sunucuyu Yönet (MANAGE_GUILD) yetkisine sahip bir üye onaylamalıdır; kullanıcıya yüklenen uygulama ise kullanıcının tüm sunucularında, DM’lerinde ve grup DM’lerinde görünür ama yalnız komutlarla çalışır.
- Uygulama panelinin sol menüsünden Installation sayfasını açın.
- Installation Contexts altında uygulamanın destekleyeceği bağlamları seçin: User Install, Guild Install ya da ikisi.
- Install Link bölümünde Discord Provided Link seçeneğini belirleyin.
- Açılan Default Install Settings bölümünde User Install için applications.commands kapsamını, Guild Install için applications.commands ve bot kapsamlarını ekleyin.
- bot kapsamını seçince açılan izin menüsünden botun ihtiyaç duyduğu yetkileri işaretleyin, ardından Install Link alanındaki bağlantıyı kopyalayıp önce bir test sunucusunda deneyin.
Install Link için None seçilirse uygulamanın profilinde Add App düğmesi görünmez ve uygulama App Directory için uygun olmaz. Custom URL seçeneği ise Add App düğmesine basan kullanıcının yönlendirileceği adresi, örneğin belirli kapsam ve izinler içeren bir OAuth2 yetkilendirme adresini, sizin belirlemenizi sağlar. Discord, token’ın yeniden üretilmedikçe tekrar görüntülenemeyeceğini de hatırlatır; bu yüzden Reset Token sonrası değeri parola yöneticisi gibi güvenli bir yerde saklayın.
Bot Büyüdükçe: Doğrulama ve Privileged Intent Erişimi
Discord, bazı olay verilerini ayrıcalıklı (privileged) intent olarak sınıflandırır. Gateway dokümantasyonuna göre bunlar şu anda üç tanedir:
- Presence Intent (GUILD_PRESENCES): Üyelerin çevrim içi durum ve etkinlik güncellemeleri.
- Server Members Intent (GUILD_MEMBERS): Sunucuya katılma gibi üyelerle ilgili olaylar.
- Message Content Intent (MESSAGE_CONTENT): Mesaj olaylarındaki içerik alanları.
Bu intent’ler kodda kullanılmadan önce Bot sayfasındaki Privileged Gateway Intents bölümünde açılmalıdır ve Discord yalnız botun çalışması için gereken intent’lerin açılmasına izin verir. Geçersiz ya da izin verilmemiş intent gönderen uygulamanın Gateway bağlantısı kapatılır.
Dokümantasyona göre 100 veya daha fazla sunucuda bulunan uygulamaların doğrulanması gerekir ve doğrulanmış uygulamalar privileged intent’leri onay aldıktan sonra kullanabilir. Güncel dokümantasyon ayrıca 10.000’den az kullanıcıya ulaşan uygulamaların bu intent’leri portalda açarak kullanabildiğini, bu eşiği aşan uygulamaların erişime devam etmek için incelemeye başvurması gerektiğini belirtir. Eşik aşıldığında uygulama ya da ekip sahibine sistem mesajı ve/veya e-posta gelir, portalda da uyarı görünür; onaylanan erişim için her yıl yeniden başvuru hatırlatması gönderilir.
Discord Geliştirici Portalı ile Geliştirici Modu Aynı Şey mi?
Hayır, Discord geliştirici portalı ile Discord uygulamasındaki Geliştirici Modu farklı araçlardır. Geliştirici portalı, discord.com/developers adresinde uygulama ve bot kaydı yapılan web panelidir. Geliştirici Modu ise Discord uygulamasının ayarlarında açılan bir seçenektir ve sunucu, kanal, kullanıcı ya da mesajlara sağ tıklandığında kimlik (ID) kopyalama seçeneğini gösterir. Bu seçenek genellikle Kullanıcı Ayarları içindeki Gelişmiş bölümünde bulunur; menü adları sürüme göre değişebilir. Bot kodunda sunucu ya da kanal kimliği gerektiğinde bu kimlikler Geliştirici Modu ile kopyalanır.
Discord Geliştirici Ayarlarında Sık Yapılan Hatalar
Kurulumdaki yaygın sorunlar çoğunlukla intent, scope veya yetki seçimlerinin botun koduyla uyuşmamasından doğar. Bağlantı üretilmiş olsa bile gerekli sunucu yetkisi yoksa davet onaylanmaz. Aşağıdaki noktalar, yapılandırma sırasında doğrudan kontrol edilmesi gereken alanları gösterir.
- Message Content Intent kapalı kalır: Bot mesaj içeriğine göre çalışacaksa Privileged Gateway Intents altındaki bu seçenek kapalı olduğunda ilgili mesaj verisine erişemez.
- Fazla ya da eksik izin seçilir: Gerekenden geniş Bot Permissions seçimi botun gereksiz işlemlere erişmesine yol açar; eksik seçim ise ilgili komutların çalışmasını engeller.
- Sunucuyu Yönet yetkisi bulunmaz: Davet bağlantısını açan Discord hesabında bu yetki yoksa bot hedef sunucuya eklenemez.
- Bot scope'u işaretlenmez: OAuth2 URL Generator ekranında bot seçeneği kullanılmadan oluşturulan adres, bot daveti amacıyla gereken akışı sağlamaz.
Hata görüldüğünde önce botun gerektirdiği tek ayarı belirleyin ve ilgili panel alanını düzeltin. Aynı anda birden çok izin değiştirmek, sorunun kaynağını ayırt etmeyi zorlaştırır. Topluluk yapısına yönelik ek paketler için Discord sunucu üyesi satın al paketleri içeriği kullanılabilir.
Discord developer portal, uygulama kaydı, bot yapılandırması ve OAuth2 davet akışını aynı yönetim alanında birleştirir. Bot kurulumu tamamlandıktan sonra topluluğunuz için uygun Discord paketlerini Toade üzerinden seçerek sipariş verebilirsiniz.
Kaynaklar
