n8n webhook, harici uygulamalardan gelen verileri gerçek zamanlı olarak yakalamak ve otomasyon akışlarınızı tetiklemek için en etkili no-code yöntemdir. Bir API entegrasyonuna ihtiyacınız olduğunda, webhook sayesinde kod yazmadan HTTP isteklerini alabilir, işleyebilir ve hedef platformlara yönlendirebilirsiniz.
Webhook Nedir ve n8n'de Nasıl Çalışır?
Webhook, bir olay gerçekleştiğinde başka bir sisteme otomatik olarak veri gönderen bir HTTP geri çağrısıdır. n8n'de bir webhook düğümü oluşturduğunuzda, size özel bir URL (örneğin https://your-n8n-instance.com/webhook/abc123) sağlanır. Diğer servisler bu URL'ye POST veya GET isteği yaparak veri gönderebilir. n8n bu veriyi alır ve akışın bir sonraki adımına iletir.
Örneğin, bir e-ticaret platformundan yeni sipariş bilgilerini almak için webhook kullanabilirsiniz. Sipariş oluşturulduğunda, platform belirlediğiniz webhook URL'sine bir POST isteği gönderir ve n8n bu veriyi işleyerek Google Sheets'e kaydeder veya Slack bildirimi gönderir.
Adım Adım n8n Webhook Kurulumu
1. Webhook Düğümü Ekleme
n8n iş akışınızda bir Webhook düğümü sürükleyin. Açılan ayarlardan Webhook ID'yi otomatik oluşturulan veya kendi belirlediğiniz bir değer olarak ayarlayın. Ardından HTTP Method'u (genellikle POST) seçin. Response Mode'u 'Last Node' olarak bırakabilirsiniz; bu, akış sonundaki düğümün çıktısını webhook yanıtı olarak döndürür.
2. Güvenlik ve Doğrulama Ekleyin
Webhook URL'nizin kötüye kullanılmasını önlemek için bir API Anahtarı veya JWT token kullanın. n8n, gelen isteklerde belirli bir başlık veya sorgu parametresi bekleyecek şekilde yapılandırılabilir. Örneğin, Authorization: Bearer YOUR_SECRET başlığını zorunlu kılabilirsiniz. Bu konuda JWT Access ve Refresh Token Yönetimi yazımız size daha detaylı bilgi sağlayacaktır.
3. Webhook'u Test Edin
Webhook URL'nizi kopyalayın ve bir API test aracı (Postman, cURL) veya herhangi bir HTTP istemcisi ile istek gönderin. n8n'de Execute Workflow düğmesine basarak akışı çalıştırın. Gelen veriyi Webhook Response sekmesinde görebilirsiniz. Doğru çalışıyorsa, akışı aktifleştirerek gerçek zamanlı kullanıma hazır hale getirin.
Pratik Örnek: Gmail'den Gelen E-postayla Slack Bildirimi
- Webhook düğümü ekleyin, POST methodu seçin.
- Gmail'in webhook özelliğini (Google Apps Script veya üçüncü parti eklenti ile) yeni e-posta geldiğinde bu URL'ye POST yapacak şekilde ayarlayın.
- Webhook'tan gelen JSON verisini Set düğümüyle düzenleyin.
- Slack düğümü ekleyin, mesaj içeriğini e-posta konusu ve gönderen adıyla oluşturun.
- Akışı etkinleştirin. Artık her yeni e-posta geldiğinde Slack kanalınıza bildirim düşer.
Sık Yapılan Hatalar ve Çözümleri
- Yanıt Süresi Aşımı: Webhook akışınız uzun sürüyorsa, isteği gönderen servis zaman aşımına uğrayabilir. Webhook düğümünün Response Mode ayarını 'Last Node' yerine 'Response Node' yaparak hızlı bir onay döndürebilirsiniz. Uzun süren işlemleri ayrı bir alt akışa taşıyın.
- Geçersiz Veri Formatı: Gelen veri beklediğiniz yapıda değilse IF düğümüyle doğrulama yapın. Veriyi Function düğümüyle dönüştürün.
- Güvenlik Açıkları: Webhook URL'nizi herkes görebilir. Mutlaka istek doğrulaması ekleyin. n8n'in 'Add Authentication' seçeneğini veya bir ara kimlik doğrulama düğümü kullanın. HTTP hata yönetimi için Axios Interceptor ile HTTP Hata Yönetimi rehberindeki yöntemlerden ilham alabilirsiniz.
Webhook ile Polling Karşılaştırması
| Özellik | Webhook | Polling |
|---|---|---|
| Tetikleme | Olay anında (gerçek zamanlı) | Belirli aralıklarla (gecikmeli) |
| Kaynak Kullanımı | Düşük (yalnızca olay olduğunda) | Yüksek (sürekli sorgulama) |
| Kurulum Karmaşıklığı | Orta (webhook URL, doğrulama) | Düşük (basit zamanlayıcı) |
| Uygun Senaryo | Sık değişen veriler, anlık bildirim | Düşük frekanslı, periyodik veri |
Çoğu durumda webhook, polling'e göre daha verimli ve hızlıdır. Ancak webhook desteği olmayan servisler için polling kullanmak zorunda kalabilirsiniz.
Gelişmiş Kullanım: Webhook ile Veritabanı Senkronizasyonu
Webhook, iki sistem arasında veri senkronizasyonu için idealdir. Örneğin, bir CRM'den gelen müşteri verilerini webhook ile alıp PostgreSQL veritabanına yazabilirsiniz. n8n'de PostgreSQL düğümünü kullanarak INSERT veya UPDATE işlemleri yapabilirsiniz. Veri bütünlüğünü korumak için tekrarlanan istekleri Filter düğümüyle eleyin.
No-code araçlar arasında Bubble vs Webflow karşılaştırmamızda farklı no-code platformların yeteneklerini bulabilirsiniz. n8n ise arka uç entegrasyonları için en güçlü açık kaynak low-code araçlardan biridir.
Sık Sorulan Sorular
Webhook nedir ve n8n'de nasıl kullanılır?
Webhook, bir olay gerçekleştiğinde otomatik olarak HTTP isteği gönderen bir mekanizmadır. n8n'de webhook düğümü, harici servislerden gelen bu istekleri alır ve akışı tetikler. Kurulumu basittir: bir webhook düğümü ekleyin, URL'yi alın ve diğer servisi bu URL'ye POST yapacak şekilde ayarlayın.
n8n webhook güvenliği nasıl sağlanır?
Webhook URL'nizi gizli tutun ve istek doğrulaması ekleyin. n8n, gelen isteklerde belirli bir başlık (örneğin Authorization) veya sorgu parametresi kontrolü yapabilir. Ayrıca JWT token kullanarak da güvenliği artırabilirsiniz.
Webhook ile polling arasındaki fark nedir?
Webhook, olay anında veri gönderirken polling, istemcinin belirli aralıklarla sunucuyu sorgulamasıdır. Webhook gerçek zamanlı ve kaynak verimliyken, polling gecikmeli ve daha fazla kaynak tüketir. Webhook desteği olmayan sistemlerde polling kullanılır.
n8n webhook ile hangi servisler entegre edilebilir?
n8n, yüzlerce entegrasyon sunar. Webhook ile Google Sheets, Slack, PostgreSQL, Shopify, Stripe, Gmail gibi servislere veri gönderebilir veya onlardan veri alabilirsiniz. Ayrıca özel API'lerinizle de çalışabilirsiniz.
