Webhook testte çalışıyor ama üretimde çalışmıyor: kontrol listesi

Testte güvenilir şekilde tetiklenen ama üretimde artık istek almayan bir n8n webhook'unun neredeyse her zaman üç nedenden biri vardır: workflow etkinleştirilmemiştir ve bu nedenle production URL hiç kaydedilmemiştir; WEBHOOK_URL ortam değişkeni bir reverse proxy arkasında yanlış ayarlanmıştır ya da hiç ayarlanmamıştır; ya da n8n'in her webhook node için ayrı ayrı verdiği test URL ile production URL arasında bir karışıklık vardır. Sorun giderme mantıklı bir şekilde sabit bir sıra izler: önce harici uygulamada hangi URL'nin kayıtlı olduğunu kontrol edin, ardından workflow'un aktivasyon durumunu, ardından proxy ve ortam değişkeni yapılandırmasını. Güncelleme: Temmuz 2026.

Test URL ile production URL neden farklıdır?

n8n her webhook node için teknik olarak farklı davranan iki ayrı URL oluşturur. Test URL yalnızca editörde "Listen for test event" tıklandığında etkinleşir ve n8n dokümantasyonuna göre yalnızca 120 saniye boyunca istek almaya hazır kalır, gelen veriler doğrudan editörde görünür. Production URL ise ancak workflow yayınlanıp etkinleştirildiğinde kaydedilir. Ardından kalıcı olarak çalışır, ancak gelen verileri artık editörde değil, yalnızca Executions sekmesinde gösterir. CRM, bir form aracı veya bir ödeme platformu gibi harici bir uygulamayı yanlışlıkla test URL'sine bağlayan kişi, testte her şey çalışmış olsa bile en geç 120 saniye sonra artık yanıt alamaz.

Workflow gerçekten etkin mi?

Sessiz kalan bir production webhook'unun en yaygın nedeni, etkin duruma getirilmemiş bir workflow'dur. Production URL yalnızca workflow'u kaydedip editördeki aktivasyon düğmesi üzerinden yayınladığınızda kaydedilir; n8n ancak o zaman bu adrese gelen istekleri kabul eder. Workflow daha sonra düzenlenirse, test amacıyla devre dışı bırakılırsa veya yanlışlıkla kapatılırsa, production URL hiçbir uyarı vermeden ortadan kalkar, harici uygulamaya herhangi bir hata mesajı gitmez; çağrı basitçe boşa gider. Bu nedenle proxy veya ağ ayarlarında daha derine inmeden önce önce workflow editörünün sağ üst köşesindeki aktivasyon durumunu kontrol edin.

İsteği bir yol veya yöntem çakışması mı engelliyor?

İkinci, daha az fark edilen bir neden ise yol ve yöntem eşleştirmesindedir. Dokümantasyona göre n8n, yol ve HTTP yöntemi kombinasyonu başına yalnızca bir webhook'un kaydedilmesine izin verir; iki etkin workflow aynı yola ayarlanmışsa, önce kaydedilen ikincisini engeller. Yanlış bir HTTP yöntemi de hataya yol açar: bir webhook node, node ayarlarında "Allow Multiple HTTP Methods" seçeneğini etkinleştirmediğiniz sürece varsayılan olarak yalnızca GET veya POST kabul eder, ikisini aynı anda değil. Harici hizmet istek yöntemini değiştirirse, workflow'da tanınabilir bir hata mesajı olmadan bağlantı kesilir.

WEBHOOK_URL reverse proxy arkasında doğru ayarlanmış mı?

n8n kendi sunucunuzda barındırılıyor ve Nginx, Traefik veya Caddy gibi bir reverse proxy arkasında çalıştırılıyorsa, yanlış ayarlanmış bir WEBHOOK_URL en yaygın teknik nedendir. n8n normalde webhook adresini N8N_PROTOCOL, N8N_HOST ve N8N_PORT değişkenlerinden otomatik olarak oluşturur; n8n dokümantasyonuna göre bu, bir proxy arkasında çalışmaz, çünkü n8n dahili olarak 5678 portunda çalışırken proxy uygulamayı dışarıya 443 portu üzerinden sunar. Bu nedenle WEBHOOK_URL'yi manuel olarak ayarlamanız, ayrıca N8N_PROXY_HOPS değişkenini önündeki proxy sayısına ayarlamanız ve son proxy'de X-Forwarded-For, X-Forwarded-Host ve X-Forwarded-Proto başlıklarını iletmeniz gerekir. N8N_PROXY_HOPS eksikse, n8n gerçek gönderen IP'sini doğru şekilde algılayamadığından webhook'lar için IP beyaz liste kuralları da başarısız olabilir. Bu yapılandırmayı sürekli olarak kendileri yönetmek istemeyen şirketler için NordFlux, n8n otomasyonu hizmeti kapsamında sabit fiyatlı bir projenin parçası olarak sunucu ve proxy kurulumunu üstlenir.

Nedenleri hangi sırayla kontrol etmelisiniz?

Ayrıntılı aramaya geçmeden önce, dört en olası nedenin mantıklı bir sırayla kısaca karşılaştırılması yardımcı olur.

• URL türü: Harici uygulamada gerçekten production URL mi kayıtlı, yoksa test URL mi?
• Aktivasyon: Workflow editörde etkinleştirilmiş mi ve son değişiklikten sonra tekrar kaydedilmiş mi?
• Yol çakışması: Başka hiçbir etkin workflow aynı yolu ve aynı HTTP yöntemini kullanmıyor mu?
• WEBHOOK_URL: Bir reverse proxy arkasında çalışırken ortam değişkeni manuel olarak ayarlanmış mı ve genel alan adıyla eşleşiyor mu?

Yalnızca bu dört nokta doğrulandıktan ve webhook hâlâ yanıt vermediğinde, güvenlik duvarı kurallarında, DNS kayıtlarında veya barındırma sağlayıcısında arama yapmaya değer.

Üretimde n8n webhook'ları hakkında sık sorulan sorular

Webhook yaklaşık iki dakika sonra neden isteklere yanıt vermeyi durduruyor?

Muhtemelen hâlâ test URL'si kullanıldığı için: bu URL, "Listen for test event" tıklandıktan sonra yalnızca 120 saniye boyunca istek almaya hazır kalır. Kalıcı çalışma için, workflow etkinleştirildikten sonra kaydedilen production URL'ye ihtiyacınız vardır. Kayıtlı URL'yi değiştirin ve editördeki aktivasyon durumunu kontrol edin.

Production URL çalışmadan önce workflow'u kaydetmem gerekir mi?

Evet, production URL yalnızca workflow kaydedilip etkinleştirildiğinde, yani yayınlandığında kaydedilir. Bu adım olmadan, workflow testte hatasız çalışmış olsa bile n8n bu adrese hiçbir istek kabul etmez. Webhook node'unda her içerik değişikliğinden sonra workflow'u tekrar kaydetmeli ve aktivasyonu kontrol etmelisiniz.

İki workflow aynı webhook yolunu kullanabilir mi?

Hayır, n8n yol ve HTTP yöntemi kombinasyonu başına yalnızca bir webhook kaydeder. İkinci bir etkin workflow aynı yola ve aynı yönteme ayarlanmışsa, önce kaydedilen workflow ikincisini engeller. Bu durumda benzersiz yollar atayın veya artık ihtiyaç duyulmayan workflow'u devre dışı bırakın.

n8n Nginx veya Traefik arkasında çalışıyorsa ve görüntülenen webhook URL'si yanlışsa ne yapmalıyım?

WEBHOOK_URL ortam değişkenini manuel olarak herkese açık erişilebilir alan adına ayarlayın, çünkü aksi takdirde n8n adresi dahili olarak protokol, host ve porttan oluşturur ve genel adres yerine dahili 5678 portunu kullanır. Ayrıca N8N_PROXY_HOPS'u önündeki proxy sayısına ayarlayın ve son proxy'nin X-Forwarded-For, X-Forwarded-Host ve X-Forwarded-Proto başlıklarını ilettiğinden emin olun. Değişiklikten sonra n8n yeniden başlatılmalıdır.