# 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.

> **Not:** Rehber giriş yapmamış ziyaretçilere de açıktır (`GET /api/v1/discovery/bots?q=&category=&offset=`, sayfa başına 24 kayıt, en yüksek `offset` 960).

## Listelenme koşulları

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

1. Uygulama [Doğrulama](https://noluyo.net/gelistirici/dogrulama.md) 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ç:

| Kategori anahtarı | Ne zaman seçilmeli |
|---|---|
| `moderation` | Otomatik sözcük süzgeci, zaman aşımı, denetim kaydı ve sunucu düzeni araçları |
| `music` | Ses kanallarında yerel ses veya müzik yayını yapan botlar |
| `games` | Sunucu içi mini oyunlar, soru-cevap, skor tablosu ve eşleştirme araçları |
| `utility` | Hatırlatıcı, anket, rol seçici, duyuru ve üretkenlik komutları |
| `fun` | Mizah, rastgele içerik ve hafif topluluk etkileşimleri |
| `social` | Karşılama kartları, topluluk etkinlikleri ve tanışma yardımcıları |
| `other` | Yukarıdaki altı gruba doğrudan girmeyen özel amaçlı botlar |

## 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](https://noluyo.net/gelistirici/izinler.md) 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

> **İpucu:** Botunun rehber kartı ayarlarını yapay zekaya hazırlatırken şu üç kuralı hatırlat:
>
> - `listing_category` yalnızca `moderation`, `music`, `games`, `utility`, `fun`, `social` veya `other` değerlerinden biri olabilir.
> - `install_permissions` için `Administrator` (`8`) yerine yalnızca kodda çağrılan REST uçlarının gerektirdiği en küçük izin bitlerinin toplamı seçilmelidir.
> - `support_url`, `website_url` ve `privacy_url` adreslerinin tamamı `https://` ile başlamalıdır.

## Sırada ne var

- [Doğrulama](https://noluyo.net/gelistirici/dogrulama.md): doğrulama önkoşulları ve inceleme başvurusu
- [İzinler](https://noluyo.net/gelistirici/izinler.md): `install_permissions` bitlerinin tam tablosu
- [Bot uygulamaları](https://noluyo.net/gelistirici/bot-uygulamalari.md): `/bot-ekle` kurulum akışı ve uygulama ayarları