Uygulamaları, API’leri ve AI modellerini görsel workflow’larla bağla.
Node, trigger, credential, webhook, HTTP Request, AI Agent, insan onayı, hata yönetimi ve güvenli yayınlama mantığı adım adım açıklanır.
n8n nedir?
n8n, bir olay gerçekleştiğinde veriyi alıp bir dizi node üzerinden işleyen görsel otomasyon platformudur. Form, webhook, zamanlayıcı veya uygulama olayı workflow’u başlatabilir; sonraki node’lar veriyi dönüştürür, API çağrısı yapar, AI modeline gönderir veya başka bir sisteme yazar.
Bir node tek işi yapar. Güvenilir otomasyon, her node’un girişini ve çıktısını açık tutar.
Temel kavramlar
| Kavram | Açıklama | Örnek |
|---|---|---|
| Trigger | Workflow’u başlatan olay. | Webhook, zaman, yeni e-posta. |
| Node | Tek bir işlem adımı. | HTTP Request, Set, IF. |
| Credential | Bağlantı kimlik bilgileri. | API anahtarı, OAuth hesabı. |
| Execution | Workflow’un bir çalışması. | Başarılı veya hatalı çalışma kaydı. |
| Expression | Önceki node verisini dinamik kullanma. | {{$json.email}} |
Yerel öğrenme ortamı
n8n’i öğrenmek için yerel bilgisayarda çalıştırabilirsin. Bu yöntem dışarıdan erişilebilir webhook gerektiren gerçek yayın senaryoları için tek başına yeterli değildir; ancak node ve veri akışını öğrenmek için uygundur.
node --version npm --version npx n8n
npm install -g n8n n8n start
Başladıktan sonra editör çoğunlukla http://localhost:5678 adresinde açılır. Terminali kapatırsan süreç durur.
İlk workflow: Webhook → yanıt
Boş canvas aç ve anlaşılır bir isim ver.
Test URL ile POST isteği kabul et.
Gelen veriden yalnızca gerekli alanları seç.
Kullanıcıya kontrollü JSON yanıtı döndür.
Örnek veri gönder, her node’un çıktısını ayrı ayrı incele.
Workflow’u aktive ettikten sonra üretim URL’sini kullan.
{
"name": "Görkem",
"task": "Promptumu iyileştir"
}HTTP Request ile API bağlantısı
HTTP Request node, REST API’lerine GET, POST, PUT, PATCH veya DELETE isteği göndermek için kullanılır. URL, method, header, query ve body alanlarını API dokümanına göre yapılandır.
Mümkünse credential alanını kullan; anahtarı node içine düz metin yazma.
API sözleşmesindeki endpoint ile eşleştir.
Önceki node alanlarını expression ile body’ye yerleştir.
4xx ve 5xx sonuçlarında yeniden deneme veya hata akışı belirle.
Anahtarı ekran görüntüsünde, workflow JSON’unda veya GitHub repository’sinde paylaşma.
AI Agent nasıl çalışır?
AI Agent node, dil modelini bir veya daha fazla araçla birleştirerek hangi aracı ne zaman kullanacağına karar verebilir. Basit metin üretimi için agent kullanmak şart değildir; yalnızca araç seçimi veya çok adımlı karar gerektiğinde kullan.
E-posta okuması gereken ajana silme yetkisi vermek gibi geniş izinlerden kaçın.
Claude, OpenAI, Codex ve GitHub bağlantıları
n8n içinde model sağlayıcı node’ları veya HTTP Request ile API çağrıları kullanılabilir. Codex ve Claude Code ise çoğunlukla geliştirici iş akışında repository üzerinde çalışır; n8n, issue oluşturma, görev kuyruğu, onay, bildirim ve raporlama katmanını yönetebilir.
| Bağlantı | n8n’in rolü | Örnek |
|---|---|---|
| GitHub | Trigger ve kayıt sistemi | Yeni issue veya pull request geldiğinde akış başlat. |
| Claude/OpenAI API | Metin analizi ve sınıflandırma | Issue önem derecesi üret. |
| Claude Code / Codex | Repository üzerinde geliştirme | İnsan onayından sonra görev ayrıntısını ajana aktar. |
| Slack/E-posta | Bildirim ve onay | Riskli değişikliği ekip liderine gönder. |
Hata ve yeniden deneme tasarımı
Gerçek otomasyonlarda ağ kesintisi, kota, yetki ve veri biçimi hataları normaldir. Başarılı akış kadar hata akışı da tasarlanmalıdır.
Güvenlik kontrol listesi
- n8n editörünü doğrudan internete açık ve şifresiz bırakma.
- Credential’ları node içine düz metin olarak koyma.
- Webhook girişlerini doğrula; beklenmeyen alanları reddet.
- AI çıktısını SQL, e-posta, ödeme veya silme işlemine doğrudan bağlama.
- Workflow JSON’unu paylaşmadan önce credential ve kişisel veri kontrolü yap.
- Yerleşik güvenlik denetimini ve güncel sürüm notlarını takip et.
Modelin ürettiği komut, e-posta adresi, URL veya karar doğrulanmadan kritik işlemde kullanılmamalıdır.
Hazır workflow fikirleri
PROMPTLA’ya eklenen şablonlar; GitHub issue analizi, prompt iyileştirme, içerik üretimi, CV değerlendirme, destek ajanı ve kod inceleme bildirimi gibi senaryoları kapsar.