Discord İçin Bot Oluşturma: Kayıttan İlk Çalıştırmaya Kadar

Discord'da bir bot oluşturmak için Discord Developer Portal'da bir uygulama kaydetmeniz, buna "Bot" bileşenini eklemeniz, erişim token'ını kopyalamanız ve gerekli izinlerle (Scopes ve Permissions) bir davet bağlantısı oluşturmanız gerekir. Tüm süreç yaklaşık 10–15 dakika sürer ve yapılandırma aşamasında karmaşık teknik beceriler gerektirmez.

Bu kılavuzda, geliştirici hesabı oluşturmaktan token'ların güvenli bir şekilde saklanmasına ve botun test sunucusuna eklenmesine kadar her aşamayı inceleyeceğiz.

Discord Developer Portal Neden Gereklidir

Discord Developer Portal, Discord için entegrasyonlar oluşturan tüm geliştiriciler için bir yönetim merkezidir. Burada sadece bir botu "kaydetmekle" kalmaz, aynı zamanda yaşam döngüsünü de yönetirsiniz:

• Benzersiz tanımlayıcılar alırsınız (Client ID, Public Key).
• OAuth2 üzerinden kimlik doğrulamayı yapılandırırsınız.
• Komutları (Slash Commands) ve etkileşimleri (Interactions) yönetirsiniz.
• API kotalarını ve sınırlamalarını kontrol edersiniz.

Bu aşamadan geçmeden kodunuz Discord sunucularına bağlanamaz, çünkü geçerli kimlik bilgilerine sahip olmaz.

Adım 1. Uygulama Kaydı

İlk olarak botunuz için bir "konteyner" yani bir uygulama oluşturmanız gerekir.

1. Resmi Discord Developer Portal sitesine gidin.
2. Ana Discord hesabınızla giriş yapın.
3. Sağ üst köşedeki New Application butonuna tıklayın.
4. Açılan pencerede gelecekteki botunuzun adını girin (örneğin MySuperBot). Bu isim, sunucu üye listesinde görüntülenecektir.
5. Kullanım koşullarını kabul edin ve Create butonuna tıklayın.

Oluşturma işleminden sonra General Information sekmesine yönlendirileceksiniz. Burada uygulama ikonu ve kısa bir açıklama yükleyebilirsiniz, ancak botun çalışması için bu zorunlu değildir. Önemli olan artık projenize ait benzersiz bir numara olan Application ID'ye sahip olmanızdır.

Adım 2. Bot Oluşturma ve Token Alma

Uygulamanın kendisi mesaj yazamaz veya komutlara tepki veremez. Buna bir yürütücüye, yani bota ihtiyacı vardır.

1. Sol menüden Bot bölümünü seçin.
2. Mavi renkli Add Bot butonuna tıklayın. Yes, do it! diyerek işlemi onaylayın.
3. Bot yönetim sayfası açılacaktır. Burada şunları göreceksiniz:
   • Username: Bot adı (değiştirilebilir).
   • Icon: Bot avatarı.
   • Token: Gizli erişim anahtarı.

Anahtarı görmek için Reset Token (veya View Token) butonuna tıklayın. Anahtarı kopyalayın ve güvenli bir yerde saklayın (şifre yöneticisi veya bilgisayarınızdaki .env dosyası). Token'ı kaybederseniz sıfırlayabilirsiniz, ancak eski sürüm anında çalışmayı durdurur.

Adım 3. İzinlerin Yapılandırılması ve Bağlantı Oluşturma

Botu bir sunucuya davet etmek için Discord'a botun hangi izinlere ihtiyaç duyduğunu açıklayan özel bir bağlantı oluşturmanız gerekir.

1. Sol menüden OAuth2 -> URL Generator bölümüne gidin.
2. Scopes bloğunda bot seçeneğini işaretleyin.
   • Not: Eğik çizgi komutlarını (/command) kullanmayı planlıyorsanız, ayrıca applications.commands seçeneğini de işaretleyin.
3. Aşağıda Bot Permissions bloğu görünecektir. Burada botun sunucuda neler yapabileceğini seçmeniz gerekir.
   • Basit bir metin botu için yeterlidir: Send Messages, Read Message History.
   • Moderatör botu için: Kick Members, Ban Members, Manage Messages ekleyin.
   • Müzik botu için: Connect, Speak (sesli kanallarda).

4. Sayfanın en altında oluşturulan bağlantı görünecektir. Bunu kopyalayın.

Adım 4. Botu Sunucuya Ekleme

Şimdi çalışma zamanı geldi.

1. Kopyalanan bağlantıyı tarayıcının adres çubuğuna yapıştırın.
2. Sunucuyu Yönet hakkına (veya yönetici rolüne) sahip olduğunuz sunucuyu seçin.
3. Devam butonuna tıklayın.
4. İstenen izinleri kontrol edin ve Yetkilendir butonuna tıklayın.
5. Gerekirse captcha doğrulamasını tamamlayın.

Bot, henüz kodunu çalıştırmadığımız için sunucu üye listesinde "Çevrimdışı" (offline) durumuyla görünecektir.

Güvenlik: Token Nasıl Saklanır

Yeni başlayan geliştiriciler genellikle token'ı doğrudan koda yerleştirerek ölümcül bir hata yaparlar:

# KÖTÜ ÖRNEK - ASLA BÖYLE YAPMAYIN
client.run("MTIzNDU2Nzg5M.CdEfGh.IjKlMnOpQrStUvWxYz")

Böyle bir kodu GitHub'a yüklerseniz, bot tarayıcıları token'ı saniyeler içinde çalar.

Doğru yaklaşım: Ortam değişkenlerini kullanın. Projenizin kök dizininde bir .env dosyası oluşturun:

DISCORD_TOKEN=buraya_uzun_token_yazılacak

Ve kodda bunu şu şekilde okuyun (python-dotenv kütüphanesi ile Python örneği):

import os
from dotenv import load_dotenv

load_dotenv()
TOKEN = os.getenv('DISCORD_TOKEN')

client.run(TOKEN)

.env dosyasını yanlışlıkla depoya gitmemesi için .gitignore dosyasına ekleyin.

Yeni Başlayanların Sık Yaptığı Hatalar

SSS

Programlama yapmadan bot yapılabilir mi? Evet, bot oluşturucular mevcuttur (örneğin Dyno, MEE6), ancak bunlar hazır işlevlerle sınırlıdır. Benzersiz bir mantığa ihtiyacınız varsa, kod yazmanız (Python, JS, Go vb. dillerinde) ve Discord API'yi kullanmanız gerekir.

Bot oluşturmak ne kadar maliyetli? Developer Portal'a kayıt olmak ve temel Discord API'yi kullanmak ücretsizdir. Botun 7/24 çalışmasını istiyorsanız yalnızca barındırma (hosting) için ödeme yapmanız gerekir (bulut sağlayıcılarının ücretsiz paketlerini veya kendi ev bilgisayarınızı kullanabilirsiniz).

Bot mesajlara yanıt vermiyorsa ne yapmalı? Kodda bir olay işleyicinin (örneğin discord.py'de on_message) uygulandığından ve botun belirli kanalda mesaj okuma iznine sahip olduğundan emin olun. Ayrıca, döngüleri önlemek amacıyla botun diğer botların mesajlarını görmezden gelip gelmediğini kontrol edin (bu standart bir uygulamadır).

Botun adı veya avatarı nasıl güncellenir? Bu işlem Discord Developer Portal'daki Bot bölümünden yapılır. Değişiklikler neredeyse anında etkili olur, ancak Discord istemcilerinin önbelleği birkaç dakika içinde güncellenebilir.