n8n Webhook Nedir, Nasıl Kullanılır?

Webhook, bir uygulamada bir olay olduğunda o uygulamanın başka bir adrese veri göndermesini sağlayan yöntemdir. Webhook node'u, n8n belgelerine göre veri alacak bir adres oluşturur ve bu adrese veri geldiğinde bir workflow'u başlatır. Node, n8n'de bir workflow içindeki tek adımdır. Workflow ise bir işi otomatik yapan node'ların bütünüdür.

n8n webhook nedir?

n8n belgelerine göre Webhook node'u bir trigger node'dur. Trigger node, bir n8n workflow'unu başlatan özel node'dur.

Belgelere göre Webhook node'u, n8n'de kendi trigger node'u olmayan uygulamalardan da workflow başlatmayı sağlar. Bu node, workflow'un sonunda üretilen veriyi isteği gönderene cevap olarak da döndürebilir. Bu yüzden Webhook node'uyla veriyi işleyip sonucu döndüren ve bir API gibi çalışan workflow'lar kurulabilir. API, bir yazılımın başka bir yazılıma istek gönderip cevap alabildiği arayüzdür.

Örnek: Bir web sitesindeki iletişim formu, gönderilen her mesajı bir Webhook node'unun adresine yollar. Workflow bu mesajı alır ve bir Google Sheets tablosuna yeni satır olarak ekler.

Temel n8n kavramları n8n nedir yazısında anlatılır.

n8n'de test ve canlı webhook adresi arasındaki fark nedir?

n8n belgelerine göre Webhook node'unun iki adresi vardır: test adresi (Test URL) ve canlı adres (Production URL). n8n bu adresleri node panelinin üstünde gösterir. Paneldeki Test URL ve Production URL seçenekleri hangi adresin gösterileceğini belirler.

Belgelere göre test adresi, "Listen for Test Event" seçildikten sonra 120 saniye boyunca açık kalır. Test adresine gelen veri editörde göründüğü için hataları bulmak kolaylaşır. Editör, n8n'de workflow'ların kurulduğu ve düzenlendiği ekrandır.

n8n'de webhook nasıl kurulur?

HTTP yöntemi, bir isteğin türünü belirler. n8n belgelerine göre bir webhook workflow'u şu adımlarla kurulabilir:

1. Workflow'a Webhook node'unu ekle.
2. Node panelindeki HTTP Method alanında isteğin yöntemini seç, örneğin POST.
3. Path alanına webhook adresinin yolunu yaz ya da n8n'in oluşturduğu rastgele yolu kullan.
4. Respond alanında webhook'un ne zaman cevap vereceğini seç.
5. "Listen for Test Event" düğmesine tıkla ve test adresine örnek bir istek gönder. Gelen veri editörde görünür.
6. Gelen veriyi kontrol ettikten sonra workflow'u yayımla ve veriyi gönderecek uygulamaya Production URL'yi ver.

Belgelere göre Webhook node'u DELETE, GET, HEAD, PATCH, POST ve PUT yöntemlerini destekler. Path alanı varsayılan olarak, başka Webhook node'larıyla çakışmaması için rastgele bir yol içerir.

n8n webhook nasıl cevap verir?

n8n belgelerine göre Respond alanında dört seçenek vardır:

Belgelere göre Respond to Webhook node'u cevabı metin, JSON, dosya ya da yönlendirme olarak gönderebilir. Streaming response seçeneği ise workflow'da AI Agent gibi akışlı cevabı destekleyen bir node ister.

n8n'de webhook nasıl güvenli hâle getirilir?

Kimlik doğrulama, isteği gönderenin izinli bir uygulama olup olmadığını kontrol eden adımdır. n8n belgelerine göre webhook adresini çağıran uygulamadan kimlik doğrulama istenebilir. Desteklenen yöntemler Basic auth, Header auth ve JWT auth'tur. Basic auth kullanıcı adı ve parolayla, Header auth isteğin başlığına eklenen bir değerle çalışır. Belgelere göre JWT auth ise veriyi dijital olarak imzalamak için JSON Web Token (JWT) kullanan bir kimlik doğrulama yöntemidir.

Belgelere göre Webhook node'unun ek seçenekleri de güvenliğe yardım eder. IP(s) Allowlist seçeneği webhook'u sadece listedeki IP adreslerine açar. n8n, listede olmayan adreslerden gelen isteklere 403 hatası döndürür. Ignore Bots seçeneği bağlantı önizleyicileri ve arama motoru tarayıcıları gibi botlardan gelen istekleri yok sayar.

n8n'de webhook kullanırken hangi sorunlar çıkar?

n8n belgelerine göre en sık görülen sınırlar ve sorunlar şunlardır:

• Bir webhook isteğinin en büyük boyutu 16 MB'tır. Kendi sunucusunda n8n çalıştıran kullanıcı bu sınırı N8N_PAYLOAD_SIZE_MAX ayarıyla değiştirebilir.
• n8n, aynı yol ve aynı HTTP yöntemi için sadece bir webhook kaydına izin verir.
• n8n Cloud'da webhook 100 saniye içinde cevap vermezse istek 524 hata koduyla başarısız olur.
• Webhook node'u varsayılan olarak tek bir HTTP yöntemiyle gelen istekleri kabul eder. Birden çok yöntem için node'un Settings bölümünde "Allow Multiple HTTP Methods" ayarını aç.

n8n'in kurulum yolları n8n kurulumu nasıl yapılır yazısında anlatılır.

Sonraki adım

n8n'de Webhook node'u olan yeni bir workflow aç ve HTTP Method olarak POST seç. "Listen for Test Event" düğmesine tıkla ve 120 saniye içinde test adresine örnek bir istek gönder. Gelen veriyi editörde incele.