n8n, kod yazmadan webhook tetikleyicileri ile REST API'lerden veri çekmenize olanak tanıyan güçlü bir otomasyon platformudur. Webhook URL'si oluşturur, API isteklerini yapılandırır ve veriyi otomatik olarak hedef uygulamalara aktarırsınız. İşte adım adım rehber.
Webhook Nedir ve n8n'de Nasıl Çalışır?
Webhook, bir olay gerçekleştiğinde otomatik olarak HTTP isteği gönderen bir geri çağırma mekanizmasıdır. REST API'ler genellikle polling (düzenli aralıklarla sorgulama) yerine webhook kullanarak anlık bildirim sağlar. n8n'de webhook tetikleyicisi, bir HTTP isteği aldığında workflow'u başlatır. Bu sayede dış bir sistem (örneğin bir CRM, e‑posta servisi veya IoT cihazı) size veri gönderdiğinde anında işlem yapabilirsiniz. Detaylı webhook bilgisi için Webhook Entegrasyonu: REST API'lerde Webhook Kullanımının Püf Noktaları yazımıza göz atabilirsiniz.
Adım 1: n8n'de Yeni Bir Workflow Oluşturma
n8n hesabınıza giriş yapın (cloud.n8n.io veya kendi sunucunuzda çalıştırıyorsanız localhost). Sol üst köşedeki "Workflows" sekmesine tıklayın ve "New Workflow" butonuna basın. Workflow'unuza anlamlı bir isim verin, örneğin "Müşteri Verisi Çekme".
Adım 2: Webhook Tetikleyicisi Ekleme
Sol taraftaki nod panelinden "Trigger" kategorisini açın ve "Webhook" nodunu sürükleyerek çalışma alanına bırakın. Webhook nodunun ayarlarında:
- HTTP Method: API'nizin beklediği methodu seçin (genellikle POST veya GET).
- Path: İsteğe bağlı bir URL yolu belirleyin veya otomatik oluşturulanı kullanın.
- Authentication: API anahtarı veya temel kimlik doğrulama gerekiyorsa buraya ekleyin.
Nodu etkinleştirmek için "Execute Node" butonuna tıklayın. Size verilen webhook URL'sini kopyalayın. Bu URL'yi veri gönderecek sisteminize (örneğin bir form servisi veya harici API) kaydedin.
Adım 3: HTTP Request ile API'den Veri Çekme
Webhook tetiklendiğinde, gelen veriyi işlemek için bir "HTTP Request" nodu ekleyin. Bu nod, REST API'ye istek göndererek ek veri çekmenizi sağlar. Örneğin, webhook size bir kullanıcı ID'si gönderdiğinde, bu ID ile kullanıcının detaylarını almak için bir GET isteği yapabilirsiniz. HTTP Request nodunda:
- Method: GET, POST, PUT, DELETE arasından seçin.
- URL: API endpoint'ini yazın, dinamik değişkenler için önceki noddan gelen veriyi referans alın (ör:
{{ $json.id }}). - Headers: API anahtarı, Content-Type gibi başlıkları ekleyin.
- Query Parameters: Gerekli parametreleri belirtin.
Nodu test etmek için önce webhook'a örnek bir istek gönderin (Postman veya curl ile). Ardından HTTP Request nodunu çalıştırın ve çıktıyı inceleyin.
Adım 4: Veri Dönüşümü ve Filtreleme
API'den dönen veri genellikle ham JSON formatındadır. n8n'nin "Set" ve "Function" nodları ile bu veriyi ihtiyacınıza göre dönüştürebilirsiniz. Örneğin:
- Set: Belirli alanları yeniden adlandırın, sabit değerler ekleyin.
- Function: JavaScript kullanarak karmaşık dönüşümler yapın (kod yazmak istemiyorsanız Set nodu yeterlidir).
- Filter: Belirli koşulları sağlamayan verileri atın.
Örneğin, gelen kullanıcı listesinden sadece aktif kullanıcıları seçmek için bir "Filter" nodu ekleyebilirsiniz.
Adım 5: Çıktıyı Hedef Uygulamaya Gönderme
Dönüştürülen veriyi bir başka uygulamaya aktarmak için uygun bir çıkış nodu seçin. n8n'de yüzlerce entegrasyon mevcuttur: Google Sheets, Slack, e‑posta, veritabanı, webhook (başka bir sisteme geri göndermek için), vs. Örneğin, müşteri verilerini bir Google Sheets tablosuna eklemek için "Google Sheets" nodunu kullanın. Kimlik doğrulama yapılandırmasını tamamlayın ve hedef çalışma sayfasını seçin.
Alternatif olarak, Bubble gibi no‑code platformlarla veri paylaşmak isterseniz Bubble ile REST API Entegrasyonu rehberimizdeki yöntemleri uygulayabilirsiniz.
Sık Yapılan Hatalar ve Çözümleri
| Hata | Olası Sebep | Çözüm |
|---|---|---|
| Webhook tetiklenmiyor | URL yanlış veya güvenlik duvarı engelliyor | URL'yi kontrol edin, n8n'in dışarıdan erişilebilir olduğundan emin olun (public URL kullanın) |
| HTTP Request nodu hata veriyor (401) | API anahtarı eksik veya geçersiz | Headers kısmında doğru Authorization bilgisini ekleyin |
| Veri dönüşümü beklenenden farklı | JSON yapısı yanlış parse edilmiş | Harici bir JSON doğrulama aracı ile yapıyı kontrol edin |
| Workflow çok yavaş | Fazla veri veya gereksiz adımlar | Filtreleme ekleyin, API caching stratejileri uygulayın |
Özet ve İpuçları
n8n, webhook tabanlı veri akışlarını kod yazmadan kurmak için ideal bir araçtır. Başlangıçta basit bir test workflow'u oluşturun, ardından ihtiyacınıza göre karmaşıklaştırın. Workflow'unuzu düzenli olarak test edin ve hata yönetimini unutmayın. n8n topluluğu ve resmi dokümantasyon, karşılaştığınız sorunlar için iyi bir kaynaktır.
Sık Sorulan Sorular
n8n ücretsiz mi?
n8n, açık kaynaklı bir platformdur. Kendi sunucunuzda ücretsiz olarak çalıştırabileceğiniz gibi, bulut sürümünde de ücretsiz bir kullanım kotası vardır (aylık 5,000 workflow çalıştırması gibi). Daha yüksek kullanım için ücretli planlar mevcuttur.
Webhook ile API polling arasındaki fark nedir?
Webhook, bir olay olduğunda anında veri gönderir; API polling ise belirli aralıklarla sunucuyu sorgular. Webhook daha gerçek zamanlı ve verimlidir, ancak alıcı tarafın her zaman açık olması gerekir.
n8n'de birden fazla webhook kullanabilir miyim?
Evet, aynı workflow içinde birden fazla webhook tetikleyicisi ekleyebilirsiniz. Her biri farklı bir URL ve method ile çalışır, böylece farklı kaynaklardan gelen verileri tek bir akışta birleştirebilirsiniz.
Veri dönüşümü için hangi nodlar kullanılır?
Temel dönüşümler için 'Set' nodu yeterlidir. Karmaşık işlemler için 'Function' nodu ile JavaScript kodu yazabilirsiniz. Ayrıca 'Aggregate', 'SplitInBatches' ve 'Summarize' nodları da veri manipülasyonu için kullanışlıdır.
n8n'de hata yönetimi nasıl yapılır?
Her nodun altında 'Error Output' bağlantısı bulunur. Hata durumunda farklı bir akış tetiklemek için bu çıkışa bir 'Throw' nodu ekleyebilirsiniz. Ayrıca 'Error Trigger' event'i ile global hata yönetimi kurabilirsiniz.
