n8n'de Tetikleyici Türleri: Schedule, Webhook, Polling, Manual, Chat

Her n8n workflow'unun bir başlangıç noktasına ihtiyacı vardır, aksi takdirde hiçbir şey olmaz. Bu başlangıç noktasına tetikleyici (trigger) denir ve n8n bunun için sadece "zaman planı" veya "Webhook"tan çok daha fazlasını sunar. Zamanlanmış otomasyondan gelen HTTP çağrılarına, yapay zeka (YZ) ajanları için sohbet arayüzüne kadar: senaryonuza hangi tetikleyici türünün uyduğu, workflow'unuzun ne kadar güvenilir ve ne kadar hızlı tepki verdiğini doğrudan belirler.

Bu genel bakış, n8n'deki en önemli tetikleyici türlerini, bunların teknik olarak nasıl çalıştığını ve hangisinin ne zaman kullanılacağını gösterir. Kaynak olarak resmi n8n tetikleyici node'ları dokümantasyonu.

n8n'de tetikleyici (trigger) tam olarak nedir?

Dokümantasyona göre bir trigger node, belirli bir koşula tepki olarak bir workflow'u başlatan bir node'dur. Her üretim workflow'unun, n8n'in ne zaman çalışacağını bilebilmesi için en az bir tetikleyiciye ihtiyacı vardır.

Bir workflow aynı anda birden fazla tetikleyici içerebilir, örneğin günlük rutin için bir Schedule Trigger ve buna ek olarak ani dış uyarılar için bir webhook. Ancak her tek çalıştırmada yalnızca koşulu gerçekten gerçekleşen tetikleyici devreye girer. Böylece birden fazla yol oraya götürse bile, workflow'unuzun her seferinde hangi nedenle çalıştığı üzerinde kontrolü elinizde tutarsınız.

Schedule Trigger: zamanlanmış otomasyon

Schedule Trigger, Unix cron aracına benzer şekilde workflow'ları sabit zamanlarda ve aralıklarla başlatır. Schedule Trigger node dokümantasyonuna göre, kullanabileceğiniz birden fazla aralık modu vardır:

• Seconds ve Minutes: sabit aralıklar, örneğin her 30 saniyede bir veya her 5 dakikada bir.
• Hours: saat cinsinden bir aralık artı saatin içindeki tam dakika.
• Days: gün cinsinden bir aralık artı saat, örneğin her 2 günde bir saat 9:15'te.
• Weeks: haftalık aralık, haftanın günü ve saat, örneğin her Pazartesi saat 15:30'da.
• Months: aylık aralık, ayın günü ve saat.
• Custom (Cron Expression): daha karmaşık zaman planları için serbestçe tanımlanmış bir cron sözdizimi, örneğin hafta içi saat 9:00 için `0 9 * * 1-5`.

Bilinmesi gereken önemli bir nokta: Schedule Trigger yalnızca workflow yayınlandığında devreye girer ve ya workflow'un ya da n8n örneğinin (instance) saat dilimini esas alır. Ayrıca bir workflow'un farklı zamanlarda farklı sıklıkta çalışması gerekiyorsa, tek bir Schedule Trigger içinde birden fazla tetikleyici kuralını birleştirebilirsiniz.

Kullanım önerisi: Schedule Trigger, sabit bir rutini otomatikleştirdiğinizde her zaman uygundur, örneğin gece veri senkronizasyonları, haftalık raporlar veya çalıştırma temizleme kontrolleri gibi düzenli temizlik işleri. Dışarıdan kimse bir olay tetiklemiyorsa ve ritmi saat belirliyorsa doğru seçimdir.

Webhook Trigger: dış olaylara tepki verme

Webhook node, gelen HTTP çağrılarını bekleyerek ve bunlar geldiğinde workflow'u hemen başlatarak dış hizmetleri n8n ile bağlar. Webhook node dokümantasyonuna göre GET, POST, PUT, PATCH, DELETE ve HEAD yöntemlerini destekler; çağrı başına maksimum payload boyutu 16 MB'dir.

Pratikte özellikle önemli olan, iki URL arasındaki ayrımdır:

• Test URL'si: editörde "Listen for Test Event" seçeneğine tıkladığınızda etkin olur. Gelen verileri doğrudan arayüzde görürsünüz.
• Üretim URL'si: yalnızca workflow yayınlandığında etkin hale gelir. Gelen çağrılar editörde canlı olarak görünmez, ancak "Executions" sekmesinde takip edilebilir.

Güvenlik için Basic Auth, Header Auth ve JWT Auth kullanılabilir; buna ek olarak IP beyaz listesi, botların yok sayılması ve CORS ayarları da mevcuttur. Yanıtta anlık bildirim, son node tamamlandıktan sonra yanıt, ayrı bir Respond to Webhook node'u üzerinden özel bir yanıt veya bir streaming yanıtı arasında seçim yapabilirsiniz.

Kullanım önerisi: Başka bir sistemin n8n'e aktif olarak bir şey bildirmesi gerektiğinde Webhook Trigger'ı kullanın, örneğin yeni bir form gönderimi, bir ödeme sağlayıcısından gelen ödeme onayı veya bir CRM'den gelen bir olay. Schedule Trigger'a kıyasla büyük avantajı tepki süresidir: workflow, bir sonraki planlanan çalıştırmayı beklemek yerine, olayın gerçekleştiği anda neredeyse hemen başlar.

Polling Trigger: bildirilmek yerine kontrol etmek

Her hizmet kendisi bir webhook tetikleyemez. Klasik e-posta kutuları veya RSS beslemeleri gibi birçok dış sistem aktif bildirim sunmaz. Bu durum için Polling Trigger'lar vardır: belirlenen bir ritimde kendileri yeni bir şey olup olmadığını kontrol eder ve yalnızca gerçekten bir şey değiştiğinde workflow'u başlatır.

Buna iyi bir örnek RSS Feed Trigger'dır. RSS Feed Trigger node dokümantasyonuna göre bu node, yapılandırılmış feed URL'sini ayarlanabilir bir ritimde sorgular ve workflow'u yalnızca yeni girişler için tetikler. Diğerlerinin yanı sıra saatlik, günlük, haftalık ve aylık kontrol aralıkları ile bireysel zaman planları için serbest cron ifadeleri seçilebilir. IMAP üzerinden Email Trigger veya yeni mesajları ya da yeni dosyaları düzenli sorgulama yoluyla tespit eden Local File Trigger gibi diğer n8n node'ları da aynı prensibe dayanır.

Kullanım önerisi: Kaynağın kendisi push bildirimi sunmuyorsa ancak olayı yine de zamanında işlemek istiyorsanız polling doğru seçimdir. Çok dar bir kontrol aralığının gereksiz yere çok fazla çalıştırma ve dolayısıyla gereksiz API çağrısı oluşturduğunu, çok geniş bir aralığın ise tepki süresini uzattığını unutmayın. Makul bir orta yol, kaynağın gerçekte ne sıklıkta değiştiğine bağlıdır.

Manual Trigger: tıklamayla kontrollü başlatma

Manual Trigger bir workflow'u yalnızca editörde aktif olarak "Execute Workflow" seçeneğine tıkladığınızda başlatır. Manual Trigger node dokümantasyonuna göre özellikle iki durum için uygundur: otomatik bir tetikleyici eklemeden önce bir workflow'u test etmek ve bir kişinin her çalıştırmayı bilinçli olarak başlatmak istemesi nedeniyle kasıtlı olarak otomatik çalışmaması gereken workflow'lar için.

Bilmeniz gereken teknik bir kısıtlama var: workflow başına her zaman yalnızca tek bir Manual Trigger node'una izin verilir.

Kullanım önerisi: Bir workflow'u adım adım test etmek için geliştirme aşamasında Manual Trigger'ı kullanın veya tek seferlik veri taşımaları gibi nadir, bilinçli olarak manuel tetiklenen süreçler için kullanın. Sürekli üretim ortamında ise uygun değildir, çünkü orada kimsenin sürekli olarak "Çalıştır" seçeneğine tıklaması gerekmemelidir.

Chat Trigger: yapay zeka (YZ) sohbet botları için giriş noktası

Chat Trigger, sohbet botları ve diğer sohbet arayüzleri için yapay zeka (YZ) workflow'ları oluşturmaya yarar. Chat Trigger node dokümantasyonuna göre, konuşmanın gerçekten yanıtlanabilmesi için bir Agent veya Chain kök node'una bağlanmalıdır. Bir konuşmadaki her tek mesaj, tam bir workflow çalıştırması tetikler; bu da çalıştırma kotanızı planlarken dikkate almanız gereken bir husustur: on mesajlık bir sohbet on çalıştırma tüketir.

Erişim için node iki mod sunar: hazır bir n8n arayüzüne sahip Hosted Chat ve webhook URL'si üzerinden kendi uygulamanıza entegre ettiğiniz Embedded Chat. Güvenlik için kimlik doğrulama yok, Basic Auth veya n8n'in kendi kullanıcı kimlik doğrulaması kullanılabilir. Yanıt modlarında son node'dan sonra tamamlama, ayrı yanıt node'ları ve gerçek zamanlı çıktı için bir streaming yanıtı arasında seçim yapabilirsiniz.

Kullanım önerisi: İnsanların n8n'de doğrudan bir yapay zeka (YZ) ajanıyla iletişim kurması gerektiğinde Chat Trigger uygundur, örneğin bir iç destek botu, kendi belgelerinize dayalı bir bilgi asistanı veya bir web sitesine yerleştirilmiş bir sohbet arayüzü için.

Senaryoya göre tetikleyici türü seçme

Pratik için genel bir yönlendirme olarak:

• Sabit zaman noktaları veya aralıklar: Schedule Trigger.
• Başka bir sistemin aktif olarak bir şey bildirmesi gerekiyor: Webhook Trigger.
• Kaynak push bildirimi sunmuyor: Polling Trigger, örneğin RSS Feed Trigger veya IMAP üzerinden Email Trigger.
• Test veya bilinçli olarak manuel kontrol edilen süreç: Manual Trigger.
• Bir yapay zeka (YZ) ajanıyla doğrudan diyalog: Chat Trigger.

Pratikte bu türleri genellikle bir otomasyon konsepti içinde birleştirirsiniz: spontan istek için bir webhook, günlük takip kontrolü için bir Schedule Trigger, geliştirme sırasında testler için bir Manual Trigger. Tetikleyicilerinizin seçimi veya doğru yapılandırılması konusunda emin değilseniz, NordFlux size n8n workflow'larının kurulumu ve güvenliği konusunda senaryonuza uygun bir tetikleyici stratejisiyle destek olur.

Sıkça Sorulan Sorular

Bir workflow aynı anda birden fazla tetikleyiciye sahip olabilir mi?

Evet, bir workflow birden fazla trigger node içerebilir, örneğin bir Schedule Trigger ve buna ek olarak bir webhook. Ancak her çalıştırmada yalnızca koşulu gerçekten gerçekleşen tetikleyici devreye girer, diğerleri o anda etkin olmaz.

Webhook Trigger ile Polling Trigger arasındaki fark nedir?

Webhook Trigger, gelen çağrıları pasif olarak bekler ve dış bir sistem ona aktif olarak ulaştığında neredeyse gerçek zamanlı olarak tepki verir. Polling Trigger ise kendisi belirlenen bir ritimde kaynağa yenilik olup olmadığını sorar; bu, kendi push bildirimini sunmayan hizmetler için özellikle uygundur.

Schedule Trigger'ın çalışması için workflow'un yayınlanmış olması gerekir mi?

Evet, dokümantasyona göre Schedule Trigger yalnızca yayınlanmış bir workflow için devreye girer. Kaydedilmiş cron değişkenlerindeki değişiklikler de ancak yeniden yayınlandıktan sonra etkili olur.

Manual Trigger üretim ortamında ne için uygundur?

Manual Trigger öncelikle testler ve tek seferlik veri taşımaları gibi bilinçli olarak manuel kontrol edilen süreçler için tasarlanmıştır. Sürekli çalışan, otomatikleştirilmiş süreçler için uygun değildir, çünkü orada kimsenin düzenli olarak manuel şekilde "Çalıştır" seçeneğine tıklaması gerekmemelidir.

Bir Chat Trigger workflow'u kaç çalıştırma tüketir?

Bir konuşma içindeki her tek mesaj, tam bir workflow çalıştırması tetikler. On mesajlık bir konuşma bu nedenle on ayrı çalıştırmaya karşılık gelir ve bu, çalıştırma kotanızı planlarken dikkate almanız gereken bir husustur.