Rehbere girmek

N'oluyo'nun /kesfet ekranındaki Botlar sekmesi, sunucu yöneticilerinin doğrulanmış botları kategoriye ve anahtar sözcüğe göre arayıp tek tıkla kendi sunucularına ekleyebildiği resmi dizindir. Web, masaüstü, Android ve iOS istemcilerinin tamamında aynı kartlarla görünür.

Listelenme koşulları

Bir botun rehberde görünmesi için üç koşulun aynı anda sağlanması gerekir:

1. Uygulama Doğrulama incelemesinden geçmiş olmalıdır (verified: true).

2. Doğrulama başvurusunda Rehberde listelensin (want_listing: true) kutusu işaretlenmiş ve onaylanmış olmalıdır (listed_at dolu).

3. Bot aktif ve dışarıya açık (public: true) durumda olmalıdır; durdurulan, silinen veya gizliye alınan botlar listeden anında düşer.

Kategoriler

/gelistirici/uygulamalar sayfasında (PATCH /api/v1/applications/{application_id}) botun ana işine en uygun tek kategoriyi (listing_category) seç:

Bot kartı nasıl görünür

Rehberdeki her kart kullanıcıya şu bilgileri gösterir:

• Kimlik: Uygulamanın avatarı, adı, doğrulanmış rozeti, seçilen kategori etiketi ve o an bulunduğu gerçek sunucu sayısı (guild_count).

• Kısa tanıtım (listing_text): Kartın gövdesinde görünen özet metin (listing_text boşsa uygulama açıklaması description kullanılır).

• Sunucuya ekle düğmesi: Yöneticinin doğrudan /bot-ekle/<uygulama_id>?izin=<install_permissions> ekranını açmasını sağlar.

• Yardım ve şeffaflık bağlantıları: support_url, varsa website_url ve privacy_url. Uygulama sahibinin kullanıcı kimliği, e-postası veya gizli anahtarları hiçbir zaman rehber yanıtında yer almaz.

İyi bir kısa tanıtım metni (listing_text) yazmak

Sunucu yöneticisi onlarca kart arasında göz gezdirirken ilk iki cümleye bakar:

• İyi örnek: *"/anket ile süreli buton oylamaları açar, /hatirlat ile kanallara zamanlı duyuru gönderir ve yeni üyelere seçtiğin karşılama rolünü verir."*

• Kaçınılması gerekenler: Tamamı büyük harfli sloganlar (*"EN İYİ TÜRKÇE BOT!!!"*), sahte sunucu sayıları (kart zaten gerçek guild_count sayısını otomatik gösterir) ve ilgisiz anahtar sözcük yığınları.

En az izin ilkesi (install_permissions)

Portalda belirlediğin install_permissions tam sayısı, rehberdeki Sunucuya ekle düğmesinin ?izin= parametresini oluşturur. Yalnızca botun gerçekten çalışmak için ihtiyaç duyduğu izin bitlerini işaretle:

• Yalnızca eğik çizgi komutu yanıtlayan bir bot için 0 yeterlidir.

• Karşılama mesajı atan bir bot için ViewChannel | SendMessages yeterlidir; Administrator (8) istemek sunucu yöneticilerinin ekleme ekranından vazgeçmesinin bir numaralı sebebidir.

• İzin bitlerinin tam listesini ve değerlerini İzinler sayfasında bulabilirsin.

Destek ve web sitesi adresleri

• support_url (https://): Yöneticilerin soru sorabileceği ya da hata bildirebileceği N'oluyo destek sunucusu daveti veya destek sayfası. Doğrulanmış ve listelenmiş botlarda çalışır durumda kalması zorunludur.

• website_url (https://, isteğe bağlı): Komut listesini ya da kullanım kılavuzunu barındırdığın web sayfası.

Bilgileri güncelleme ve rehberden çıkma

• Rehber alanlarını (listing_category, listing_text, install_permissions, support_url, website_url) /gelistirici/uygulamalar üzerinden dilediğin an güncelleyebilirsin; yeni inceleme beklemeden karta yansır.

• Botunu rehberden kendin çekmek istersen portalda public anahtarını kapatabilirsin; mevcut sunuculardaki çalışması bozulmaz, yalnızca /kesfet listesinden ve yeni eklemelerden kalkar.

• Kurallara aykırı yanıltıcı tanıtım metni veya çalışmayan destek bağlantısı tespit edilirse bot rehberden çıkarılabilir (listed_at temizlenir); eksik giderildikten sonra yeniden başvuru yapılabilir.

Bu sayfayı yapay zekaya verirsen

Sırada ne var

• Doğrulama: doğrulama önkoşulları ve inceleme başvurusu

• İzinler: install_permissions bitlerinin tam tablosu

• Bot uygulamaları: /bot-ekle kurulum akışı ve uygulama ayarları