Bu rehberde: Discord sunucunuz için bir bot oluşturur ve OrqLabs'a bağlarsınız. Kanallara mesaj gönderir, slash komutlarıyla gelen soruları Gelen Kutusu'na ve chatbot'a aktarırsınız.
⏱ 20 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | DISCORD |
| Kategori | Mesajlaşma |
| Kimlik doğrulama | Token (bot anahtarı) |
| Kapsam | Proje bazlı |
| Webhook | Evet (Interactions Endpoint) |
| Yetenekler | Mesaj gönderme, mesaj alma, toplu mesaj |
| Kullanan kutular | Mesaj geldi, Mesaj gönder, İnsana devret |
| Kullanan ajanlar | AI Chatbot |
Ne işe yarar?
- Kanala mesaj gönderme: Mesaj gönder kutusu ve kampanyalar, verdiğiniz kanal kimliğine bot olarak yazar. Uzun metinler 2.000 karakterlik parçalara bölünüp art arda gönderilir.
- Gelen mesajlar: Discord, kullanıcıların slash komutlarını ve buton tıklamalarını Interactions Endpoint adresine iletir. Her komut Gelen Kutusu'nda bir konuşma olur; chatbot yanıtını aynı kanala normal mesaj olarak yazar.
Önemli: OrqLabs Discord'a kalıcı (Gateway) bağlantı açmaz. Bu yüzden kanallara yazılan sıradan mesajları ve DM'leri kendiliğinden görmez; bot yalnızca slash komutlarını ve bileşen tıklamalarını alır. Sıradan kanal mesajlarını da işlemek isterseniz kendi Gateway aktarıcınız
MESSAGE_CREATEolaylarını webhook adresine iletebilir; OrqLabs bu olayları da konuşmaya çevirir.
Ön koşullar
- Sunucuda Manage Server yetkisi.
- discord.com/developers/applications hesabı.
- Herkese açık HTTPS adres (Interactions Endpoint için).
Adım adım kurulum
A) Discord Developer Portal
- Applications → ① New Application → ② ad → ③ Create.
- General Information: ① Application ID ve ② Public Key değerlerini kopyalayın. Interactions Endpoint URL alanını şimdilik boş bırakın.
- Sol menü Bot: ③ Reset Token → anahtarı kopyalayın (yalnızca bir kez gösterilir). ④ Privileged Gateway Intents yalnızca kendi Gateway aktarıcınızı kullanacaksanız gerekir (o durumda Message Content Intent açık olmalıdır).
- OAuth2 → URL Generator: ② Scopes:
bot,applications.commands. ③ Bot Permissions: View Channels, Send Messages, Send Messages in Threads, Read Message History, Embed Links, Attach Files, Add Reactions. Oluşan adresi tarayıcıda açın → sunucuyu seçin → Authorize. Bot sunucuya katılır. - Sunucuda botun yazacağı kanallarda rol izinlerini kontrol edin.
B) OrqLabs'ta bağlama
- Entegrasyonlar → Discord Bot → Bağla → ② Proje seçin.
- Alanlar:
| Alan | Nereden alınır |
|---|---|
| Bot Token | Bot → Reset Token |
| Application ID | General Information |
| Public Key (interactions) | General Information; boşsa slash komutları doğrulanamaz |
- ③ Bağla. OrqLabs bot anahtarını doğrular. Kalıcı bağlantı açılmaz; mesaj almak için aşağıdaki webhook adımını tamamlayın.
Webhook (Interactions Endpoint)
Botun soru alabilmesi için bu adım gereklidir:
- OrqLabs Discord kartı → Webhook URL:
https://api.orqlabs.com/api/v1/webhooks/discord/<hesap kimliği>. - Developer Portal → General Information → Interactions Endpoint URL (görsel ①) → yapıştırın → Save Changes. Discord bir PING gönderir; OrqLabs Public Key ile doğrulayıp yanıtlar.
- Slash komutlarını (ör.
/sor soru:…,/destek) Discord'da kendiniz kaydedin: Developer Portal'ın komut ekranı veya Discord API (PUT /applications/<Application ID>/commands). OrqLabs komut kaydetmez. - Kullanıcı komutu çalıştırdığında OrqLabs etkileşimi 3 saniye içinde yalnızca kullanıcının gördüğü kısa bir onayla ("✓") yanıtlar; chatbot'un asıl cevabı birkaç saniye içinde kanala normal mesaj olarak gelir. Komut metni Gelen Kutusu'nda
/sor soru:…biçiminde görünür.
İzinler
| İzin | Neden gerekli |
|---|---|
Scope bot | Botu sunucuya ekleme |
Scope applications.commands | Slash komutları |
| Message Content Intent | Yalnızca kendi Gateway aktarıcınızla sıradan mesajları okumak için |
| View Channels, Send Messages, Read Message History | Temel sohbet |
| Embed Links, Attach Files | Rapor ve medya |
Bot 100'den fazla sunucuda ise Discord doğrulaması gerekir. Tek şirket sunucusu için gerekmez.
Limitler
| Konu | Sınır |
|---|---|
| Kanal başına | 5 mesaj / 5 saniye |
| Mesaj | 2.000 karakter; OrqLabs daha uzun metinleri paragraf ve cümle sınırından bölüp art arda gönderir |
| Dosya | 25 MB |
| DM | Kullanıcı ile ortak sunucu gerekir |
Bağlantıyı test etme
② Bağlantıyı test et bot adını gösterir. Sunucuda kaydettiğiniz bir slash komutunu çalıştırın (ör. /sor soru:merhaba); Gelen Kutusu'nda konuşma oluşmalı ve yanıt kanala gelmeli. Kanal kimliğini Discord'da Geliştirici Modu açıkken kanala sağ tık → Copy Channel ID ile alın.
Kimlik bilgilerini yenileme
- Reset Token eski anahtarı anında geçersiz kılar; yenisini entegrasyon kartı → Kimlik bilgileri → Güncelle → Bot Token alanına girin.
- Public Key sabittir.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
AUTH – 401 | Anahtar yanlış/sıfırlanmış | Yeni anahtar |
| Bot kanal mesajlarına yanıt vermiyor | OrqLabs sıradan mesajları almaz (Gateway yok) | Slash komutu kaydedin veya kendi Gateway aktarıcınızı kullanın |
| Komut listede yok | Slash komutu Discord'da kayıtlı değil | Komutu Developer Portal veya API ile kaydedin |
| Aktarıcı mesajları boş geliyor | Message Content Intent kapalı | Bot → Intents → açın |
INVALID – 50013 "Missing Permissions" | Send Messages yok | Davet adresini izinlerle yeniden oluşturun |
INVALID – 50001 "Missing Access" | Bot sunucuda değil | Davet adresiyle ekleyin |
INVALID – 50007 | DM kapalı | Kanal üzerinden yanıtlayın |
| Interactions "validation failed" | Public Key yanlış, adres erişilemez | Public Key'i kontrol edin; HTTPS |
RATE_LIMIT – 429 | Kanal sınırı | Toplu mesaj hızını 30'a düşürün |
Sık sorulan sorular
Slash komutları zorunlu mu? Soru almak için evet: OrqLabs Discord'dan yalnızca etkileşimleri (slash komutu, buton) alır. Yalnızca kanala mesaj gönderecekseniz (duyuru, bildirim) komut gerekmez.
Bot tüm mesajları okur mu?
Hayır. Kalıcı Gateway bağlantısı olmadığından sıradan kanal mesajlarını ve DM'leri görmez. Kendi Gateway aktarıcınız MESSAGE_CREATE olaylarını webhook adresine iletirse onları da işler; Mesaj geldi kutusunda filtre kullanabilirsiniz.
Birden fazla sunucuya ekleyebilir miyim? Evet; aynı bot birden fazla sunucuya davet edilebilir.