n8n ile İlk İş Akışınızı Oluşturma: Başlangıç Rehberi

n8n ilk iş akışı n8n'de ilk iş akışını oluşturmak; bir trigger seçmek, aksiyon node'ları eklemek ve test çalıştırması yapmak kadar basittir. Bu rehber, Cloud veya self-host seçiminden başlayarak ilk otomasyonunuzu yayına almanıza kadar tüm süreci adım adım anlatır.

Başlamadan Önce: Cloud mu, Self-Host mu?

n8n'e başlamanın en hızlı yolu n8n Cloud üzerinden hesap açmaktır; self-hosting tercih edenler için Docker ile birkaç dakikada kurulum yapılabilir. Hangi yolu seçeceğiniz, veri gizliliği gereksinimlerinize ve teknik ekip kapasitesine göre değişir.

n8n nedir sorusunu daha önce yanıtladıysak, şimdi pratik adıma geçme zamanı. Platform, iki temel dağıtım modeliyle gelir: n8n Cloud ve self-hosted. Cloud seçeneğinde hesap oluşturur oluşturmaz tarayıcınızda iş akışı oluşturmaya başlarsınız; altyapı yönetimiyle uğraşmanıza gerek kalmaz. Ücretsiz deneme planı, temel özelliklerin tamamını kapsar ve kısa sürede üretime hazır bir senaryo denemenize olanak tanır.

Self-hosted kurulumda ise verileriniz tamamen kendi sunucularınızda kalır; bu, finansal ve sağlık sektöründeki kurumlar için kritik bir avantajdır. Docker ile n8n kurulumu konusunu detaylı ele aldığımız rehberimizde, tek komutla nasıl çalıştırılacağını ve ortam değişkenlerinin nasıl yapılandırılacağını bulabilirsiniz. Hangi yolu seçerseniz seçin, arayüz ve iş akışı mantığı aynıdır; bu rehberdeki adımlar her iki ortamda da geçerlidir.

Arayüz ve Temel Kavramlar

n8n arayüzü; workflow tuvali, node paneli ve execution geçmişinden oluşur. Node'lar iş akışının adımlarını, trigger ise başlangıç noktasını temsil eder; connection'lar node'lar arasında veri taşır.

n8n'i ilk açtığınızda boş bir tuval sizi karşılar. Sol üstte 'Add First Step' düğmesine tıkladığınızda node kütüphanesi açılır. Bu kütüphanede 400'den fazla entegrasyon yer alır; arama kutusuyla ihtiyacınız olan uygulamayı saniyeler içinde bulabilirsiniz.

Tuval üzerinde bir node'u sürükleyip bırakarak konumlandırabilir, çıkış noktasından çekerek bağlantı oluşturabilirsiniz. Node'a çift tıkladığınızda sağ panelde parametreleri düzenlersiniz. Üst menüdeki 'Executions' sekmesi, geçmiş tüm çalışmaların log kaydını gösterir; hata ayıklamada bu ekran en çok kullanacağınız yerdir.

İlk İş Akışı: Adım Adım

İlk workflow için Schedule Trigger → HTTP Request → Gmail Send zinciri ideal başlangıç noktasıdır. Bu üç adımlı yapı; zamanlama, dış API çağrısı ve bildirim gönderme kavramlarını aynı anda öğretir.

Yeni bir workflow açın ve 'Add First Step' ile trigger seçim ekranını açın. 'Schedule' trigger'ını seçip her gün saat 09:00'da çalışacak şekilde yapılandırın; cron ifadesi olarak '0 9 * * *' yazabilirsiniz. Trigger ayarlandığında üzerinde küçük bir saat simgesi belirir.

HTTP Request Node Ekleme

Trigger'ın sağ çıkış noktasından çekerek 'HTTP Request' node'unu ekleyin. URL alanına örnek olarak 'https://jsonplaceholder.typicode.com/todos/1' yazın; method olarak GET seçin. Bu adres, gerçek bir API uç noktasını simüle eden ücretsiz bir test servisidir ve kimlik bilgisi gerektirmez.

Gmail Node ile Bildirim Gönderme

HTTP Request node'unun çıkışına 'Gmail' node'unu bağlayın. 'Send Message' operasyonunu seçin. 'To' alanına alıcı e-posta adresini girin. Subject alanına 'Günlük API Raporu' yazın. Body alanında bir sonraki bölümde ele alacağımız expression sözdizimini kullanarak HTTP yanıtından veri çekeceksiniz. Şimdilik sabit bir metin de girebilirsiniz.

1. Yeni workflow oluşturun (sol üstteki '+' veya 'New Workflow' butonu).
2. Schedule Trigger ekleyin ve sıklığı ayarlayın.
3. HTTP Request node'unu bağlayın, URL ve method girin.
4. Gmail node'unu bağlayın, Gmail credentials seçin.
5. Üst sağdaki 'Test Workflow' düğmesine tıklayın.
6. Her node'un üzerinde yeşil onay simgesi görünmesini bekleyin.
7. Execution log'unda yanıt verisini inceleyin.

Credentials Ekleme ve Test Etme

n8n'de credentials, API anahtarları ve OAuth tokenlarını şifreli biçimde saklayan merkezi bir kimlik yönetim sistemidir. Bir credentials tanımı oluşturulduktan sonra aynı türdeki tüm node'larda yeniden kullanılabilir.

Gmail node'unu yapılandırırken 'Credential for Gmail' alanının yanındaki '+ Add' düğmesine tıklayın. Açılan ekranda 'Sign in with Google' seçeneğini kullanarak OAuth akışını başlatın. Tarayıcınızda Google hesabı yetkilendirme sayfası açılır; izin verdikten sonra n8n otomatik olarak token'ı saklar. Bu token AES-256 şifrelemesiyle depolanır ve hiçbir zaman düz metin olarak görüntülenmez.

Credentials'ı başarıyla ekledikten sonra node parametrelerinde seçili hale gelir. Üst sağ köşedeki 'Test Workflow' düğmesine tıklayarak anlık bir test çalıştırması yapabilirsiniz. Her node, çalıştırıldıktan sonra yeşil bir tik simgesiyle başarıyı ya da kırmızı bir ünlem simgesiyle hatayı gösterir. Hata durumunda node'a tıklayarak ayrıntılı hata mesajını ve gelen/giden veri yapısını görebilirsiniz.

• Credentials Settings ekranına sol menüdeki 'Settings > Credentials' yolundan da ulaşabilirsiniz.
• Aynı credentials birden fazla workflow'da paylaşılabilir; değiştirildiğinde tüm workflow'lar güncellenir.
• Takım çalışmasında credentials, rol tabanlı erişim kontrolüyle paylaşılabilir.
• Süresi dolan OAuth token'lar için n8n otomatik yenileme (refresh) mekanizmasını destekler.

Expressions ve Veri Akışı

n8n expressions, önceki node'lardan gelen JSON verisine {{ $json.fieldName }} sözdizimi ile erişmenizi sağlar. Bu sayede her node, bir önceki adımın çıktısını dinamik olarak kullanabilir.

Bir node'un herhangi bir metin alanına yazmaya başladığınızda, sağ tarafta küçük bir '/' veya '{{ }}' simgesi belirir. Bu simgeye tıklandığında Expression Editor açılır. Editor'da mevcut node'un aldığı tüm veriyi ağaç yapısında görebilir, tıklayarak sütun adlarını otomatik tamamlayabilirsiniz.

HTTP Request node'undan dönen bir JSON yanıtı şu yapıda olsun: { "id": 1, "title": "Görev başlığı", "completed": false }. Gmail node'unun Subject alanına '{{ $json.title }}' yazdığınızda, e-postanın konusu otomatik olarak 'Görev başlığı' olur. Birden fazla node içeren bir akışta önceki node'lardan veri almak için '{{ $node["HTTP Request"].json.title }}' sözdizimini kullanırsınız.

• {{ $json.fieldName }} — mevcut node'a gelen verinin bir alanı
• {{ $node["NodeAdı"].json.fieldName }} — belirli bir node'un çıktısından alan
• {{ $now.toISO() }} — anlık zaman damgası (ISO 8601)
• {{ $workflow.name }} — mevcut workflow adı
• {{ $itemIndex }} — döngüdeki öğenin sıra numarası

Expression'lar yalnızca metin alanlarında değil, sayı ve boolean alanlarında da kullanılabilir. Örneğin bir koşul node'unda '{{ $json.completed }}' ifadesi doğrudan boolean karşılaştırması yapar. Hatalı bir expression kırmızıyla vurgulanır ve beklenen veri yapısını görmek için 'Test' butonuna basabilirsiniz.

Hata Ayıklama ve Yayına Alma

Execution log, her çalışmada node bazında giriş ve çıkış verisini, hata mesajlarını ve süreyi gösterir. Workflow'u aktive etmek için sağ üstteki 'Inactive' toggle'ını 'Active' konumuna getirmek yeterlidir.

Üst menüdeki 'Executions' sekmesine geçtiğinizde tüm geçmiş çalışmaları listede görürsünüz. Her satırda çalışma zamanı, durum (başarılı/başarısız) ve toplam süre yer alır. Bir çalışmaya tıkladığınızda workflow'un o anki görünümü açılır ve her node'un üzerinde giriş/çıkış veri miktarı yazılıdır. Başarısız node kırmızı kenarlıkla gösterilir; tıkladığınızda tam hata mesajını ve stack trace'i okuyabilirsiniz.

Hata ayıklama sürecinde 'Pin Data' özelliği büyük kolaylık sağlar: bir node'un çıktısını sabitlediğinizde, sonraki test çalışmalarında o node tekrar tetiklenmez ve downstream node'lar sabit veriyle test edilir. Bu, API limitlerini aşmadan geliştirme yapmanızı sağlar.

Workflow'u yayına almak için sağ üstteki 'Inactive' toggle'ına tıklayın; 'Active' konumuna gelir ve Schedule Trigger'ınız belirlediğiniz saatte otomatik olarak çalışmaya başlar. Webhook tabanlı trigger'larda aktive eder etmez n8n bir URL üretir ve o URL'e gelen istekleri dinlemeye başlar.

• Bir workflow'u aktive etmeden önce mutlaka test çalıştırması yapın.
• Kritik production workflow'ları için Error Trigger node'u ile hata bildirim akışı kurun.
• Execution geçmişini 'Settings > Executions' ekranından saklama süresi belirleyerek yönetin.
• Büyük veri akışlarında 'Split In Batches' node'unu kullanarak bellek kullanımını optimize edin.

Sonraki Adımlar: AI Entegrasyonu ve Webhook

Temel workflow'u tamamladıktan sonra n8n'in AI agent desteği ve webhook yetenekleri ile çok daha güçlü otomasyon senaryoları kurabilirsiniz. Bu iki alan, kurumsal otomasyonun en yüksek değer ürettiği noktalarıdır.

n8n, büyük dil modelleriyle (LLM) doğal entegrasyon sağlar. n8n ile AI agent kurulumu rehberimizde, OpenAI veya yerel bir modeli kullanarak kendi verileriniz üzerinde akıl yürüten bir otomasyon sistemi nasıl kurarsınız adım adım anlatılmaktadır. Müşteri taleplerini sınıflandıran, rapor özeten veya anomali tespit eden akıllı iş akışları artık n8n'de kod yazmadan oluşturulabilir.

Webhook entegrasyonu ise dış sistemlerin n8n'i tetiklemesine olanak tanır; form gönderimi, ödeme bildirimi veya CRM güncellemesi gibi olaylar anında bir iş akışını başlatabilir. n8n Webhook ve API entegrasyonu konusunu derinlemesine ele aldığımız içeriğimizde, HTTP node'un tüm yeteneklerini ve güvenli webhook tasarımını bulabilirsiniz.

Başlangıç noktası olarak n8n'in 1.700'den fazla topluluk şablonuna göz atmanızı öneririz. Şablonlar; belirli bir entegrasyon veya senaryo için hazır node yapılandırmaları içerir ve tek tıkla workflow'unuza içe aktarılabilir. Bu sayede sıfırdan başlamak yerine çalışan bir örneği inceleyerek kendi senaryonuza uyarlayabilirsiniz.

Sık Sorulan Sorular

n8n'e nasıl başlanır?

En hızlı yol n8n.io üzerinden Cloud hesabı açmaktır; e-posta ile kayıt yaptırdıktan sonra tarayıcıda iş akışı oluşturmaya hemen başlayabilirsiniz. Self-hosting tercih edenler için Docker ile tek komutla kurulum yapılabilir.

n8n kullanmak için kod bilmek gerekiyor mu?

Hayır. n8n'in görsel arayüzü sayesinde çoğu otomasyon senaryosu kod yazmadan oluşturulabilir. İleri düzey kullanım için JavaScript destekli Code node da mevcuttur; ancak başlangıç için zorunlu değildir.

İlk workflow nasıl oluşturulur?

Yeni bir workflow açın, trigger node ekleyin (Schedule, Webhook veya Manual), ardından aksiyon node'larını zincirleyin. Test Workflow düğmesiyle anlık çalıştırma yapın, execution log'unda sonuçları inceleyin ve hata yoksa aktive edin.

Workflow'u yayına almadan nasıl test ederim?

Sağ üstteki 'Test Workflow' düğmesi workflow'u aktive etmeden tek seferlik çalıştırır. Her node'un girdi ve çıktısını tuval üzerinde görebilir, hataları inceleyebilir ve Pin Data özelliğiyle belirli node'ların çıktısını sabitleyebilirsiniz.

n8n'de hazır şablonlar var mı?

Evet. n8n'in şablon kütüphanesinde 1.700'den fazla topluluk tarafından hazırlanmış iş akışı mevcuttur. Sol menüdeki 'Templates' sekmesinden veya n8n.io/workflows adresinden kategoriye göre arama yapabilirsiniz.

Workflow nasıl aktive edilir?

Workflow düzenleme ekranının sağ üst köşesindeki 'Inactive' toggle'ına tıklamak yeterlidir. 'Active' konumuna geçer ve trigger türüne göre zamanlama veya webhook dinleme otomatik başlar. Aktive etmeden önce başarılı bir test çalıştırması yapılması önerilir.

n8n öğrenmek için hangi kaynakları kullanabilirim?

Resmi dokümantasyon docs.n8n.io, topluluk forumu community.n8n.io ve YouTube kanalındaki video eğitimler en iyi başlangıç noktalarıdır. Ayrıca şablon kütüphanesindeki örnekler gerçek workflow yapılarını incelemenin en pratik yoludur.

Sonuç

n8n ile ilk iş akışını oluşturmak, birkaç temel kavramı öğrendikten sonra oldukça hızlı ilerleyen bir süreçtir. Cloud veya Docker ile kurulumdan başlayarak trigger, node, credentials ve expression mantığını kavradığınızda, üretim düzeyinde otomasyonlar kurmak için gereken temeli atmış olursunuz. Execution log ve test mekanizmaları, hataları erken yakalamayı ve güvenli bir şekilde yayına almayı kolaylaştırır.

Daha karmaşık senaryolara geçmek veya mevcut kurumsal sistemlerinizle n8n entegrasyonunu planlamak istiyorsanız, Sora otomasyon ekibimiz deneyimli danışmanlarıyla ücretsiz keşif görüşmesi için hazır. Finans, üretim veya kamu sektörüne özel otomasyon mimarileri konusunda destek almak için bugün iletişime geçin.