n8n otomasyonları için Webhook nasıl kurulur?
n8n otomasyonları için Webhook bağlantısı kur, örnek istekle veri gönder. Test ve canlı adres farkını öğren, gelen mesajı yapay zekâ adımına güvenle hazırla.

n8n otomasyonları için akışın başına Webhook düğümü ekle, istek yöntemini ve kimlik doğrulamayı ayarla. Test URL adresini dinlemeye açıp örnek veri gönder; canlı kullanımda akışı yayımlayarak gönderen uygulamaya Production URL adresini gir.
n8n otomasyonları kurarken formdan gelen mesajı yapay zekâya göndermek istiyorsan, önce o mesajın akışa nasıl ulaşacağını çözmelisin. Webhook, başka bir uygulamanın n8n'e veri gönderebileceği bir adres oluşturur. Çalışan bir n8n ortamında örnek talebi alıp gerekli alanları ayıklayabilir, ardından bağlantıyı canlı kullanıma geçirebilirsin.
n8n otomasyonlarında Webhook ne işe yarar?
Webhook, dışarıdan gelen web isteğiyle iş akışını başlatır ve gönderilen veriyi sonraki adımlara aktarır. Örneğin bir form uygulaması, yeni başvurunun mesajını n8n'deki adrese gönderir; sen de bu mesajı sınıflandıracak bir akış kurarsın. Form uygulamasının dışarıya webhook isteği göndermeyi desteklemesi gerekir.
Resmi Webhook belgesi, hazır tetikleyicisi bulunmayan servislerin de bu yolla n8n'e bağlanabildiğini açıklıyor. n8n'deki kutucuklara node, yani düğüm denir. İş akışı kavramı yeniyse n8n'in çalışma mantığına bakabilirsin.
İlk denemeyi iki düğümle sınırla: Webhook ve Edit Fields. Örnek talebin numarasını ve mesajını alıp çıktı olarak döndüreceksin. Böylece model bağlantısı eklemeden önce verinin doğru geldiğini kontrol edebilirsin. Bu denemede bir tablo hesabına veya yapay zekâ anahtarına ihtiyacın yok; n8n erişimi ve istek göndermek için curl adlı komut satırı aracı yeterli.
n8n Webhook bağlantısı nasıl kurulur?
Yeni akışın başına Webhook ekleyip POST yöntemini ve Header Auth kimlik doğrulamasını seçerek bağlantıyı kurabilirsin. POST, bu örnekte mesajı isteğin gövdesinde göndermek için kullanacağın HTTP yöntemidir; HTTP, web üzerinden istek ve cevap alışverişini sağlayan protokoldür.
Yazı tarihinde resmi belgelerdeki alan adlarıyla şu ayarları yap:
- Yeni akışa
Talep alma denemesiadını ver ve Webhook düğümü ekle. - HTTP Method alanını
POSTseç. - Path alanına
talep-denemesiyaz. Bu değer adresin yol bölümünü belirler. - Authentication alanında
Header Authseç ve yeni bir bağlantı kaydı oluştur. - Bağlantıdaki Name alanına
X-Rehber-Key, Value alanına kendin ürettiğin uzun, rastgele bir gizli değer gir. - Respond alanını
When Last Node Finishes, Response Data alanınıFirst Entry JSONseç.
Kimlik doğrulama belgesine göre Header Auth, istekte belirlediğin başlık adını ve değerini kullanır. İsteği gönderen uygulama da aynı başlık adını ve gizli değeri kullanmalı. Bağlantı kaydını kaydet; gizli değeri ekran görüntüsüne veya herkese açık akış dosyasına koyma. Gerçek bağlantıda HTTPS adresi kullan.
n8n Webhook nasıl test edilir?
Webhook düğümünde Test URL adresini kopyalayıp Listen for test event seçeneğini açtıktan sonra örnek isteği gönderebilirsin. Yazı tarihinde geliştirme belgesi, test dinlemesinin 120 saniye açık kaldığını belirtiyor. Süre dolarsa yeniden dinlemeye al.
macOS veya Linux'ta curl bulunan bir terminalde aşağıdaki komutu kullanabilirsin. N8N_TEST_URL_BURAYA yerine düğümden kopyaladığın tam adresi, GIZLI_DEGER_BURAYA yerine bağlantıya kaydettiğin değeri yaz. Gerçek müşteri bilgisi göndermeden önce bu örnek veriyle dene:
curl -i -X POST 'N8N_TEST_URL_BURAYA' \
-H 'Content-Type: application/json' \
-H 'X-Rehber-Key: GIZLI_DEGER_BURAYA' \
--data '{"talep_no":"DENEME-001","mesaj":"Atölyeniz pazar günü açık mı?"}'
JSON, alan adlarıyla değerleri eşleştiren bir veri biçimidir. Gönderdiğin kaydın talep_no ve mesaj alanlarını Webhook çıktısındaki body bölümünde kontrol et. Terminalde cevap görmekle yetinme; özellikle Türkçe karakterlerin ve mesajın tamamının doğru geldiğine bak. Sonraki düğümü ekledikten sonra aynı deneme isteğini yeniden göndereceksin.
Gizli değeri içeren komut terminal geçmişinde kalabilir; deneme bittiğinde bu değeri değiştir. Gönderen uygulamanın bağlantı ekranında özel başlık tanımlanabiliyorsa aynı başlık adını ve yeni değeri oraya gir. Bir web sayfasının ziyaretçilere gönderilen JavaScript koduna gizli anahtar yerleştirme.
Gelen mesaj yapay zekâ adımına nasıl hazırlanır?
Webhook'un arkasına Edit Fields ekleyerek yalnızca kullanacağın alanları sonraki adıma geçirebilirsin. Edit Fields belgesi, alanların elle eşleştirilmesini ve kullanılmayan girdilerin çıktıdan çıkarılmasını destekliyor.
Mode alanını Manual Mapping seç. Fields to Set altında iki metin alanı oluştur; değerlerini Expression modunda şu şekilde gir:
| Alan adı | Değer |
|---|---|
talep_no |
{{ $json.body.talep_no }} |
mesaj |
{{ $json.body.mesaj }} |
Çift süslü parantezler, gelen veriden değer okuyan dinamik alan ifadeleridir. Keep Only Set Fields seçeneğini açarak eşleştirmediğin girdileri çıkar. Kullandığın arayüzde çıktı seçimi Include in Output altında gösteriliyorsa diğer giriş alanlarını dahil etmeyecek şekilde ayarla.
Akışı kaydet, yeniden test dinlemesini aç ve komutu çalıştır. Bu ayarlarla akışın beklenen yanıtı şöyle:
{
"talep_no": "DENEME-001",
"mesaj": "Atölyeniz pazar günü açık mı?"
}
Mesaj boş görünüyorsa girişteki alan adını kontrol et. Örneğin form uygulaması mesaj yerine message gönderiyorsa ifadeyi buna göre değiştir. Yapay zekâ bağlantısını daha sonra eklediğinde modelin okuyacağı alana mesaj değerini ver; isteğin bütün başlıklarını taşımana gerek yok. Bu ayıklama, önceki Webhook çalıştırmasının kaydındaki verileri silmez.
Test URL ile Production URL arasındaki fark nedir?
Test URL geliştirme sırasında veriyi editörde incelemek, Production URL ise yayımlanmış akışı dışarıdan başlatmak içindir. Canlı bağlantıya geçerken gönderen uygulamadaki adresi de değiştirmelisin.
Örneğin terminaldeki deneme başarılıysa akışı kaydet ve yayımla. Webhook düğümündeki Production URL adresini kopyalayıp form uygulamasının webhook ayarına gir. Uygulamada POST yönteminin ve kimlik doğrulama başlığının korunduğunu kontrol et. Ardından DENEME-002 numaralı yeni bir örnek gönder.
Canlı adrese gelen veriyi, resmi geliştirme belgesinde tarif edildiği gibi Executions bölümünden incele. Burada DENEME-002 kaydını açıp gönderdiğin mesajla karşılaştır.
Form uygulaması başka bir sunucudaysa senin bilgisayarındaki localhost adresine doğrudan ulaşamaz. Gönderen servisin erişebildiği n8n adresini kullan. Bizce ilk bağlantı denemesinde mevcut, erişilebilir bir n8n ortamıyla başlamak, sunucu erişimi sorunlarını akış ayarlarından ayırmanı kolaylaştırır.
n8n Webhook çalışmıyorsa neyi kontrol etmelisin?
Önce doğru adrese, doğru HTTP yöntemiyle istek gönderdiğini ve akışın o adresi dinlediğini kontrol et. Örneğin POST seçtiğin adresi tarayıcının adres çubuğunda açmak aynı testi yapmaz; örnekteki POST isteğini gönder.
| Belirti | İlk kontrol |
|---|---|
| Test isteği akışı başlatmıyor | Test URL seçili mi, dinleme yeniden açıldı mı? |
| Canlı adres çalışmıyor | Production URL kullanılıyor mu, akış yayımlandı mı? |
| Kimlik doğrulama isteği reddediyor | Başlık adı ve gizli değer bağlantı kaydıyla aynı mı? |
| Adresin kullanımda olduğu uyarısı çıkıyor | Başka akış aynı yol ve yöntemi kullanıyor mu? |
| Akış çalışıyor, mesaj alanı boş | Girdi gerçekten body.mesaj alanında mı? |
Sorun giderme belgesi, aynı yol ve HTTP yöntemi birleşimi için tek webhook kaydedilebildiğini belirtiyor. Çakışma varsa bu denemenin Path değerini değiştirip yeni adresi gönderen uygulamaya da geçir.
Yazı tarihinde aynı belge, n8n Cloud'da webhook 100 saniyede yanıt vermezse isteğin 524 hatasıyla sonuçlanacağını söylüyor. Bu süreyi aşabilecek model işlemlerinde isteği hemen kabul edip sonucu ayrı yoldan ileten bir tasarım kullanabilirsin. Immediately yanıtı işlemin tamamlandığını kanıtlamaz. İşlem başladıktan sonraki arızaları izlemek için n8n hata bildirimi kurulumunu ayrıca uygulayabilirsin.
Bizim yorumumuz
Bizce küçük bir işletmenin ilk webhook denemesinde hedefi, bir talebin doğru alanlarla akışa ulaştığını görmek olmalı. Atölyenin çalışma saatini soran örnek mesaj bunun için yeterli. Önce mesajı alıp aynı içerikle geri döndür; ardından kategori belirleme veya cevap taslağı hazırlama işini ekle. Bir aşamada sorun çıktığında hangi bağlantıyı inceleyeceğin daha açık olur.
Bizce yapay zekâ eklemeden önce birkaç farklı örnek hazırlamalısın. Mesajı boş gönder, alan adını değiştir ve aynı talep numarasını yeniden yolla. Her denemede beklediğin davranışı yaz: boş mesajın incelemeye ayrılması veya tekrarlanan numaranın ikinci kayıt oluşturmaması gibi. Bunlar kurulacak ek kontrollerdir; iki düğümlü örneğin kendiliğinden yaptığını varsayma. Modelin okuyacağı mesajın nerede bulunduğunu netleştirdikten sonra n8n ile ilk yapay zekâ ajanını kurma rehberine geçebilirsin.
Türkiye'deki bir işletme için bizce teslim notunda Türkçe alan açıklamaları bulunması da yararlı. mesaj alanının hangi form sorusundan geldiğini ve bağlantı anahtarını kimin değiştireceğini yaz. Otomasyonu başka biri devraldığında bu bilgileri akıştaki kutucuklardan tahmin etmesi gerekmesin. İlk canlı denemenin talep numarasını kaydet; sonraki kontrolünde aynı kaydı Executions ekranında bulup gelen metinle karşılaştır.
Arayüz adları, süreler ve teknik davranışlar yazı tarihinde, 10 Kasım 2026'da n8n'in resmi belgelerinden kontrol edildi. Kurulum sırasında seçenekler farklıysa ilgili düğümün güncel belgesine bak.
Bu yazı sponsorlu değildir.
Sık sorulanlar
n8n Webhook nedir, ne işe yarar?
Başka bir uygulamanın gönderdiği web isteğini alıp n8n iş akışını başlatan düğümdür. Örneğin formdan gelen mesajı alarak sonraki sınıflandırma adımına taşıyabilirsin.
n8n Webhook Test URL ile Production URL farkı nedir?
Test URL, dinlemeyi açtığında deneme verisini editörde görmeni sağlar. Production URL, yayımlanmış akışı dışarıdan başlatmak içindir; çalıştırmaları Executions bölümünden incelersin.
n8n Webhook neden çalışmıyor?
Önce adres türünü, test dinlemesini veya akışın yayımlanma durumunu kontrol et. Gönderenin POST ya da GET yönteminin düğüm ayarıyla eşleştiğinden ve kimlik doğrulama bilgisini gönderdiğinden emin ol.
n8n Webhook için yapay zekâ modeli gerekir mi?
Webhook ile veri almak ve alanları düzenlemek için model gerekmez. Mesajı sınıflandırmak veya cevap taslağı üretmek istersen sonraki adımlara model bağlantısı ekleyebilirsin.
Haftada bir e-posta. Sadece işe yarayanlar.
Haftanın en iyi yapay zekâ araçları ve yeni rehberler. İstediğin an tek tıkla çık.
n8n otomasyonları hata verince nasıl bildirim alınır?








