Webhook, bir uygulamanın belirli bir olay gerçekleştiğinde başka bir uygulamaya otomatik olarak veri göndermesini sağlayan bir HTTP geri çağrısıdır. n8n, bu webhook'ları kolayca yakalamanıza ve iş akışlarınıza entegre etmenize olanak tanıyan güçlü bir no-code otomasyon aracıdır. Bu adım adım rehberde, n8n ile webhook entegrasyonu kurmanın tüm aşamalarını detaylıca inceleyeceğiz.
1. n8n Ortamınızı Hazırlayın
n8n'i kendi sunucunuzda çalıştırabileceğiniz gibi, bulut versiyonunu da kullanabilirsiniz. Öncelikle n8n'i kurun veya hesap oluşturun. Webhook alabilmek için n8n’in dışarıdan erişilebilir olması gerekir (herkese açık bir URL). Kendi sunucunuzda çalışıyorsanız, bir ters proxy (örneğin Nginx) veya ngrok gibi bir araç kullanarak yerel sunucunuzu internete açabilirsiniz. Bulut sürümünde bu adım otomatik olarak sağlanır.
2. Webhook Tetikleyicisi Ekleyin
n8n düzenleyicisinde boş bir iş akışı oluşturun. Sol panelden “Triggers” kategorisinden “Webhook” düğümünü sürükleyin. Açılan ayarlarda aşağıdaki bilgileri yapılandırın:
- HTTP Method: Gelen webhook’un hangi HTTP metodunu kullanacağını seçin (genellikle POST).
- Path: URL’nin eklenecek yolunu belirleyin (örneğin
/webhook). - Response Mode: On Received (webhook alındıktan sonra otomatik yanıt döner) veya Last Node (akışın son düğümünün çıktısını yanıt olarak gönderir) seçeneklerinden birini tercih edin.
- Authentication: İsteğe bağlı olarak temel kimlik doğrulama veya başlık tabanlı bir doğrulama ekleyebilirsiniz.
3. Webhook URL’sini Alın ve Test Edin
Ayarları yaptıktan sonra webhook düğümü üzerinde “Listen for test event” butonuna tıklayın. Bu, webhook için geçici bir test URL’si oluşturacaktır. URL’yi kopyalayın. Ardından bir API istemcisi (Postman, cURL vb.) ile bu URL’ye bir POST isteği gönderin. n8n isteği aldığında bağlantı başarılı olur. Eğer isteğinizi göremiyorsanız, ağ ayarlarınızı ve güvenlik duvarı kurallarınızı kontrol edin.
4. Gelen Veriyi Doğrulayın ve Dönüştürün
Webhook’tan gelen veri genellikle JSON veya XML formatındadır. n8n’de “Set” veya “Code” düğümleri kullanarak bu veriyi işleyebilirsiniz. Örneğin, bir “Set” düğümü ekleyerek gelen JSON’daki belirli alanları yeniden adlandırabilir veya veriyi başka bir formata dönüştürebilirsiniz. Daha karmaşık dönüşümler için “Code” düğümü ile JavaScript veya Python kodu yazabilirsiniz. Benzer dönüşüm teknikleri için Make (Integromat) ile JSON Veri Dönüşümü yazımızdan da faydalanabilirsiniz.
5. Webhook Verisini Hedef Uygulamaya İletin
İşlenen veriyi başka bir uygulamaya göndermek için n8n’in 300’den fazla entegrasyonundan birini kullanın. Örneğin, bir e-posta tetikleyicisi (Gmail, Outlook), Slack mesajı, Google Sheets satırı ekleme veya bir HTTP isteği olabilir. Hedef düğümü ekleyin ve gerekli kimlik doğrulama bilgilerini girin. n8n, veriyi otomatik olarak eşlemenize olanak tanıyan bir görsel arayüz sunar.
6. Hata Yönetimi ve Günlükleme
Webhook entegrasyonlarında hatalar kaçınılmazdır. n8n’de her düğüm için “Error Workflow” tanımlayarak başarısız durumlarda ikinci bir iş akışı çalıştırabilirsiniz. Ayrıca “IF” düğümü ile belirli koşullara göre alternatif yollar oluşturabilirsiniz. Hataları kaydetmek için “Database” düğümlerini veya “Log” eklentilerini kullanın. API versiyonlama gibi konularda doğru URL yapısını kullanmak da hataları azaltır; API Versiyonlama Stratejileri yazımıza göz atabilirsiniz.
7. Webhook’u Canlıya Alın ve İzleyin
Test aşaması başarılı olduğunda, iş akışınızı “Active” hale getirin. Webhook URL’si artık kalıcı olacaktır. Dış uygulamalara bu URL’yi sağlayın. n8n’in “Execution” sekmesinden her bir webhook çağrısının durumunu, giriş/çıkış verilerini ve çalışma süresini izleyebilirsiniz. Yoğun trafik durumunda, webhook düğümünün “Response Mode” ayarını “Last Node” yaparak daha hızlı yanıt alabilirsiniz.
8. Sık Yapılan Hatalar ve Çözümleri
- Webhook URL’sine erişilemiyor: n8n’in dış ağdan erişilebilir olduğundan emin olun. Bulut kullanıyorsanız sorun yaşamazsınız, yerel sunucuda ngrok gibi bir araç kullanın.
- İstekler işlenmiyor veya gecikiyor: Webhook düğümünün “Options” bölümünden “Response Mode” ayarını kontrol edin. “On Received” modu daha hızlı yanıt verir.
- Gelen veri yanlış formatta: Gönderen uygulamanın dokümantasyonunu kontrol edin ve “Set” düğümü ile veriyi dönüştürün.
- Kimlik doğrulama hatası: Webhook’a eklediğiniz header veya parametrelerin harici uygulamayla uyumlu olduğundan emin olun.
n8n ile webhook entegrasyonu, automation ihtiyaçlarınızı kod yazmadan çözmenin en hızlı yoludur. Daha kapsamlı bir no-code otomasyon karşılaştırması için n8n vs. Make: No-Code Otomasyon Platformu Karşılaştırması yazımızı okuyabilirsiniz.
Sık Sorulan Sorular
n8n webhook için dışarıdan erişim gerekli mi?
Evet, webhook alabilmek için n8n’in dışarıdan erişilebilir bir URL’ye sahip olması gerekir. Bulut sürümü otomatik olarak sağlar; kendi sunucunuzda ngrok veya ters proxy kullanabilirsiniz.
n8n'de webhook ile gelen veriyi nasıl dönüştürebilirim?
Gelen veriyi işlemek için Set, Code veya Function düğümlerini kullanabilirsiniz. Set düğümü ile alan eşlemesi yapabilir, Code düğümü ile özel JavaScript kodu çalıştırabilirsiniz.
Webhook aldıktan sonra yanıtı nasıl özelleştirebilirim?
Webhook düğümünün Response Mode ayarını 'Last Node' yaparak akışın son düğümünün çıktısını yanıt olarak dönebilirsiniz. Ayrıca Response Data alanında sabit bir JSON da tanımlayabilirsiniz.
n8n webhook'um çalışmıyor, ne yapmalıyım?
İlk olarak webhook URL’sine erişimi test edin. n8n’in Execution listesinden iş akışının tetiklenip tetiklenmediğini kontrol edin. Hata varsa Error Workflow ekleyerek nedeni bulabilirsiniz.