n8n ile Discord Otomasyonu Nasıl Yapılır?

n8n ile Discord otomasyonu, n8n'in Discord node'uyla (n8n'deki Discord adımıyla) kanallara mesaj göndermek, kanalları ve üyeleri yönetmek ve gerektiğinde bir kişiden onay istemektir. Workflow, n8n'de bir işi otomatik yapan adımların bütünüdür. Node ise workflow'un adımlarından biridir. n8n editörü, workflow'ların kurulup düzenlendiği ekrandır. Editörün ortasındaki canvas, node'ların eklenip birbirine bağlandığı çalışma alanıdır. Workflow'un ilk node'u olan trigger node, workflow'u belirli bir olayda ya da zamanda başlatır. Bağlantı için Discord'da bir bot oluşturulur ya da bir kanalın webhook adresi (kanala mesaj göndermeyi sağlayan adres) alınır. Bot, Discord'da bir uygulamanın yönettiği kullanıcı hesabıdır.

n8n'de Discord node'u ne yapar?

Belgelere göre Discord node'u, Discord'daki işleri otomatikleştirmek ve Discord'u başka uygulamalara bağlamak için kullanılır. Sunucu (server), Discord'da bir topluluğun kanallarını ve üyelerini bir arada tutan alandır. Belgelere göre Discord'un geliştirici belgelerinde sunucuya guild denir. Kanal, sunucuda mesajların yazıldığı bölümdür. Rol, Discord'da bir üyenin sunucudaki izinlerini belirleyen gruptur. Sunucuya eklenen botun da bir rolü olur. Discord node'u Channel (kanal), Message (mesaj) ve Member (üye) kaynakları üzerinde işlem yapar. Bazı işlemler şunlardır:

Örnek: Bir topluluk yöneticisi, bir formdan gelen her etkinlik kaydında duyuru kanalına mesaj gönderen bir workflow kurar. Üyeler yeni etkinliği kanalda görür.

AI Agent, bir dil modeliyle karar verip araç kullanan n8n node'udur. Belgelere göre Discord node'u bir AI Agent'ın aracı olarak da çalışır ve bu kullanımda alanlarının birçoğunu yapay zekâ doldurur. Ajan kurulumu n8n'de yapay zekâ ajanı nasıl kurulur yazısında anlatılır.

Örnek: Bir kişi AI Agent node'una Discord node'unu araç olarak bağlar. Ajan, gelen bir isteği okur ve mesajın metnini kendisi yazıp ilgili kanala gönderir.

Discord'a bağlanmak için hangi yöntem seçilir?

Credential, n8n'in bir hizmete bağlanmak için gereken giriş bilgisini sakladığı kayıttır. Belgelere göre Discord credential'ı üç yöntemi destekler. Webhook, Discord'da tek bir kanala mesaj göndermeyi sağlayan adrestir. OAuth2, bir uygulamanın kullanıcının şifresini görmeden hesaba erişim izni almasını sağlayan yöntemdir.

Belgelere göre sunucuya eklenen bot, sunucunun bütün kanallarında kullanıcılarla etkileşim kurabilir. Webhook adresi ise Discord'da sunucu ayarlarının Integrations bölümünden alınır.

Örnek: Bir kişi sadece duyuru kanalına haber göndermek ister ve webhook yöntemini seçer. Başka bir kişi yeni üyelere rol veren bir workflow kurar ve bot yöntemini seçer. Üçüncü bir kişi botu birden çok sunucuya kolayca eklemek ister ve OAuth2 yöntemini seçer.

Discord'da bot nasıl oluşturulur?

Developer portal, Discord'da uygulamaların ve botların oluşturulduğu sitedir. Bot Token, botun n8n'e bağlanmasını sağlayan gizli anahtardır. Belgelere göre bot şu adımlarla oluşturulur:

1. Discord'un developer portal sitesini (discord.com/developers/applications) aç, Discord hesabınla giriş yap ve yeni bir uygulama oluştur.
2. Name alanına uygulamanın adını yaz ve "Create" düğmesine tıkla. Portal uygulamayı oluşturur.
3. Sol menüden Bot sayfasını aç. Token bölümünde "Reset Token" düğmesine tıkla ve oluşan bot token'ını kopyala.
4. Bot sayfasının Privileged Gateway Intents bölümünde SERVER MEMBERS INTENT ayarını aç. Bot, sunucu üyeleriyle ilgili olayları bu ayarla alır.
5. Installation sayfasının Installation Contexts bölümünde Guild Install seçeneğini seç. n8n kullanıcıları en çok bu seçeneği kullanır.
6. Installation sayfasında Install Link için Discord Provided Link seçili değilse bu seçeneği seç.
7. Default Install Settings bölümünde applications.commands ve bot kapsamlarını (scopes) seç. Kapsamlar, uygulamanın sunucuya kurulurken istediği yetkileri belirler.
8. Bot sayfasının Bot Permissions bölümünde botun izinlerini seç.

Belgelere göre n8n, Discord node'u için şu izinleri önerir:

• Manage Roles
• Manage Channels
• Read Messages/View Channels
• Send Messages
• Create Public Threads
• Create Private Threads
• Send Messages in Threads
• Send TTS Messages
• Manage Messages
• Manage Threads
• Embed Links
• Attach Files
• Read Message History
• Add Reactions

Bot, sunucuya şu adımlarla eklenir:

1. Installation sayfasındaki Install Link bölümünden bağlantıyı kopyala.
2. Bağlantıyı tarayıcıya yapıştır ve Enter tuşuna bas. Tarayıcıda bir kurulum penceresi açılır.
3. Kurulum penceresinde "Add to server" seçeneğini seç ve pencerenin istediği adımları tamamla.
4. Discord'da sunucunun üye listesini aç. Bot listede görünür.

Örnek: Bir oyun topluluğunun yöneticisi, developer portal'da bir uygulama ve bot oluşturur. Install Link ile botu kendi test sunucusuna ekler ve botu üye listesinde görür.

Bot n8n'e nasıl bağlanır?

Bot şu adımlarla n8n'e bağlanır:

1. Workflow boşsa "Add first step" düğmesine tıkla ve bir trigger node seç. Seçtiğin trigger node canvas'a eklenir.
2. Canvas'taki bir node'un sağındaki "Add node" (+) düğmesine tıkla. n8n, node'ları arayıp seçebildiğin node panelini (nodes panel) açar.
3. Arama kutusuna "Discord" yaz, Discord'u ve ardından bir işlemi seç. n8n node'u canvas'a ekler ve ayarlarını açar.
4. Credential to connect with alanında "Create new credential" seçeneğini seç. Credential penceresi açılır.
5. Developer portal'dan kopyaladığın bot token'ını credential penceresine yapıştır.
6. "Save" düğmesine tıkla ve credential penceresini kapat. Yeni credential, node'un Credential to connect with alanında seçili görünür.

Belgelere göre n8n, credential'ı kaydederken çalışıp çalışmadığını test eder. OAuth2 yönteminde bot token'ına ek olarak developer portal'ın OAuth2 sayfasındaki Client ID ve Client Secret değerleri gerekir. Credential penceresindeki OAuth Redirect URL adresi de Discord uygulamasının OAuth2 > Redirects bölümüne eklenir.

Örnek: Bir kişi Discord node'unu ekler, yeni credential'a bot token'ını yapıştırır ve kaydeder. Credential to connect with alanında yeni credential seçili görünür.

n8n ile Discord'a nasıl mesaj gönderilir?

Mesaj, Message kaynağının Send işlemiyle gönderilir. Adımlar şunlardır:

1. Discord node'unun ayarlarında Message kaynağının Send işlemini seç.
2. Mesajın gideceği sunucuyu ve kanalı seç.
3. Mesajın metnini yaz.
4. Node'daki "Execute step" düğmesine tıkla.
5. Discord'da kanalı aç ve mesajın geldiğini kontrol et.

Embed, mesaja eklenen ve başlık, açıklama, görsel ya da bağlantı taşıyabilen zengin bir önizleme kutusudur. Belgelere göre Send işleminde "Add Embeds" seçeneğiyle Description, Author, Title, URL ve URL Image alanları eklenir. Footer gibi başka alanlar için Input Method ayarında Raw JSON seçilir ve alanlar Value parametresine JSON olarak yazılır.

Mesajda bir kişiyi etiketlemek için kişinin kullanıcı kimliği (user ID) gerekir. Belgelere göre kullanıcı kimliği, kişinin görünen adından farklıdır. Etiketleme biçimleri şunlardır:

Kimlikleri kopyalamak için Discord'da Developer Mode (geliştirici modu) açılır. n8n belgeleri, Developer Mode'u açma adımları için Discord'un yardım sayfasına yönlendirir.

Örnek: Bir topluluk yöneticisi, etkinlik duyurusuna başlığı ve görseli olan bir embed ekler. Mesajın başına <@USER_ID> biçimiyle duyuruyu hazırlayan kişiyi etiketler.

Discord'da onay isteyen mesaj nasıl gönderilir?

Belgelere göre Send and Wait for Response işlemi bir mesaj gönderir ve bir kişi mesajı onaylayana ya da cevap verene kadar workflow'u bekletir. Response Type ayarının üç seçeneği şunlardır:

Limit Wait Time ayarı, workflow'un belirli bir süre sonra kendiliğinden devam etmesini sağlar. Append n8n Attribution ayarı, mesajda n8n ile otomatik gönderildiği bilgisinin yer alıp almayacağını belirler. Belgelere göre Discord node'u, AI Agent'ın bir aracı çalıştırmadan önce insan onayı istediği adım olarak da kullanılabilir.

Örnek: Bir ekip, yeni bir duyuruyu yayımlamadan önce Approval türünde bir mesajla duyuru sorumlusuna sorar. Duyuru sorumlusu mesajdaki onay düğmesine tıklayınca workflow devam eder ve duyuruyu kanala gönderir.

n8n ile Discord'da sık görülen sorunlar nasıl çözülür?

API, bir yazılımın başka bir yazılıma istek gönderip cevap alabildiği arayüzdür. HTTP Request node'u, bir web adresine istek gönderip cevabı alan node'dur. Belgelere göre sık görülen sorunlar ve çözümleri şunlardır:

• Ban, Kick ve Timeout işlemleri "Missing Permissions" hatası verirse botun rolüne ilgili izni ekle. Ban ve Unban için Ban Members, Kick için Kick Members, Timeout için Moderate Members izni gerekir.
• Missing Permissions hatası, botun en yüksek rolü üyenin en yüksek rolünden yukarıda değilse de görülür. Çözüm için sunucu ayarlarının Roles bölümünde botun rolünü yukarı taşı ve workflow'u yeniden çalıştır.
• Embed'lerle ilgili bir sorun çıkarsa mesajı HTTP Request node'uyla gönder. Belgelere göre bu node, var olan Discord credential'ıyla Discord API'sine istek gönderebilir.
• Discord node'u istenen işlemi desteklemiyorsa HTTP Request node'unu kullan. Authentication alanında Predefined Credential Type'ı (n8n'in hazır credential türü) seç. Ardından Credential Type alanında Discord'un credential türünü, altındaki alanda kendi Discord credential'ını seç.

Belgelere göre sunucu sahibine Ban, Kick ve Timeout işlemleri uygulanamaz. Örnek: Bir topluluk yöneticisi, botla bir üyeyi sunucudan çıkarmak ister ve Missing Permissions hatası alır. Botun rolüne Kick Members iznini ekler, rolü üyenin rolünün üstüne taşır ve workflow'u yeniden çalıştırır. Workflow bu sefer hatasız çalışır ve üye sunucudan çıkarılır.

HTTP Request node'unun kullanımı n8n'de HTTP Request nasıl kullanılır yazısında anlatılır.

Sonraki adım

Developer portal'da bir test botu oluştur ve botu kendi test sunucuna ekle. Ardından n8n'de Discord node'unu ekle, bot token'ıyla credential'ı kur ve Message kaynağının Send işlemini seç. Test kanalına kısa bir mesaj gönder ve mesajın kanalda göründüğünü kontrol et.

Kurduğun bu workflow, topluluk duyuru sürecini kalıcı bir sisteme dönüştürmenin ilk adımıdır.