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

• Bilgisayar hazırlığı: Kurulum

• Hazır çalışan örnekler: Tarifler

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

• Node.js 22+ için: JavaScript kütüphanesi

• Python 3.11+ için: Python kütüphanesi

• Kopyalayıp çalıştıracağın 9 örnek: Tarifler

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ıç

• Canlı olay bağlantısı: Gateway

• Kartlar, butonlar, etkileşimler, komutlar, formlar ve ses: Embed'ler, Bileşenler, Etkileşimler, Komutlar, Formlar, Ses

• Tüm uçlar ve olay şemaları: REST referansı ve Olaylar

Zaman ve maliyet beklentisi

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

Sırada ne var

• Yapay zekaya yazdır: kod bilmeden adım adım bot yazdırma rehberi ve hazır istem

• Kurulum: Windows, macOS ve Linux'ta Node.js veya Python hazırlığı

• Temel kavramlar: uygulama, bot, token, sunucu, rol, izin ve intent sözcüklerinin kısa özeti