n8n ile ilk lead akışını kurmak genellikle bir öğleden sonra sürer. Webhook düğümü formdan veriyi alır, birkaç Set ve IF düğümü alanları düzenler, bir HTTP Request düğümü kaydı CRM'e yazar, son düğüm de WhatsApp'tan karşılama mesajı gönderir. Akış çalışır, ekip mutlu olur. Sorunlar birkaç ay sonra başlar: biri akışı "küçük bir düzeltme" için editörde değiştirir ve kimse neyin değiştiğini bilmez; test için açılan kopya yanlışlıkla canlı CRM'e yazar; bir API anahtarının süresi dolar ve akış sessizce durur; lansman haftasında gelen yoğunlukta yürütmeler birikir.
Ben Koray Yalçın; lead yönetimi, CRM ve pazarlama otomasyonu altyapıları kuruyorum, ağırlıklı olarak gayrimenkul ve PropTech projelerinde. Bu projelerde n8n'i sık kullanıyorum, çünkü kendi sunucunuzda çalıştırabildiğiniz, kod düğümüyle esnetilebilen ve veriyi üçüncü bir SaaS'a taşımadan işleyebilen bir araç. Ama n8n'in görsel editörü, onu bir yazılım projesi gibi yönetmeniz gerektiği gerçeğini değiştirmez. Bu yazıda bir n8n workflow'unu "çalışan bir çizim"den "üretimde güvenle değiştirilebilen bir sisteme" taşımak için uyguladığım pratikleri anlatacağım: sürümleme, ortam ayrımı, kimlik bilgisi yönetimi, alt akışlara bölme, test verisi, gözlemlenebilirlik ve ölçekleme.
Hata yakalama ve yeniden deneme konularını daha önce ayrı ayrı yazdığım için burada yalnızca n8n'e özgü kısımlarına değineceğim.
Workflow bir koddur: JSON'u git'e koyun
n8n'de her workflow arka planda bir JSON belgesidir: düğümler, bağlantılar, parametreler ve ayarlar. Bu belge editörden indirilebilir ya da CLI ile dışa aktarılabilir. Üretim disiplininin ilk adımı, bu JSON'un tek doğru kaynağının veritabanı değil, bir git deposu olmasıdır.
Kendi kurulumlarımda düzenli bir dışa aktarma işi çalıştırıyorum:
# Tüm workflow'ları ayrı dosyalar halinde dışa aktar n8n export:workflow --all --separate --output=./workflows/ # Kimlik bilgilerini dışa aktarırken şifreli halde bırakın n8n export:credentials --all --separate --output=./credentials-encrypted/ git add workflows/ git commit -m "workflow snapshot $(date +%F)" Bu basit adım üç şey kazandırır. Birincisi, "geçen hafta bu akış neden farklı davranıyordu?" sorusunun cevabı artık bir git diff uzaklıktadır. İkincisi, bozulan bir değişiklik önceki sürüm içe aktarılarak geri alınabilir. Üçüncüsü, değişiklikler kod incelemesine girebilir; JSON görsel kadar okunaklı değildir ama bir düğümün URL'sinin ya da bir IF koşulunun değiştiğini açıkça gösterir.
Dikkat edilmesi gereken nokta: dışa aktarılan JSON'da düğüm konumları gibi gürültülü alanlar da bulunur. Diff'leri okunur tutmak için ben dışa aktarmadan sonra küçük bir betikle anahtarları sıralıyorum ve position gibi anlamsız değişiklikleri ayrı tutuyorum. n8n'in kurumsal sürümlerinde yerleşik bir git tabanlı kaynak kontrolü özelliği de var; kullanılabiliyorsa elle betik yazmaktan daha temiz bir yol.
Ortamları ayırın: geliştirme, hazırlık, canlı
En pahalı n8n hatası, test için yapılan bir çalıştırmanın canlı sisteme yazmasıdır. Gayrimenkul tarafında bunun anlamı, gerçek bir alıcıya "test" yazan bir WhatsApp mesajı gitmesi ya da bir danışmanın ekranına sahte bir lead düşmesidir.
Bunun çözümü tek bir n8n kurulumunda "dikkatli olmak" değil, ayrı kurulumlardır. En az iki örnek çalıştırıyorum: biri geliştirme ve deneme için, biri canlı. Her biri kendi veritabanına, kendi kimlik bilgilerine ve kendi webhook adresine sahip. Workflow JSON'u git'ten geliştirme ortamına, oradan canlıya aynı dosya olarak taşınır.
Aynı JSON'un iki ortamda farklı hedeflere gitmesini sağlamak için ortama bağlı değerleri düğümlerin içine sabit yazmıyorum. Bunun yerine ortam değişkenleri ve ifadeler kullanıyorum:
// HTTP Request düğümünde URL alanı (ifade) {{ $env.CRM_BASE_URL }}/api/leads // Code düğümünde: canlı dışında gerçek mesaj gönderme const isProd = $env.APP_ENV === 'production'; return items.map(item => ({ json: { ...item.json, whatsapp_to: isProd ? item.json.phone_e164 : $env.TEST_PHONE_E164, }, })); Geliştirme ortamında WhatsApp düğümü her zaman ekip içindeki bir test numarasına gider. Bu kuralı bir kişinin hatırlamasına değil, koda bağlamak gerekir. Ortam değişkenlerine erişimin kurulum ayarlarıyla kısıtlanabildiğini de unutmayın; hangi değişkenlerin akışlara açık olduğunu bilinçli seçin.
Kimlik bilgileri: düğümde değil, credential'da
Sık gördüğüm bir kalıp, API anahtarının HTTP Request düğümünün başlık alanına düz metin olarak yapıştırılmasıdır. Bu anahtar dışa aktarılan JSON'a, yani git'e, yani herkesin erişebildiği bir yere gider.
n8n'in credential sistemi tam olarak bunun için var: kimlik bilgileri şifreli saklanır, workflow JSON'unda yalnızca credential'ın adı ve kimliği görünür. Kurallarım basit:
- Hiçbir anahtar, token ya da şifre düğüm parametresine yazılmaz.
- Her ortamın kendi credential'ı vardır; canlı CRM anahtarı geliştirme örneğinde bulunmaz.
- Şifreleme anahtarı (
N8N_ENCRYPTION_KEY) her örnek için sabit ve yedeklidir. Bu anahtar kaybolursa veritabanındaki credential'lar okunamaz hale gelir. - Süresi dolan token'lar için takvim tutulur; akışın sessizce durmasını değil, önceden uyarı vermesini isterim.
Büyük akışı alt akışlara bölün
Tek ekranda kırk düğümlük bir lead akışı, ilk bakışta "her şey burada" hissi verir. Pratikte ise değiştirilmesi en korkulan şeydir. Ben lead akışlarını sorumluluklara göre bölüyorum ve Execute Workflow düğümüyle birbirine bağlıyorum:
- Giriş akışı: Webhook'u karşılar, isteği doğrular, ham veriyi kaydeder, hemen yanıt döner.
- Normalizasyon akışı: Telefonu E.164'e çevirir, kaynak adlarını standartlaştırır, eksik alanları işaretler.
- CRM yazma akışı: Tekilleştirme kontrolü yapar, kaydı oluşturur ya da günceller.
- Bildirim akışı: Danışmana görev açar, izin varsa müşteriye ilk mesajı gönderir.
Her alt akışın girişi ve çıkışı belli bir veri biçimidir. Bu bir sözleşmedir: normalizasyon akışı her zaman phone_e164, source, project_code alanlarını üretir; CRM yazma akışı bunları bekler. Sözleşme yazılı olduğunda bir akışı değiştirmek diğerlerini kırmaz. Ayrıca aynı normalizasyon akışını web formu, Meta lead formu ve portal e-postaları için tekrar kullanabilirsiniz; üç ayrı kopyanın zamanla birbirinden ayrışması sorunu ortadan kalkar.
Webhook'a hızlı cevap verin, işi sonra yapın
Lead kaynaklarının çoğu webhook gönderdikten sonra kısa bir süre cevap bekler; cevap gelmezse isteği tekrar gönderebilir. Webhook düğümünü bütün akış bitene kadar bekletirseniz, yavaş bir CRM API'si yüzünden aynı lead'i iki kez alabilirsiniz.
Bu yüzden giriş akışında Respond to Webhook düğümünü erken konumlandırıyorum: istek doğrulanır, ham veri kaydedilir, kaynağa başarılı yanıt döner, ağır iş bundan sonra başlar. Aynı isteğin tekrar gelme ihtimaline karşı ham kayıt tablosunda kaynak kimliği üzerinde tekillik kısıtı tutarım; ikinci istek veritabanı seviyesinde durur.
// Code düğümü: idempotency anahtarı üret const crypto = require('crypto'); return items.map(item => { const src = item.json.source; const ref = item.json.leadgen_id || item.json.form_submission_id; const key = ref ? `${src}:${ref}` : crypto.createHash('sha256') .update(`${src}:${item.json.phone}:${item.json.submitted_at}`) .digest('hex'); return { json: { ...item.json, idempotency_key: key } }; }); Code düğümünde require ile yerleşik modül kullanımı, kendi kurulumunuzda buna izin verilmesine bağlıdır; ayarları kontrol etmeden bu satırı kopyalamayın.
Test verisi: sabitlenmiş veri ve örnek kayıtlar
n8n'in en kullanışlı ama en az kullanılan özelliklerinden biri, bir düğümün çıktısını sabitlemektir (pinned data). Geliştirme sırasında webhook'u her seferinde gerçek bir form göndererek tetiklemek yerine, temsilî bir örnek kaydı sabitleyip akışın geri kalanını onunla çalıştırabilirsiniz.
Ben her lead akışı için küçük bir örnek kayıt seti tutuyorum ve bunları da git'te saklıyorum:
- Eksiksiz ve temiz bir web formu kaydı
- Ülke kodu olmayan bir telefon numarası
- Aynı kişinin ikinci başvurusu
- Pazarlama izni verilmemiş bir kayıt
- Beklenmeyen bir alan içeren yeni form sürümü
Bir değişiklik yapıldığında bu kayıtlar geliştirme ortamında akıştan geçirilir ve çıktılar beklenenle karşılaştırılır. Bu tam bir otomatik test altyapısı değildir ama "değiştirdim, umarım bir şey bozulmamıştır" yaklaşımından çok daha güvenlidir. Özellikle izin verilmemiş kaydın mesaj almadığını görmek, KVKK ve ticari ileti açısından önemlidir.
Gözlemlenebilirlik: yürütme geçmişi yetmez
n8n her yürütmeyi kaydeder ve editörde başarılı ve başarısız çalıştırmaları görebilirsiniz. Ama yoğun bir sistemde yürütme geçmişini saklama süresini kısaltmak zorunda kalırsınız; ayrıca "bugün kaç lead CRM'e yazıldı?" sorusunu yürütme listesinden cevaplamak zordur.
Bu yüzden iki ek katman kuruyorum:
Error workflow. Her üretim akışının ayarlarında bir hata akışı tanımlıdır. Bu hata akışı Error Trigger düğümüyle başlar, akış adını, başarısız düğümü ve yürütme bağlantısını ekip kanalına gönderir. Hata kimseye ulaşmıyorsa, sistem aslında hatasız değildir; sadece sessizdir.
İş seviyesinde log. Alt akışlar kritik adımlarda kendi tablolarına kısa bir satır yazar: lead kimliği, adım, sonuç, süre. Böylece bir danışman "bu lead bana neden gelmedi?" diye sorduğunda, cevabı yürütme geçmişinde aramak yerine tek bir sorguyla bulursunuz.
SELECT step, result, created_at FROM automation_log WHERE lead_id = 'L-2026-001234' ORDER BY created_at; Sessiz durmaları yakalamak için de bir "nabız" kontrolü ekliyorum: mesai saatlerinde belirli bir süre boyunca hiç lead yazılmamışsa uyarı gider. Hata vermeyen ama hiç çalışmayan bir akış, hata veren akıştan daha tehlikelidir.
Ölçekleme: kuyruk modu ne zaman gerekir?
Varsayılan kurulumda n8n yürütmeleri ana süreç içinde çalıştırır. Düşük ve düzenli trafikte bu yeterlidir. Bir konut projesinin lansmanında olduğu gibi kısa sürede yoğun lead geldiğinde ise uzun süren yürütmeler editörü ve webhook karşılamayı yavaşlatabilir.
n8n'in kuyruk modu (EXECUTIONS_MODE=queue) bu durumda devreye girer: ana süreç tetikleyicileri karşılar, yürütmeler Redis üzerinden ayrı worker süreçlerine dağıtılır. Worker sayısını artırarak yoğunluğu karşılayabilirsiniz. Ama kuyruk modu ek bir altyapı demektir: Redis, PostgreSQL ve birden fazla süreç. Ben bu adımı ihtiyaç ölçüldüğünde atıyorum; ilk günden kurmak bakım yükünü gereksiz yere artırır. Önce akışı hızlı yanıt veren ve ağır işi sonra yapan biçime getirmek çoğu zaman daha büyük kazanç sağlar.
Değişiklik süreci: küçük bir kontrol listesi
Üretimdeki bir akışı değiştirmeden önce uyguladığım adımlar şunlar:
- Değişiklik geliştirme ortamında yapılır, canlı editörde değil.
- Örnek kayıt seti akıştan geçirilir, çıktılar kontrol edilir.
- JSON dışa aktarılır, diff incelenir ve açıklayıcı bir mesajla commit edilir.
- Canlıya içe aktarma yoğun olmayan bir saatte yapılır.
- İlk gerçek lead'ler log tablosundan izlenir; sorun varsa önceki sürüm geri yüklenir.
Bu liste bürokrasi gibi görünebilir ama aslında tersini sağlar: değişiklik yapmaktan korkmazsınız, çünkü geri dönüş yolu bellidir.
Sık Sorulan Sorular
n8n workflow nedir?
n8n workflow, açık kaynaklı n8n otomasyon platformunda tetikleyici ve işlem düğümlerinden oluşan bir veri akışıdır. Bir olay (form gönderimi, webhook, zamanlayıcı) akışı başlatır, düğümler veriyi dönüştürür ve CRM, mesajlaşma ya da veritabanı gibi sistemlere yazar. Arka planda her workflow bir JSON belgesidir.
n8n workflow'ları nasıl sürümlenir?
En pratik yol, workflow'ları CLI ile ya da editörden JSON olarak dışa aktarıp bir git deposunda saklamaktır. Kurumsal sürümlerde yerleşik kaynak kontrolü özelliği de kullanılabilir. Önemli olan, tek doğru kaynağın elle düzenlenen canlı editör değil, depo olmasıdır.
Test ve canlı ortamı tek n8n kurulumunda ayırabilir miyim?
Teknik olarak workflow kopyalarıyla denenebilir ama riskli bir yoldur; kimlik bilgileri ve webhook adresleri karışır. Ayrı kurulumlar ve ortam değişkenleriyle aynı JSON'u farklı hedeflere yönlendirmek daha güvenlidir.
n8n'de API anahtarlarını nerede saklamalıyım?
Credential sisteminde. Anahtarı düğüm parametresine yazarsanız dışa aktarılan JSON'a ve dolayısıyla depoya girer. Şifreleme anahtarını da yedekleyin; kaybolursa kayıtlı credential'lar okunamaz.
Kuyruk moduna ne zaman geçmeliyim?
Yoğun dönemlerde webhook karşılama ve editör yavaşlıyorsa ve bunu ölçtüyseniz. Önce akışları hızlı yanıt verip ağır işi sonra yapacak biçimde düzenlemek çoğu zaman yeterli olur; kuyruk modu Redis ve worker süreçleri gibi ek bakım getirir.
n8n mi, Make mi, Zapier mi?
Bu araçların hepsi iş görür; seçim veri nerede tutulmalı, ne kadar özel kod gerekiyor ve kim bakım yapacak sorularına bağlıdır. Kendi sunucunuzda çalıştırma ve kod düğümüyle esneklik öncelikliyse n8n öne çıkar. Hangi aracı seçerseniz seçin, bu yazıdaki sürümleme, ortam ayrımı ve gözlemlenebilirlik ilkeleri aynen geçerlidir.
Son söz
n8n'in görsel editörü otomasyonu hızlı başlatmayı kolaylaştırır, ama üretimde güvenilirliği editör değil, etrafına kurduğunuz disiplin sağlar. Workflow'u kod gibi sürümlemek, ortamları ayırmak, kimlik bilgilerini doğru yerde tutmak, akışı sözleşmeli parçalara bölmek ve hem hataları hem sessizliği izlemek; bunlar bir lead akışını lansman haftasında da ayakta tutan temel parçalar. Bir akışı rahatça değiştirebiliyorsanız, o akış gerçekten sizin kontrolünüzdedir.
