n8n’de Webhook Kurulumu: 10 Dakikada İlk API Bağlantınızı Yapın

n8n’de Webhook Kurulumu: 10 Dakikada İlk API Bağlantınızı Yapın başlıklı bu rehberde, webhook kurulumunda en sık karşılaşılan ve “Çağrılar n8n’e ulaşmıyor” şeklindeki pratik problemi ele alacağız. Amacımız kısa sürede çalışan bir webhook oluşturup ilk API bağlantınızı başarıyla gerçekleştirebilmeniz için ihtiyaç duyacağınız adımları, karar noktalarını ve hızlı kontrol listesini vermek.

Asıl problem ne?

Çoğu kullanıcı için tek ve net problem şu: Üçüncü taraf servislerden gönderilen webhook çağrıları n8n workflow’una ulaşmıyor veya n8n, gelen çağrıyı işleyemiyor. Bu, genellikle “webhook URL yanlış”, “n8n dinlemiyor” veya “güvenlik/format uyumsuzluğu” gibi nedenlerden kaynaklanır. Sorun gözle görülür: servis başarılı yanıt alıyor gibi görünse de n8n hiçbir veri almıyor ya da işlenen veri hatalı.

Neden oluyor?

Sık görülen sebepler:

• Workflow aktif değil: n8n’de webhook node’u yalnızca workflow aktif/çalışır durumda olduğunda dinler. Sadece düzenleme modunda açık olan workflow’lar genelde webhook çağrılarını yakalamaz.
• Yanlış URL / yol eşleşmesi: Webhook URL’sindeki patika (path) veya ID yanlış kopyalanmış olabilir.
• Yerel çalışma ortamı (NAT/Firewall): Bilgisayarınız veya yerel ağınız doğrudan internetten erişilebilir değil; servisler çağrıyı gönderemiyor.
• HTTPS/SSL eksikliği: Birçok servis sadece HTTPS endpoint’lerine çağrı gönderir; yerel HTTP adresleri reddedilir.
• Method / Content-Type uyuşmazlığı: Gönderilen HTTP yöntemi (GET/POST) veya Content-Type (application/json vs form-data) beklenenden farklı.
• Güvenlik doğrulaması (header, token, HMAC) yanlış: Servis doğrulama başlığı veya imzayı göndermiyor ya da n8n bu doğrulamayı beklemiyor.
• Timeout / Rate limit / Yanıt kodu: Webhook çağrısı başarılı görünse de n8n’de hata alınıyor ya da 5xx dönülüyor.
• Payload beklenen formatta değil: JSON parse hataları veya gereksiz paketlenmiş yapı.

Bu maddeler tek tek veya kombinasyon halinde çağrıların n8n’e ulaşmamasına yol açar.

Nasıl çözülür?

Aşağıda adım adım, 10 dakikada çalışan bir webhook kurulumunu nasıl gerçekleştireceğinizi gösteriyorum. Her adımın sonunda kısa bir kontrol noktası olacak.

Bu konuyla ilgili tamamlayici bilgi icin Webhook Nedir? n8n ile Uygulamalı Kullanım rehberini de inceleyebilirsiniz.

Adım 1: Webhook Node’u oluşturun ve URL’i alın

1. n8n’de yeni bir workflow oluşturun.
2. Webhook node’u ekleyin (HTTP Method: genelde POST).
3. Webhook node’un özelliklerinden “Copy Webhook URL” seçeneğiyle tam URL’i kopyalayın.

Kontrol: Kopyaladığınız URL’yi not edin. Node aktif değilse, bu URL yine de görünür ama çağrıyı yakalamak için workflow’un aktif olması gerekir.

Adım 2: Test ortamı seçimi — Yerel mi, tünel mi, sunucu mu?

• Hızlı test için: ngrok veya benzeri bir tünel aracı kullanın (ör. `ngrok http 5678`). Bu şekilde yerel n8n örneğinize güvenli HTTPS üzerinden ulaşılır.
• Üretim / paylaşılan hizmet: n8n’yi sunucuya kurun veya n8n Cloud gibi yönetilen hizmet kullanın; böylece sabit URL/sertifika ve güvenlik sağlar.

Kontrol: Eğer ngrok kullanıyorsanız, ngrok’un verdiği HTTPS URL’sinin webhook URL ile eşleştiğinden emin olun.

Adım 3: Doğrulama — Method, Headers, Payload

• Üçüncü taraf serviste methodu ve Content-Type’ı doğru ayarlayın (ör. POST + application/json).
• n8n içinde gelen raw veriyi görmek için webhook node’da “Response Mode” veya debug çıkışını kullanın.
• Örnek test: terminalde

curl -X POST ‘https://sizin-url.ngrok.io/webhook/abcdef’ -H ‘Content-Type: application/json’ -d ‘{“name”:”test”}’

Kontrol: n8n webhook node’u gelen isteği kaydediyor mu? Node’u çalıştırıp “Incoming Request” verisini kontrol edin.

Bu konuyla ilgili tamamlayici bilgi icin Dijital Asistan Kullanımıyla Haftada 5–10 Saat Nasıl Kazanılır? rehberini de inceleyebilirsiniz.

Adım 4: Güvenlik — Hangi doğrulamayı kullanacaksınız?

• Basit durum: gizli bir header (X-Webhook-Token) kullanıp n8n’de bu değeri kontrol edin.
• Daha güvenli: HMAC imzası kullanarak payload bütünlüğünü doğrulayın.
• IP beyaz liste gerekiyorsa: üçüncü taraf servisin IP aralığını alın veya ara sunucu kullanın.

Kontrol: Güvenlik mekanizması test edildiğinde yetkisiz istekler reddedilmeli, yetkili olanlar kabul edilmeli.

Adım 5: Aktif et ve monitor et

• Workflow’u aktif hale getirin. n8n Cloud veya kendi sunucunuzda “Active” duruma getirmek webhook’un sürekli dinlemesini sağlar.
• İlk birkaç çağrıyı test ettikten sonra n8n loglarını izleyin (console/log dosyaları) ve webhook node sonuçlarını kontrol edin.

Kontrol: Aktif workflow durumunda dışarıdan yapılan çağrıların her biri workflow tarafından işleniyor mu?

Adım 6: Hata ayıklama

• 404/410 gibi kodlar alıyorsanız URL veya aktivasyon sorununu kontrol edin.
• 401/403 ise authentication header’ı yanlış.
• Timeout alıyorsanız n8n’nin işlem süresini ve dış çağrı sürelerini kontrol edin.
• n8n node çıktılarını console.log veya n8n’in Execution listesi üzerinden inceleyin.

Kontrol: Hangi HTTP kodlarını alıyorsunuz? Loglarda hata mesajı var mı?

Hızlı NGROK kurulum örneği

1. ngrok indir ve çalıştır: ngrok http 5678
2. ngrok size bir HTTPS URL verecek; webhook URL içindeki host kısmını bu URL ile değiştirin.
3. n8n’yi yerelde çalıştırın (ör. docker veya direkt).
4. Test gönderimi: curl ile POST atın ve n8n’de yakalandığını doğrulayın.

Hangi durumda hangi yol seçilir?

• Hızlı deneme/tekrar eden geliştirme: ngrok veya benzeri tüneller.
• Kalıcı üretim webhook’ları, yüksek güvenlik veya IP beyaz liste gerekiyorsa: sunucu üzerinde n8n veya n8n Cloud.
• Üçüncü taraf servis IP’leri sabit değilse ve güvenlik yüksekse: ara katman (API Gateway) + HMAC doğrulama.
• Çok yüksek trafik bekleniyorsa: webhookları hemen işlemek yerine bir kuyruk hizmetine (Redis/Kafka vs.) gönderip asenkron işleyin.

Karar noktası (bold): Eğer amacınız yalnızca testse ngrok, canlı kullanım ve SLA gerekiyorsa kalıcı host çözümü seçin.

Kontrol listesi — Yayına almadan önce hızlı doğrulama

• [ ] Webhook URL doğru ve tam kopyalandı mı?
• [ ] Workflow aktif durumda mı?
• [ ] HTTPS kullanılıyor mu (gerekiyorsa)?
• [ ] Doğru HTTP methodu ve Content-Type ayarlandı mı?
• [ ] Güvenlik başlıkları/HMAC/token test edildi mi?
• [ ] Gelen payload n8n tarafından parse edilebiliyor mu?
• [ ] Timeout ve retry ayarları gözden geçirildi mi?
• [ ] Log/Execution izleme aktif mi?

Örnek senaryo: Form hizmetinden gelen veriyi alıp üçüncü taraf API’ye iletme

Senaryo: Web form servisiniz kullanıcı verisini POST ediyor. Bu veriyi alıp CRM API’sine aktaracaksınız.

Bu konuyla ilgili tamamlayici bilgi icin n8n Nedir? Tekrarlayan İşleri Otomatikleştiren Açık Kaynak İş Akışı Platformu Rehberi (2026) rehberini de inceleyebilirsiniz.

Adımlar:

1. n8n’de yeni workflow oluşturun.
2. Webhook node (POST) ekleyin, URL’i kopyalayın.
3. Form servisine bu URL’i girin ve test gönderimi yapın.
4. n8n’de gelen veriyi doğrulayın. Gerekirse bir Function node ile alanları normalize edin.
5. HTTP Request node ekleyin; metod POST, hedef CRM endpoint, gerekli header ve API anahtarını ekleyin.
6. Gelen veriyi HTTP Request body alanına eşleyin; Content-Type: application/json.
7. Workflow’u aktif hale getirin ve tekrar test edin.
8. İzleme: İlk 10 çağrıyı loglayın, hataları e-posta veya Slack ile bildirin.

Beklenen sonuç: Form hizmeti başarılı bir 200/2xx alır, CRM’e veri iletilir ve n8n Execution log’larında başarı görünür.

Sonuç ve öneriler

• Temel karar noktası: Hızlı geliştirme mi yoksa üretim mi? Buna göre ngrok mı yoksa kalıcı host mu kullanacağınıza karar verin.
• Risk: Yerel HTTP kullanımı veya paspaslanmış güvenlik, üretimde veri sızıntısı ve hizmet kesintisine yol açabilir. Bu riski azaltmak için HTTPS ve imza/tabanlı doğrulama tercih edin.
• Öneri: İlk olarak ngrok ile hızlı test yapın; çalıştığını doğruladıktan sonra aynı endpoint yapılandırmasını kalıcı bir sunucuya taşıyın ve güvenlik/kontrolleri sıkılaştırın.
• Sonuç: Doğru URL, aktif workflow ve uyumlu payload + güvenlik ayarları sağlandığında n8n ile webhook kurulumu dakikalar içinde çalışır hale gelir. İzleme ve loglama ekleyerek üretim istikrarını koruyun.

İhtiyacınız olursa sizin kullandığınız servis (ör. Typeform, Stripe, GitHub) ve mevcut altyapınız (yerel mi, VPS mi, n8n Cloud mu) bilgisine göre adımları özelleştirilmiş bir kontrol listesi ve örnek yapılandırma yazabilirim.

Bu konuyla ilgili tamamlayici bilgi icin E-ticaret Siparişlerini Tek Panelde Toplama Nasıl Yapılır? rehberini de inceleyebilirsiniz.

Bu konuyla ilgili tamamlayici bilgi icin n8n ile Otomatik Müşteri Onay E-postası rehberini de inceleyebilirsiniz.