Tetikleyici Kontrol

Gelen ve giden webhook'ları yönetin — harici olaylardan iş akışlarını tetikleyen HTTP dinleyicileri yapılandırın.

Genel Bakış

Tetikleyici Kontrol, harici sistemlerin TotalApp iş akışlarını başlatmasına olanak tanıyan merkezi webhook yönetim ekranıdır. Her tetikleyici, benzersiz bir HTTPS URL'si olan bir HTTP dinleyicisidir. Dışarıdan bir POST isteği geldiğinde, bağlı iş akışı otomatik olarak başlar ve gelen yük verisi iş akışı boyunca akış sağlar.

Tetikleyici Kontrol; WooCommerce, Shopify, GitHub ve özel HTTP kaynaklarından gelen olayları destekler. Tüm tetikleyiciler anlık olarak etkinleşir ve ek sunucu yapılandırması gerektirmez. Gelen her istek oturum günlüğüne kaydedilir; başarısız veya reddedilen istekler ayrıca işaretlenir.

Webhook Oluşturma

Yeni Tetikleyici → URL Oluştur → İş Akışı Seç → Kaydet

Tetikleyici Kontrol — Yeni Webhook

Webhook URL

https://app.totalapp.app/api/webhooks/woocommerce/abc123def456 Kopyala

Platform

WooCommerce

Durum

● Aktif

Tetikleyici Kontrol ekranında Yeni Tetikleyici düğmesine tıklayın.
Platform seçin (WooCommerce, Shopify, HTTP Genel vb.).
Sistem benzersiz bir HTTPS URL'si oluşturur — bu URL'yi dış sistemdeki webhook ayarına girin.
Tetikleyici ateşlendiğinde çalışacak iş akışını seçin.
Kaydet'e tıklayın. Tetikleyici anında aktif olur ve ilk istek beklemeye başlar.

Desteklenen Tetikleyiciler

Tip	Açıklama	Örnek Olay
HTTP Webhook	Herhangi bir kaynaktan gelen POST istekleri	Özel uygulama eventi
WooCommerce	WooCommerce mağazanızdan sipariş ve ürün olayları	order.created, product.updated
Shopify	Shopify mağaza olayları	orders/create, products/update
GitHub	Depo olayları (push, PR, issue)	push, pull_request
Zamanlayıcı	Cron tabanlı periyodik tetikleyiciler	Her gün 09:00

Güvenlik

Her webhook tetikleyicisi için üç katmanlı güvenlik mekanizması mevcuttur: gizli token, imza doğrulama (HMAC-SHA256) ve isteğe bağlı IP beyaz listesi. Her webhook isteği, dış sistem tarafından oluşturulan X-Webhook-Signature başlığını içermelidir. TotalApp bu imzayı gizli token ile doğrular; geçersiz veya imzasız istekler 401 Unauthorized yanıtı ile anında reddedilir ve günlüğe işlenir.

IP beyaz listesi opsiyoneldir ve yüksek güvenlikli senaryolar için önerilir. Beyaz listeye alınmamış bir IP'den gelen istek, imza doğru olsa bile reddedilir. Beyaz listeyi Tetikleyici ayarları → Güvenlik sekmesinden düzenleyebilirsiniz.

Yerel Geliştirme için ngrok Kullanın

Geliştirme ortamında webhook'ları test etmek için ngrok veya benzer bir tünel aracı kullanabilirsiniz: ngrok http 3000. Üretim ortamında TotalApp'in sağladığı HTTPS URL'sini kullanın; ek yapılandırma gerekmez.

Sık Sorulan Sorular

Bir webhook URL'si ne kadar süre geçerlidir?

Siz silmedikçe webhook URL'leri süresiz geçerlidir. Güvenlik ihlali şüphesi durumunda Tetikleyici Kontrol ekranından URL'yi yenileyebilirsiniz; yeni URL anında etkinleşir ve eski URL geçersiz hale gelir.

Gelen webhook verisi iş akışında nasıl kullanılır?

Gelen JSON yükü, tetikleyici düğümünün çıktısı olarak iş akışına girer. Sonraki düğümler bu veriyi triggerPayload değişkeni aracılığıyla okuyabilir. Betik düğümünde input.triggerPayload.orderId gibi bir ifadeyle belirli alanlara erişebilirsiniz.

Aynı anda kaç aktif webhook olabilir?

Plan sınırınıza göre değişir. Ücretsiz planda 3, Basic planda 10, Pro ve Enterprise planlarda sınırsız webhook desteği sunulur. Mevcut webhook sayınızı Tetikleyici Kontrol ekranının üst bölümünden görebilirsiniz.