n8n ile sevDesk: Polling Tetikleyicisi, API Sınırları
sevDesk'in yerel bir n8n düğümü yoktur: belgelenen API sınırları dahil, Schedule Trigger ve HTTP Request düğümüyle bir polling tetikleyicisi nasıl kurulur.
n8n'deki tüm tetikleyici türlerine genel bakış: Schedule, Webhook, Polling, Manual ve Chat; her senaryo için kullanım önerisiyle birlikte.
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.
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, 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:
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 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:
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.
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 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, 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.
Pratik için genel bir yönlendirme olarak:
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.
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, 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.
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 ö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 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.
NordFlux, kuruluşlar için dijital çalışanlar kurar: tekrar eden işleri üstlenen otomasyonlar ve KI ajanları. Kontrol sizde kalır.
sevDesk'in yerel bir n8n düğümü yoktur: belgelenen API sınırları dahil, Schedule Trigger ve HTTP Request düğümüyle bir polling tetikleyicisi nasıl kurulur.
Cron ifadesi neredeyse her zaman doğrudur, saat dilimi değil. Üç gerçek n8n forum vakası, Schedule Trigger'ların neden yanlış zamanda tetiklendiğini gösteriyor.
Bir n8n ajanının sohbet geçmişini neden unuttuğu, oturum anahtarlarının nasıl çalıştığı ve Simple Memory ya da Postgres Memory'nin ne zaman doğru seçim olduğu.
Schedule, Webhook, Polling, Manual ya da Chat, doğru trigger seçimi genellikle bütün bir workflow'un güvenilirliğini ve bakım yükünü belirler. NordFlux, süreçlerinize ve sistemlerinize uygun trigger mimarisi konusunda üretici bağımsız danışmanlık verir, talep halinde işletimi de üstlenir. İlk görüşmede somut senaryonuzu birlikte değerlendiririz.