# Nereden başlamalı

N'oluyo üzerinde kendi botunu çalıştırmak ya da sitene "N'oluyo ile giriş yap" düğmesi koymak için yazılım uzmanı olman gerekmez. Sana en uygun yolu seç, yalnızca o yolun sayfalarını takip et.

## Bot nedir ve nerede çalışır

Bot, N'oluyo'da kendi kullanıcı adı, resmi ve **BOT** etiketi olan özel bir hesaptır; arkada onu yöneten küçük bir bilgisayar programı çalışır. Yeni gelen üyeyi karşılamak, kuralları çiğneyen mesajları silmek, anket açmak ya da ses kanalında müzik çalmak bu programın işidir.

Bilmen gereken en önemli kural şudur: **N'oluyo bot programını barındırmaz.** Portalda uygulama açtığında N'oluyo sana bot hesabını ve şifresi olan **token** değerini verir; programı ise kendi bilgisayarında ya da kiraladığın küçük bir sunucuda (VPS) sen çalıştırırsın. Bilgisayarını kapattığında orada çalışan bot da çevrimdışı olur; gün boyu açık kalmasını istediğinde onu bir sunucuya taşırsın.

## Sana uygun yolu seç

Deneyimine göre üç yoldan birini seçebilirsin:

### 1. Kod bilmiyorum (yapay zeka ile yazdır)

Daha önce hiç kod yazmadıysan bu yoldan başla. Geliştirici portalından botunu açar, N'oluyo'nun hazır doküman dosyasını ve kopyalanmaya hazır istemi kullandığın yapay zeka asistanına verirsin; o sana çalışan dosyaları yazar, sen de bilgisayarında çalıştırırsın.

- İlk adım: [Yapay zekaya yazdır](https://noluyo.net/gelistirici/yapay-zekaya-yazdir.md)
- Bilgisayar hazırlığı: [Kurulum](https://noluyo.net/gelistirici/kurulum.md)
- Hazır çalışan örnekler: [Tarifler](https://noluyo.net/gelistirici/tarifler.md)

### 2. Biraz kod biliyorum (resmi kütüphane ile)

JavaScript ya da Python okuyabiliyorsan resmi `noluyo-bot` kütüphanesi en rahat yoldur. Gateway bağlantısını, kopunca kaldığı yerden devam etmeyi (`resume`), hız sınırı kuyruğunu ve çoklu bağlantı (`shard`) yönetimini senin yerine halleder; sen yalnızca olay ve komut işleyicilerini yazarsın.

- Bilgisayar hazırlığı: [Kurulum](https://noluyo.net/gelistirici/kurulum.md)
- Node.js 22+ için: [JavaScript kütüphanesi](https://noluyo.net/gelistirici/kutuphane-js.md)
- Python 3.11+ için: [Python kütüphanesi](https://noluyo.net/gelistirici/kutuphane-python.md)
- Kopyalayıp çalıştıracağın 9 örnek: [Tarifler](https://noluyo.net/gelistirici/tarifler.md)

### 3. API'yi doğrudan kullanacağım

Kendi dilinde ya da hiçbir kütüphane kurmadan doğrudan HTTP ve WebSocket ile çalışmak istiyorsan protokol sade ve açıktır: düz JSON çerçeveleri, standart `fetch` ve `WebSocket`, Ed25519 imza doğrulaması ve açık hız sınırı başlıkları.

- Adım adım ilk istek ve bağlantı: [Hızlı başlangıç](https://noluyo.net/gelistirici/baslangic.md)
- Canlı olay bağlantısı: [Gateway](https://noluyo.net/gelistirici/gateway.md)
- Kartlar, butonlar, etkileşimler, komutlar, formlar ve ses: [Embed'ler](https://noluyo.net/gelistirici/embedler.md), [Bileşenler](https://noluyo.net/gelistirici/bilesenler.md), [Etkileşimler](https://noluyo.net/gelistirici/etkilesimler.md), [Komutlar](https://noluyo.net/gelistirici/komutlar.md), [Formlar](https://noluyo.net/gelistirici/formlar.md), [Ses](https://noluyo.net/gelistirici/ses.md)
- Tüm uçlar ve olay şemaları: [REST referansı](https://noluyo.net/gelistirici/api.md) ve [Olaylar](https://noluyo.net/gelistirici/olaylar.md)

> **İpucu:** Amacın bir sunucuya bot eklemek değil de kendi web sitene ya da uygulamana kullanıcıların N'oluyo hesabıyla giriş yapmasını sağlamaksa bot kısımlarını atlayıp doğrudan [N'oluyo ile giriş yap](https://noluyo.net/gelistirici/hesapla-giris.md) sayfasına geç.

## Zaman ve maliyet beklentisi

| İş | Ne kadar sürer | Maliyet |
|---|---|---|
| Portalda uygulama açıp ilk mesajı göndermek | 5–10 dakika | Ücretsiz |
| Yapay zeka ya da kütüphane ile çalışan ilk bot | 15–30 dakika | Kendi bilgisayarında ücretsiz |
| Botu 7/24 açık tutmak için küçük Linux VPS | Kurulumu 20 dakika | Kiraladığın sunucunun aylık ücreti (N'oluyo ücret almaz) |
| Botu doğrulayıp Botlar rehberinde listelemek | Başvuru formu 10 dakika | Ücretsiz |

N'oluyo API kullanımı, bot oluşturma, doğrulama başvurusu ve rehberde listelenme için hiçbir ücret istemez.

## Dokümanı indirmek ve yapay zekaya vermek

Dokümandaki her sayfa hem insan okuması hem de yapay zeka araçları için ayrı biçimlerde sunulur:

- **Tek sayfa ham Markdown (`.md`):** Her rehber sayfasının üstündeki **Markdown olarak aç** ya da **Kopyala** düğmesiyle o sayfanın düz `.md` halini alabilirsin (örneğin `/gelistirici/nereden-baslamali.md`).
- **Tarayıcıdan `.html` veya `.pdf` kaydetmek:** Herhangi bir rehberi ya da tek sayfalık dokümanı tarayıcının **Farklı kaydet** (`.html`) veya **Yazdır → PDF olarak kaydet** (`.pdf`) seçeneğiyle bilgisayarına indirebilirsin.
- **Küçük bağlamlı yapay zeka özeti (`llms-kisa.txt`):** 30 KB altındaki bu dosya, resmi `noluyo-bot` kütüphanesiyle bot yazdırmak için gereken temel kuralları ve örnekleri tek metinde toplar; sohbet penceresi dar olan araçlara doğrudan yapıştırabilirsin (`/gelistirici/llms-kisa.txt`).
- **Tam referans metni (`llms-full.txt`) ve dizin (`llms.txt`):** Tüm rehberleri, bütün REST rotalarını, olay şemalarını, hata ve kapanış kodlarını tek dosyada taşır (`/gelistirici/llms-full.txt` ve `/gelistirici/llms.txt`). Dosya yükleme destekleyen yapay zeka araçlarına bu dosyayı ver.

## Bu sayfayı yapay zekaya verirsen

> **İpucu:** Yapay zeka asistanına kod yazdıracaksan yalnızca bu giriş sayfasını değil, `/gelistirici/llms-kisa.txt` (veya `/gelistirici/llms-full.txt`) dosyasını ve [Yapay zekaya yazdır](https://noluyo.net/gelistirici/yapay-zekaya-yazdir.md) sayfasındaki hazır istemi ver. Bot token'ını asla sohbete yapıştırma; kodun `process.env.BOT_TOKEN` ya da `os.environ["BOT_TOKEN"]` okumasını iste.

## Sırada ne var

- [Yapay zekaya yazdır](https://noluyo.net/gelistirici/yapay-zekaya-yazdir.md): kod bilmeden adım adım bot yazdırma rehberi ve hazır istem
- [Kurulum](https://noluyo.net/gelistirici/kurulum.md): Windows, macOS ve Linux'ta Node.js veya Python hazırlığı
- [Temel kavramlar](https://noluyo.net/gelistirici/kavramlar.md): uygulama, bot, token, sunucu, rol, izin ve intent sözcüklerinin kısa özeti