Tetikleyici (Trigger) node'ları

Bu rehberde: İş akışını neyin başlattığını seçersiniz: bir düğme, bir saat, bir web isteği, gelen bir mesaj, bir platform olayı veya bir form. Altı tetikleyicinin tüm alanlarını ve örneklerini bulursunuz.

⏱ 10 dakika

Kısaca#

Tetikleyici (trigger), iş akışının "başla" düğmesidir. Her iş akışında tam olarak bir tane bulunur ve paletteki Tetikleyiciler kategorisindedir. Tetikleyici yalnızca iş akışı Etkin iken kendiliğinden çalışır; Taslak durumunda yalnızca Test ile denenir.

Teknik ayrıntılar#

Her iş akışı tam olarak bir tetikleyici (trigger) node'u ile başlar. Tetikleyicinin girdi handle'ı yoktur (inputs: 0); çalıştığında ilk item'ları üretir ve akış oradan topolojik sırayla ilerler. İş akışı Etkinleştir (activate) edildiğinde tetikleyici kaydedilir: cron zamanlayıcıya, webhook yoluna veya olay aboneliğine.

Manual trigger (trigger.manual)#

Panelden Çalıştır düğmesiyle veya API'den (POST /orgs/:orgId/workflows/:id/run { input }) başlatılır. Test ve isteğe bağlı işler için idealdir.

Çıktı: tek item; json = input (veya sampleInput). {{ $json.topic }} gibi erişirsiniz.

Örnek: sampleInput: { "topic": "Yeni ürün lansmanı", "platforms": ["X", "LINKEDIN"] } → agent.contentCreator (topic: {{ $json.topic }}).

Schedule (trigger.schedule)#

Cron ifadesine göre çalışır. Zamanlayıcı kuyruğu (scheduler) her dakika etkin iş akışlarını kontrol eder.

Çıktı: tek item { "scheduledFor": "<ISO>", "firedAt": "<ISO>", "cron": "..." }.

Sık kullanılan ifadeler:

Aynı iş akışının önceki çalıştırması hâlâ sürüyorsa settings.concurrency (varsayılan 1) yeni çalıştırmayı kuyrukta bekletir. Ayrıntı: Tetikleyiciler ve zamanlamalar.

Webhook (trigger.webhook)#

Benzersiz bir URL'ye gelen HTTP isteğiyle başlar: https://api.orqlabs.com/api/v1/hooks/<webhookPath>. URL'yi denetçi panelinden veya GET /orgs/:orgId/workflows/:id/webhook-url ile alın.

Çıktı item'ı: { "body": {...}, "query": {...}, "headers": {...}, "method": "POST" }. Gövde alanlarına {{ $json.body.email }} ile erişirsiniz.

Örnek – site formundan lead:

trigger.webhook (POST, secret: "f0rm-s3cret", respond: immediately)
  → leads.create (mapping: name: {{ $json.body.name }}, email: {{ $json.body.email }})
  → agent.leadQualifier

Gönderim:

curl -X POST "https://api.orqlabs.com/api/v1/hooks/abc123" \
  -H "Content-Type: application/json" -H "X-Webhook-Secret: f0rm-s3cret" \
  -d '{"name":"Ayşe Kaya","email":"ayse@ornek.com"}'

Message received (trigger.messageReceived)#

Bağlı bir mesajlaşma kanalına (WhatsApp, Telegram, Slack, Discord, Messenger, Email, SMS) mesaj geldiğinde çalışır. Kanal entegrasyonu iş akışının projesine bağlı olmalıdır; webhook kurulumu için ilgili entegrasyon rehberine bakın.

Çıktı item'ı:

{
  "channel": "WHATSAPP",
  "integrationId": "int_...",
  "conversationId": "conv_...",
  "contactId": "905xxxxxxxxx",
  "contactName": "Ayşe",
  "text": "Fiyat listesi alabilir miyim?",
  "mediaUrl": null,
  "isNewConversation": false,
  "receivedAt": "2026-09-25T10:12:00Z",
  "leadId": "lead_..."
}

Konuşma HUMAN durumundaysa (insan devralmışsa) tetikleyici çalışmaz; bot duraklatılmıştır. Örnek: WhatsApp ve Telegram yapay zekâ sohbet botu şablonu – trigger.messageReceived → agent.chatbot → logic.if (handoff) → messaging.handoff / messaging.send.

Platform event (trigger.event)#

OrqLabs'un iç olaylarında çalışır. Olay yükü item'ın json'u olur.

Bu node'da seçilebilen olaylar PLATFORM_EVENTS listesinin bir alt kümesidir; tam liste ve yükler için Giden webhook'lar.

Örnek 1 – sıcak lead bildirimi: trigger.event (lead.qualified, filter: {{ $json.score >= 85 }}) → utility.notify (title: "Sıcak lead: {{ $json.name }}", channels: [inapp, slack]).

Örnek 2 – yayın hatasında tekrar: trigger.event (post.failed) → logic.wait (30 dakika) → social.publish (dryRun: false).

Form submission (trigger.form)#

OrqLabs'un barındırdığı bir lead formu üretir: https://api.orqlabs.com/api/v1/public/forms/<slug> (GET form tanımını, POST gönderimi alır). Sitenize iframe veya link olarak ekleyin; denetçi paneli embed kodunu gösterir.

Çıktı item'ı: { "name": "...", "email": "...", "phone": "...", "message": "...", "submittedAt": "...", "ip": "...", "utm": {...} }.

Örnek: trigger.form → leads.create → messaging.sendEmail (to: {{ $json.email }}, subject: "Talebinizi aldık") → agent.leadQualifier.

İpuçları ve sınırlar#

• Bir iş akışında yalnızca bir tetikleyici bulunur. Aynı akışı hem zamanlanmış hem webhook ile başlatmak için iki iş akışı yapın ve ortak kısmı utility.runWorkflow ile çağırın.
• Tetikleyici yalnızca iş akışı ACTIVE iken çalışır; DRAFT ve PAUSED durumunda yalnızca manuel test çalıştırması yapılabilir.
• Test modunda (testMode: true) tetikleyici sampleInput kullanır ve dış etkili node'lar (social.publish, messaging.send) dry-run olur.
• Webhook ve form uç noktaları organizasyon başına dakikada 600 istekle sınırlıdır; aşımda 429 döner.
• Plan limiti runsPerMonth dolduğunda tetikleyiciler çalıştırmayı kuyruğa almaz; budget.warning bildirimiyle haberdar olursunuz.

Sık sorulan sorular#

Bir iş akışına iki tetikleyici ekleyebilir miyim? Hayır. İki ayrı iş akışı yapın ve ortak kısmı İş akışı çalıştır kutusuyla çağırın.

Zamanlama tam saatinde mi çalışır? Zamanlayıcı her dakika kontrol eder; birkaç saniyelik gecikme normaldir.

Test ederken gerçek mesaj beklemem gerekir mi? Hayır. Test düğmesi tetikleyiciyi örnek veriyle hemen ateşler.

Sonraki adım#

• Tetikleyiciler ve zamanlamalar
• Webhook ve API tetikleyicileri
• Mesajlaşma node'ları