n8n'de Webhook Node Nasıl Çalışır ve Ne Zaman Kullanılır?

n8n, düşük kodlu bir Workflow Automation aracı olarak farklı servisleri birbirine bağlamanızı sağlar. İş akışlarını tetiklemenin birçok yolu vardır; bunlardan en esnek ve gerçek zamanlı olanı webhook node'dur. Webhook node, dış uygulamalardan gelen HTTP isteklerini dinler ve bu istekler geldiğinde iş akışını başlatır. Bu makalede webhook node'un nasıl çalıştığını, ne zaman webhook yerine polling kullanmanız gerektiğini ve somut bir form verisi yakalama senaryosunu inceleyeceğiz.

Webhook Node Nasıl Çalışır?

n8n'de bir webhook node eklediğinizde, size benzersiz bir URL atanır. Bu URL'ye bir HTTP isteği (GET, POST, PUT veya DELETE) gönderildiğinde node tetiklenir. Gelen isteğin gövdesi (body) iş akışının sonraki adımlarında kullanılabilir. Webhook node'u yapılandırırken şunları ayarlarsınız:

• HTTP Metodu: Hangi HTTP metodunun dinleneceği (çoğu durumda POST).
• Yanıt Modeli: İsteğe nasıl yanıt verileceği (örneğin, "İşlem Başarılı" mesajı).
• Doğrulama: İsteğin kaynağını doğrulamak için basic auth veya header kontrolü eklenebilir.

Örneğin, bir webhook node'u POST metoduyla yapılandırdıysanız, herhangi bir uygulama bu URL'ye JSON verisi gönderdiğinde n8n otomatik olarak iş akışını başlatır. Bu, n8n'in en güçlü yanlarından biridir; çünkü dış sistemlerle anında iletişim kurabilirsiniz.

Webhook vs Polling: Ne Zaman Hangisini Kullanmalısınız?

İş akışlarınızı tetiklemenin iki temel yöntemi vardır: webhook (istemci tarafından bildirim) ve polling (düzenli aralıklarla kontrol). Her ikisinin de avantajları ve dezavantajları vardır.

Webhook Kullanmanız Gereken Durumlar

• Gerçek zamanlı veri istiyorsanız: Webhook, veri oluştuğu anda iş akışını çalıştırır. Örneğin, bir e-ticaret sitesinde yeni sipariş geldiğinde hemen bildirim almak için idealdir.
• Kaynak kullanımı önemliyse: Polling sürekli sorgulama yaparak API limitlerinizi zorlayabilir. Webhook ise sadece veri oluştuğunda çalışır.
• Dış sistemin webhook desteği varsa: Birçok modern API (Stripe, GitHub, Typeform) webhook gönderebilir.

Polling Kullanmanız Gereken Durumlar

• Dış sistem webhook desteklemiyorsa: Bazı eski API'ler yalnızca polling'e izin verir.
• Veri sıklığı düşükse ve gecikme tolere edilebilirse: Örneğin, saatte bir güncellenen bir raporu almak için polling yeterlidir.
• Güvenlik duvarı veya ağ kısıtlamaları varsa: Webhook almak için n8n'in dışarıdan erişilebilir olması gerekir. Polling'de bu sorun yoktur.

Kısaca, webhook canlı veri için, polling ise basit ve düşük frekanslı işlemler için uygundur.

Örnek: Bir Webhook ile Form Verisini Yakalama

Diyelim ki bir web sitenizde kullanıcıların iletişim formu doldurduğu bir bölüm var. Bu form verilerini otomatik olarak bir Google Sheets tablosuna kaydetmek ve e-posta bildirimi göndermek istiyorsunuz. İşte adım adım yapmanız gerekenler:

1. Webhook Node Ekleme: n8n'de yeni bir iş akışı oluşturun ve bir webhook node'u ekleyin. HTTP Metodunu POST, Yanıt Modelini ise "İşlem Başarılı" olarak ayarlayın. Node'u çalıştırın ve size verilen URL'yi kopyalayın.
2. Form Ayarları: Web sitenizin form koduna, action URL olarak bu webhook adresini yazın. Form verilerini JSON formatında göndermek için JavaScript kullanabilirsiniz (örneğin, fetch(webhookURL, { method: 'POST', body: JSON.stringify(formData) })).
3. Veriyi İşleme: Webhook node'undan sonra bir "Set" node'u ekleyin ve gelen veriyi (ad, soyad, e-posta gibi) değişkenlere atayın. Ardından bir "Google Sheets" node'u ile veriyi tabloya ekleyin.
4. Bildirim Gönderme: Son olarak bir "Email" node'u (örneğin, SMTP) ekleyerek form doldurulduğunda size e-posta gelsin.
5. Test Etme: n8n'in webhook test özelliğini kullanarak bir örnek istek gönderebilirsiniz. Alternatif olarak, curl -X POST -H "Content-Type: application/json" -d '{"name":"Ali","email":"[email protected]"}' [webhookURL] komutuyla da test edebilirsiniz.

Bu örnek, webhook node'unun gerçek dünyada nasıl kullanılabileceğini göstermektedir. Form verisi anında işlenir ve herhangi bir periyodik kontrol gerektirmez.

Webhook Kullanımında Dikkat Edilmesi Gerekenler

• Güvenlik: Webhook URL'niz herkese açık olduğu için isteklerin kaynağını doğrulamalısınız. n8n'de "Header" veya "Basic Auth" ile doğrulama ekleyin.
• Yeniden Deneme Mekanizması: n8n, webhook isteği başarısız olursa otomatik yeniden deneme yapmaz. Gerekirse iş akışınızda hata yönetimi ekleyin.
• Sunucu Kesintileri: n8n sunucunuz kapalıysa webhook istekleri kaybolur. Kesintisiz çalışma için n8n'i bulutta veya yedekli bir altyapıda çalıştırın.

Sonuç olarak, webhook node'u Workflow Automation projelerinde anlık veri akışı sağlamak için vazgeçilmez bir araçtır. Doğru kullanıldığında sistemlerinizi duyarlı ve verimli hale getirir.