Bu rehberde: İş akışını neyin başlattığını öğrenirsiniz. Altı tetikleyici türünü tanır, zamanlama ifadelerini (cron) kolayca yazar ve saat dilimi tuzaklarından kaçınırsınız.
⏱ 12 dakika
Tetikleyici nedir?
Her iş akışı bir tetikleyici ile başlar. Tetikleyici, "ne zaman çalışayım?" sorusunun yanıtıdır. Bir iş akışında yalnızca bir tetikleyici bulunur.
| Kutu | Ne zaman çalışır | Çalıştırma türü |
|---|---|---|
Manuel (trigger.manual) | Çalıştır düğmesine basınca veya API çağrısıyla | Manuel / API |
Zamanlama (trigger.schedule) | Belirlediğiniz saatlerde | Zamanlama |
Webhook (trigger.webhook) | Dış bir sistem adresinize istek gönderince | Webhook |
Mesaj geldi (trigger.messageReceived) | WhatsApp, Telegram vb. kanala mesaj gelince | Sohbet |
Platform olayı (trigger.event) | OrqLabs içinde bir olay olunca (yeni aday, yayın hatası...) | Olay |
Form (trigger.form) | OrqLabs'ın barındırdığı form gönderilince | Webhook |
Alan tabloları için Tetikleyici node'ları. Bu rehber zamanlama davranışına odaklanır.
④'teki sütun her iş akışının tetikleyici türünü gösterir.
Zamanlama yazmak (cron)
Zamanlama kutusu beş parçalı bir ifade kullanır. Korkutucu görünür ama mantığı basittir:
┌───────── dakika (0-59)
│ ┌─────── saat (0-23)
│ │ ┌───── ayın günü (1-31)
│ │ │ ┌─── ay (1-12)
│ │ │ │ ┌─ haftanın günü (0-7; 0 ve 7 = Pazar, 1 = Pazartesi)
* * * * *
* "her" demektir. , liste, - aralık, / adım.
| Ne istiyorsunuz | İfade |
|---|---|
| Hafta içi her gün 08:00 | 0 8 * * 1-5 |
| Her gün 09:00 ve 18:00 | 0 9,18 * * * |
| Her saat başı | 0 * * * * |
| Her 15 dakika | */15 * * * * |
| Her 6 saatte | 0 */6 * * * |
| Pazartesi 07:00 | 0 7 * * 1 |
| Cumartesi ve Pazar 11:00 | 0 11 * * 6,0 |
| Ayın 1'i 08:00 | 0 8 1 * * |
| Ayın 28'i 17:00 | 0 17 28 * * |
| Çeyrek başları (Oca, Nis, Tem, Eki) 1'i 09:00 | 0 9 1 1,4,7,10 * |
| Hafta içi 09:00-18:00 arası her saat | 0 9-18 * * 1-5 |
İpucu: Denetçi panelindeki cron alanı sonraki üç çalıştırmayı seçili saat diliminde önizler. İfadeyi yazın; tarihlere bakın; doğruysa devam edin.
Dikkat: En sık tetikleme aralığı 1 dakikadır. Plan kotanızı düşünün: FREE ayda 100, STARTER 2.000, PRO 25.000 çalıştırma.
*/15 * * * *ayda yaklaşık 2.900 çalıştırma demektir.
Saat dilimi
- Zamanlama kutusundaki Saat dilimi alanına bölge adı yazılır:
Europe/Istanbul,Europe/Berlin,America/New_York. Boşsa iş akışı ayarlarındaki saat dilimi, o da boşsa UTC kullanılır. - Türkiye yaz saati uygulamaz;
Europe/Istanbulyıl boyu UTC+3'tür. Avrupa ve ABD dilimlerinde yaz saati geçişinde bir çalıştırma atlanabilir veya iki kez tetiklenebilir. Kritik işlerde UTC kullanın. $todayifadesi iş akışı saat dilimine göre hesaplanır;$nowher zaman UTC'dir.- Social Publisher'ın "en iyi saat" seçimi projenin saat dilimini kullanır.
Aynı anda çalışma ve kaçırılan çalıştırmalar
- Maks. eşzamanlı çalıştırma (varsayılan 1): önceki çalıştırma sürüyorsa yenisi sıraya alınır. Sırada birden fazla bekleyen varsa yalnızca en yenisi tutulur.
- Sistem kapalıyken kaçırılan zamanlamalar geriye dönük çalıştırılmaz; bir sonraki zamanda çalışır.
- Çalıştırma Maks. çalıştırma süresi'ni aşarsa hata ile biter; hata iş akışı varsa o tetiklenir.
- Onay bekleyen çalıştırmalar eşzamanlılık sayacına dahil değildir.
Webhook tetikleyici
Dış sistemler (site formu, Zapier, CRM) OrqLabs'a istek gönderir. Adres kalıbı: https://api.orqlabs.com/api/v1/hooks/<yol>. İş akışı Etkin değilse 404 döner. Gizli anahtar doluysa istek X-Webhook-Secret başlığını taşımalıdır. Ayrıntı: Webhook ve API tetikleyicileri.
Olay tetikleyici
Şu olaylardan birini dinler: yeni aday, aday nitelendi, aday yanıt verdi, gönderi yayınlandı, yayın hatası, konuşma devredildi, analitik eşiği, rapor oluştu, onay kararı, bütçe uyarısı.
Filtre alanı olay verisi üzerinde çalışır. Yanlış dönerse çalıştırma oluşmaz ve kota tüketmez. Örneğin yalnızca 85 puan üstü adaylar için: {{ $json.score >= 85 }}.
Dikkat: Kendi iş akışınızın ürettiği olayla kendini tetiklemesini önlemek için filtreye
{{ $json.workflowId !== "<bu iş akışı>" }}ekleyin.
Mesaj tetikleyici
Yalnızca iş akışının projesine bağlı kanallardan gelen mesajlarda çalışır. Konuşmayı bir insan devralmışsa tetiklenmez. Aynı projede aynı kanalı dinleyen iki etkin iş akışı varsa ikisi de çalışır; bunu istemiyorsanız Anahtar kelime filtresi ile ayırın.
Manuel ve API tetikleme
- Panel: Çalıştır düğmesi.
- API:
POST /orgs/:orgId/workflows/:id/run { input, testMode?, nodeId? }.inputilk öğenin verisi olur. - Başka bir iş akışından İş akışı çalıştır kutusuyla çağrıldığında da API türünde kaydedilir.
Örnek zamanlama planı
| İş akışı | İfade | Saat dilimi | Not |
|---|---|---|---|
| Günlük içerik | 0 8 * * 1-5 | Europe/Istanbul | Onay için sabah 08:00; yayın 09:30-19:00 |
| Yorum yanıtlama | 0 * * * * | – | Saatlik; yalnızca yeni yorumlar |
| Müşteri adayı araştırma | 0 9 * * 1 | Europe/Istanbul | Haftada 20 aday |
| Analitik incelemesi | 0 7 * * 1 | Europe/Istanbul | GA4 verisi 24-48 saat gecikmeli; Pazartesi sabahı geçen haftayı kapsar |
| SEO denetimi | 0 8 1 * * | Europe/Istanbul | Aylık |
| Haftalık özet | 0 8 * * 1 | Europe/Istanbul | Analitik incelemesinden 1 saat sonra |
Sorun giderme
| Belirti | Neden | Çözüm |
|---|---|---|
| Zamanında çalışmadı | İş akışı Taslak/Duraklatılmış; saat dilimi UTC | Etkinleştirin; saat dilimini kontrol edin |
| İki kez çalıştı | Aynı zamanlamayla iki etkin iş akışı; yaz saati | Listeyi kontrol edin; UTC kullanın |
| Webhook 404 | İş akışı etkin değil veya yol değişti | Etkinleştirin; adresi denetçiden yeniden kopyalayın |
| Webhook 401 | Gizli anahtar eşleşmiyor | X-Webhook-Secret başlığını ekleyin |
| Olay tetiklemedi | Filtre yanlış dönüyor | Filtreyi kaldırıp veriyi inceleyin, sonra daraltın |
| Çalıştırma sırada kaldı | Eşzamanlılık 1 ve önceki çalıştırma sürüyor | Öncekini iptal edin veya eşzamanlılığı artırın |
Sık sorulan sorular
Aynı iş akışını hem zamanlama hem webhook ile başlatabilir miyim? Bir iş akışında tek tetikleyici olur. Ortak kısmı ayrı bir iş akışına alın; iki farklı tetikleyicili iş akışından İş akışı çalıştır kutusuyla çağırın.
Zamanlama tam saatinde mi çalışır? Zamanlayıcı her dakika kontrol eder. Birkaç saniye ile birkaç dakika gecikme normaldir.
Test çalıştırması zamanlamayı bekler mi? Hayır. Test düğmesi tetikleyiciyi hemen ateşler.
Hafta sonu çalışmasını nasıl engellerim?
Haftanın günü alanına 1-5 yazın: 0 8 * * 1-5.