İş Akışı Çalıştırma
Bir iş akışı kurmak işin yalnızca yarısıdır — diğer yarısı onu çalıştırmak ve ne olduğunu izlemektir.
Bir çalıştırma, iş akışının tetikleyici bloğundan son adımına kadar tek bir yürütülmesidir. Siz hâlâ kurarken düzenleyiciden kendiniz bir çalıştırma başlatabilirsiniz; ayrıca iş akışının bir zamanlama, bir webhook, bir form, yeni bir e-posta, bir dosya, bir sohbet konuşması veya dış bir istek üzerine kendi kendine başlamasını sağlayabilirsiniz.
Bu sayfa her ikisini de anlatır: iş akışını elle nasıl çalıştıracağınızı ve kendi kendine başlama yollarını nasıl kuracağınızı.
Kendiniz Çalıştırma
Bir iş akışını test etmenin en hızlı yolu onu düzenleyiciden çalıştırmaktır.
- İş akışını açın.
- Yan panel başlığındaki Çalıştır'a tıklayın — veya Ctrl/Cmd + Enter tuşlarına basın.
Çalıştırma başladı — Kayıtlar sekmesinden izleyebilirsiniz. mesajını görürsünüz. Çalıştırma arka planda sürer; düzenlemeye devam edebilir, sekme değiştirebilir veya sayfadan tamamen ayrılabilirsiniz.
Çalıştır soluk göründüğünde
Çalıştır yalnızca birkaç koşul sağlandığında çalışır. Düğme soluksa üzerine gelin — ipucu hangi koşulun eksik olduğunu tam olarak söyler.
| İpucu | Ne yapmalısınız |
|---|---|
| Önce değişikliklerinizi kaydedin | Tuvalde kaydedilmemiş değişiklikler var. Kaydet'e tıklayın (veya Ctrl/Cmd + S), sonra çalıştırın. |
| Önce en az bir blok ekleyin | Tuval boş. Bir blok ekleyin — bkz. İş Akışı Oluşturma. |
| Copilot kuruyor — lütfen bekleyin | Copilot şu anda bu iş akışını düzenliyor. Bitirmesini bekleyin. |
| Bu iş akışını çalıştırma izniniz yok | Çalıştırma, düzenlemeden ayrı bir izindir. Yöneticinize başvurun. |
Çalıştır ile başlattığınız bir çalıştırma her zaman iş akışının kaydedilmiş hâlini kullanır, ekranda o an görüneni değil. Çalıştır düğmesinin kaydedilmemiş değişikliklerde kapanmasının nedeni budur — böylece çalışan şey her zaman gördüğünüz şeydir. Henüz yayımlanmamış olsalar bile en son kaydettiğiniz düzenlemeleri çalıştırır — bkz. Değişiklikleri yayımlama.
Bir çalıştırma sürerken Çalıştır düğmesi Durdur'a dönüşür (iptal ederken Durduruluyor… gösterir).
Girdi Sağlama
Çoğu iş akışının bir başlangıç verisine ihtiyacı vardır — bir müşteri adı, bir rapor tarihi, işlenecek bir mesaj. Bu veri tetikleyici bloktan gelir ve sonraki tüm bloklar onu okuyabilir.
Başlat bloğunda girdi tanımlama
Başlat bloğu bir Girdi bölümü taşır. Bu bölüm, bloğun ayrıntı görünümündeki Ek alanları göster altındadır (bloğa çift tıklayın veya üzerine gelince çıkan tepsideki Ayrıntıları aç'ı kullanın).
İhtiyacınız olan her veri parçası için bir alan ekleyin:
| Alan | Ne işe yarar |
|---|---|
| Ad | Sonraki blokların bu değeri okumak için kullandığı ad (yer tutucu field_name). |
| Tür | Değerin nasıl okunacağı: metin, sayı, boole, nesne veya dizi. |
| Değer | Düzenleyicide Çalıştır'a tıkladığınızda kullanılan test değeri (yer tutucu Test değeri). |
Yeni alan eklemek için + düğmesini, bir alanı kaldırmak için çöp kutusu simgesini, işiniz biten bir alanı katlamak için ok simgesini kullanın.
Ayrı bir "çalıştırma" penceresi yoktur. Girdi bölümünün kendisi formdur — Çalıştır'a tıkladığınızda Değer kutularına yazdığınız şey gönderilir. Ad girilmemiş alanlar yok sayılır.
Girdileri sonraki bloklarda okuma
İş akışının herhangi bir yerinde bir tetikleyici girdisine adıyla referans verin:
<input.NAME>
Yani customerEmail adlı bir alan <input.customerEmail> olarak okunur. Aynı yazım, çalıştırmanın nasıl başladığından bağımsız olarak geçerlidir — elle çalıştırma, bir webhook teslimatı, bir zamanlama veya bir sohbet isteği hepsi aynı <input.*> yuvasını doldurur.
Değerler seçtiğiniz Tür'e göre gelir: sayı seçerseniz 42 bir sayı olarak gelir; nesne veya dizi seçerseniz JSON metni yapılandırılmış veri olarak okunur.
Girdiler, bir bloğun referans verebileceği üç şeyden yalnızca biridir. Ayrıca daha önceki bir bloğun sonucunu <blokAdı.alan> ile (örneğin <agent.content>) ve saklanmış bir iş akışı değişkenini <variable.NAME> ile okuyabilirsiniz — bkz. Değişkenler.
Bir çalıştırmayı izleme
Düzenleyiciden başlattığınız bir çalıştırma, düzenleyicinin alt kenarındaki Kayıtlar bölmesinde görünür. Bölme daraltılmışsa açmak için başlığına tıklayın; çalıştırma bitene kadar kendini güncel tutar.
Bölmenin ilk satırı çalıştırmanın durum satırıdır. Şunları gösterir:
- Renkli bir rozet olarak güncel durum.
- {n} adım kaydedildi — şimdiye kadar kaç adımın tamamlandığı.
- Çalıştırma bittiğinde süre.
- Çalıştırma başarısız olduysa hata mesajı.
Altında, çalışan her blok kendi satırını alır; o bloğun Çıktı ve Girdi verisini okumak için bir satıra tıklayın. Bölmenin tamamı Araç Çubuğu sayfasında anlatılır.
Çalıştırma bittiğinde, düzenleyicide nerede olursanız olun kısa bir mesaj da görürsünüz: "Çalıştırma tamamlandı — çıktı için Kayıtlar sekmesini açın.", "Çalıştırma başarısız — hata için Kayıtlar sekmesini açın." veya "Çalıştırma iptal edildi."
Çalıştırma durumları
| Durum | Anlamı |
|---|---|
| Sırada | Kabul edildi, başlamayı bekliyor. |
| Çalışıyor | Adımlar şu anda yürütülüyor. |
| Tamamlandı | Başarıyla tamamlandı. |
| Başarısız | Bir adım başarısız oldu — mesaj neyin ters gittiğini söyler. |
| İptal Edildi | Siz durdurdunuz. |
| Duraklatıldı | Devam edebilmek için bir şey bekliyor — bir bağlantı ya da bir kişi. |
Çalıştırma kontrolleri
| Kontrol | Ne zaman görünür | Ne yapar |
|---|---|---|
| Devam ettir | Çalıştırma bir bağlantı için Duraklatıldı durumundayken | Çalıştırmayı kaldığı yerden sürdürür (Devam ettiriliyor… gösterir). Çalıştırma bir kişiyi beklerken sunulmaz. |
| Durdur | Sırada, Çalışıyor veya Duraklatıldı durumundayken | Çalıştırmayı iptal eder (Durduruluyor… gösterir). |
| × (gizle) | Her zaman | Çalıştırmayı bölmeden gizler. Çalıştırmayı durdurmaz. |
Devam ettir ve Durdur için ayrı ayrı izin gerekir; izniniz yoksa düğme soluktur ve ipucu bunu söyler.
× yalnızca çalıştırmayı ekranınızdan gizler — çalıştırma arka planda sürmeye devam eder. Gerçekten iptal etmek istiyorsanız Durdur'u kullanın.
Bir çalıştırma bağlantı için duraklarsa
Bir adımın ihtiyaç duyduğu bağlantı eksik, reddedilmiş veya süresi dolmuşsa, çalıştırma doğrudan başarısız olmak yerine duraklar ve durum satırının altında kehribar renkli bir şerit belirir:
Kimlik bilgisi gerekli — {sağlayıcı}
Bundan sonra ne yapabileceğiniz bağlantı türüne bağlıdır:
| Durum | Şeridin sunduğu |
|---|---|
| Yerinde düzeltilebilen bir API anahtarı bağlantısı | Anahtarı güncelle düğmesi. Yeni anahtarı girin; çalıştırma kendiliğinden devam eder. |
| Bağlantı blokla eşleştirilemiyor | Adı verilen blokta bir kimlik bilgisi seçmeniz istenir (blok adı, onu açan bir bağlantıdır); ardından yeniden çalıştırın. |
| Bir bağlı hesap (oturum açma tabanlı) | Buradan yeniden bağlanmanın henüz kullanılabilir olmadığı belirtilir — hesabı Bağlantılar altından yeniden bağlayın ve yeniden çalıştırın. |
Bağlantıların nasıl eklendiğini, test edildiğini ve onarıldığını görmek için bkz. Bağlantılar.
Bir çalıştırma bir kişiyi beklerse
Bazı adımlar çalıştırmayı bir kişiye devreder ve bekler: bir formun sonraki sayfası ya da bir onay. Çalıştırma Duraklatıldı gösterir ve kehribar renkli bir şerit neyi beklediğini söyler:
| Şerit | Çalıştırmayı ne sürdürür |
|---|---|
| "Formu dolduran kişinin cevabı bekleniyor (son zaman: …). Cevap gelince çalıştırma devam eder." | Kişi form sayfasını gönderir — bkz. Formlar |
| "Onay bekleniyor (son zaman: …). Onaylayanların kararı gelince çalıştırma devam eder." | Onaylayanlar karar verir — bkz. Onaylar |
Bu çalıştırmalar için Devam ettir düğmesi yoktur: onları yalnızca kişinin cevabı sürdürür. Çalıştırmayı yine de Durdur ile durdurabilirsiniz. Blok kaydında, bekleyen adım Yanıt bekleniyor rozeti taşır.
Bir çalıştırmanın bir adrese ulaşması engellenirse
Bir blok, kurumunuzun izin vermediği bir dış adrese ulaşmaya çalıştıysa çalıştırma başarısız olur ve kırmızı bir şerit nedeni söyler — örneğin "Engellendi — api.example.com izinli listede değil" — ve ardından "Blok, ağa ulaşamadan durduruldu; yani bu bir izin sorunu, kodda bir hata değil."
Şeritteki Hangi adresler'e tıklayın. Kayıtlar sekmesi açılır; başarısız adımın hata kartı reddedilen her adresi listeler. (Kaydedilmemiş düzenlemeleriniz varsa önce bunları atıp atmayacağınız sorulur.) Bir yönetici bu adreslere İş Akışları → Paketler altında, paket listesinin hemen altında izin verebilir — bkz. Paketler.
Benzer bir şerit, paylaşımlı klasördeki bir dosyayı okuyamayan ya da yazamayan bir adımı açıklar — bkz. Paylaşımlı Klasör.
Tüm resmi görmek
Bölme, az önce başlattığınız çalıştırmayı izler. Herhangi bir çalıştırmanın adım adım ayrıntısı için — bir zamanlamanın, bir webhook'un ya da başka birinin başlattıkları dahil — İş Akışları sayfasındaki Kayıtlar sekmesini açın. Bkz. Kayıtlar.
Aktif ve Pasif İş Akışları
Düzenleyiciden elle yapılan bir çalıştırma, iş akışı hangi durumda olursa olsun her zaman çalışır. Otomatik tetikleyiciler farklıdır: yalnızca iş akışının kendisi Aktif olduğunda devreye girer.
İş Akışları sayfasında bir iş akışı kartının üzerine gelin ve aç/kapat düğmesini kullanın:
- Etkinleştir — iş akışını yayımlar ve üzerindeki tüm otomatik tetikleyicileri devreye alır. "İş akışı etkinleştirildi — tetikleyiciler açıldı" mesajını görürsünüz.
- Pasifleştir — onları devreden çıkarır. Zamanlamalar çalışmayı bırakır, webhook teslimatları düşürülür ve iş akışı artık sohbetten başlatılamaz. "İş akışı pasifleştirildi — tetikleyiciler duraklatıldı" mesajını görürsünüz.
Bir iş akışı kurmuş olmak, onun kendi kendine çalışması için yeterli değildir. Siz etkinleştirene kadar bir zamanlama onu atlar ve bir webhook teslimatı atılır — üstelik sessizce, çünkü gönderene hiçbir şey bildirilmez.
Bir iş akışı açılmıyorsa
Bir iş akışını açmak onu yayımlar ve Arketic önce onu denetler. Bir denetim başarısız olursa iş akışı Pasif kalır ve bir mesaj her sorunu adıyla söyler; örneğin:
- bir döngünün veya paralel bir dalın içinde duran bir onay adımı,
- başlığı veya alanı olmayan bir form,
- girdi şeması olmayan bir API tetikleyicisi,
- birbirine döngüsel olarak bağlanmış adımlar.
Mesaj siz kapatana kadar ekranda kalır. Söylediklerini düzeltin, kaydedin ve iş akışını yeniden açın.
Değişiklikleri yayımlama
Bir iş akışı Aktif olduğunda iki kopyası vardır: tetikleyicilerin çalıştırdığı yayımlanmış sürüm ve sizin düzenlediğiniz kaydedilmiş taslak. Bir düzenlemeyi kaydetmek yalnızca taslağı günceller.
| Çalıştırma nasıl başlıyor | Ne çalışır |
|---|---|
| Düzenleyicideki Çalıştır | En son kaydettiğiniz taslak |
| Düzenleyiciden yapılan bir tetikleyici testi | En son kaydettiğiniz taslak |
| Zamanlama, webhook, API çağrısı, form, sohbet isteği veya başka herhangi bir otomatik tetikleyici | Yayımlanmış sürüm |
Kaydedilmiş düzenlemeleri yayına almak için:
- Aktif iş akışını düzenleyicide açın ve değişikliklerinizi yapın.
- Kaydet'e tıklayın. İş akışı başlığının yanında kehribar renkli bir Yayımlanmamış değişiklikler şeridi belirir.
- Şeritteki Değişiklikleri yayımla düğmesine tıklayın.
- "Değişiklikler yayımlandı · Sürüm N" mesajını görürsünüz. Bundan sonra tetikleyiciler bu sürümü çalıştırır.
Bir denetim başarısız olursa "Yayımlanamadı:" ile başlayan bir mesaj neyin düzeltilmesi gerektiğini söyler ve tetikleyiciler önceki sürümü çalıştırmaya devam eder. Şeritteki her kontrol Araç Çubuğu sayfasında anlatılır.
:::tip İş akışı çalışmaya devam ederken güvenle düzenleyin Kaydedilen düzenlemeler taslak olarak beklediği için, aktif bir iş akışını birkaç oturumda elden geçirebilir, Çalıştır ile test edebilir ve yalnızca hazır olduğunda yayımlayabilirsiniz. Siz Değişiklikleri yayımla düğmesine tıklayana kadar onu tetikleyen kişiler ve sistemler için hiçbir şey değişmez. :::
Copilot'un düzenlemeleri de taslağa yazılır. Aktif bir iş akışında, kurduğu şeyden memnun kaldığınızda onları da aynı şekilde yayımlayın.
Bir İş Akışının Başlama Yolları
İstediğiniz tetikleyiciyi akışınızın ilk bloğu olarak ekleyin. Bir iş akışının birden fazla giriş noktası olabilir.
| Tetikleyici | Nasıl başlar | İş akışına ne verir |
|---|---|---|
| Başlat (elle) | Düzenleyicide Çalıştır'a tıklarsınız | Girdi alanlarına yazdığınız test değerleri |
| Webhook | Dış bir servis, bloğun adresine imzalı bir istek gönderir | İsteğin gövdesi, başlıkları, yolu, geliş zamanı ve çağıranın adresi |
| API Tetikleyici | Başka bir sistem, bloğun adresini anahtarıyla çağırır | İsteğin gövdesi, başlıkları ve sorgu değerleri |
| Form Tetikleyici | Biri formu doldurup gönderir — bkz. Formlar | Cevaplar ve formu kimin gönderdiği |
| Paylaşımlı Klasör Tetikleyici | Paylaşımlı klasörün izlenen bir klasörüne dosya gelir (dakikada bir kontrol edilir) — bkz. Paylaşımlı Klasör | Dosyanın yolu, adı, boyutu ve uzantısı |
| Gmail Tetikleyici | Bağlı bir Gmail gelen kutusuna yeni e-posta gelir (dakikada bir kontrol edilir) | Mesaj ve göndereni |
| Outlook Tetikleyici | Bağlı bir Outlook / Microsoft 365 gelen kutusuna yeni e-posta gelir (dakikada bir kontrol edilir) | Mesaj ve göndereni |
| IMAP Tetikleyici | Bir IMAP sunucusundaki posta kutusuna yeni e-posta gelir (dakikada bir kontrol edilir) | Mesaj ve göndereni |
| Telegram Tetikleyici | Telegram botunuz bir mesaj alır | Mesaj, göndereni ve güncelleme ayrıntıları |
| Slack Tetikleyici | Slack uygulamanız abone olduğunuz bir olayı alır | Mesaj, göndereni, kanalı ve olay ayrıntıları |
| WhatsApp Tetikleyici | WhatsApp Business numaranız bir mesaj alır | Mesaj, göndereni ve mesajın geldiği numara |
| Sohbet Tetikleyici | Siz onayladıktan sonra, bir AI asistanıyla sohbetten | Gönderdiğiniz mesaj ve etkinse yakın konuşma geçmişi |
| Hata Tetikleyicisi | Bu iş akışını hata iş akışı olarak seçen başka bir iş akışı başarısız olur | Hangi iş akışının, hangi çalıştırmanın başarısız olduğu ve hata |
Her tetikleyici bloğun neler sunduğu için bkz. Bloklar.
:::info Zamanlama bir blok değildir Bir iş akışını belirli aralıklarla çalıştırmak için blok eklemezsiniz — iş akışına Zamanlamalar sekmesinden bir zamanlama bağlarsınız. Zamanlanmış çalıştırma iş akışını ek bir girdi olmadan başlatır. Bkz. Zamanlamalar. :::
Webhook Tetikleyicileri
Bir Webhook bloğu, dış bir servisin iş akışınızı başlatmasını sağlar — bir form gönderimi, bir ödeme olayı, başka bir araçtan gelen bir uyarı.
İhtiyacınız olan her şeyi tek bir panelde bulmak için Webhook bloğunun ayarlarını açın.
Adres
Webhook'un adresi, bloğun panelini ilk açtığınızda otomatik olarak oluşturulur — hatırlamanız gereken bir "üret" düğmesi yoktur. Yanında bir kopyala düğmesi bulunan bir kutuda görünür. Gönderen servise yapıştırın.
İmzalama anahtarı
Adresin altında, bir isteğin gerçekten beklediğiniz servisten geldiğini kanıtlayan imzalama anahtarı yer alır.
İmzalama anahtarı yalnızca bir kez gösterilir — oluşturulduktan veya yenilendikten hemen sonra:
Bu gizli anahtarı şimdi kopyalayın — bir daha gösterilmeyecek. Yenilemek eski anahtarı anında geçersiz kılar.
Ondan sonra panel yalnızca noktalar ve "İmzalama anahtarı yalnızca oluşturulduğunda veya yenilendiğinde gösterilir." notunu gösterir. Kaybederseniz yenisini almak için yenileyin.
Yenile, anahtarı değiştirir. Bilinçli olarak iki adımlıdır: Yenile'ye tıklayın, sonra birkaç saniye içinde Onaylıyor musunuz?'a tıklayın (bir × iptal eder ve uzaklaşırsanız onay kendiliğinden devreden çıkar). Onayladığınız anda eski anahtar çalışmayı bırakır — gönderen servisi hemen güncelleyin.
Bir teslimatın kabul edilmesi için gerekenler
Gelen her istek, gönderen tarafından panelin altında yazan tarife göre imzalanmalıdır: bir zaman damgası başlığı ve imzalama anahtarınızdan üretilen bir imza başlığı. İmzalanmamış veya 5 dakikadan eski istekler düşürülür.
Webhook verisi kurumunuzun dışından gelir. Her <input.*> değerine güvenilmez veri gibi davranın — özellikle bir yapay zekâ istemine verirken.
Bir webhook'u duraklatma
Panel, webhook'un kendi durumunu gösterir — Aktif (yeşil nokta) veya Duraklatıldı (gri nokta) — yanında bir Duraklat / Devam ettir düğmesiyle.
Duraklatılmış bir webhook aldığı her şeyi sessizce düşürür. Devam ettirmek teslimatları yeniden kabul etmeye başlar ve reddedilen teslimat sayacını sıfırlar.
Reddedilen teslimatlar
Bir teslimat reddedildiğinde gönderene hiçbir şey bildirilmez; bu yüzden bunu öğrendiğiniz yer bu paneldir. İstekler reddediliyorsa kehribar renkli bir uyarı belirir:
Son kabul edilenden bu yana {n} teslimat reddedildi (son: …). Gönderenin imzasını, zaman damgasını ve IP adresini kontrol edin.
Bu genellikle gönderenin yanlış anahtarla imzaladığı, saatinin kaydığı ya da izin verilmeyen bir adresten çağırdığı anlamına gelir.
Gerçek bir olayla test etme
Bir webhook'u denemek için iş akışını açmanız gerekmez. Panel gerçek bir teslimatı yakalayıp kaydedilmiş taslağınızı onunla çalıştırabilir.
- İş akışını kaydedin.
- Webhook bloğunun panelinde Test olayını dinle'ye tıklayın.
- Panel bir geri sayımla "Bir test olayı dinleniyor — … kaldı" yazar ve bir test adresi gösterir. Bu adrese — olağan adrese değil — imzalı tek bir istek gönderin.
- İstek ulaştığında "Test olayı alındı — test çalışması başladı. Editörün Kayıtlar bölümünden izleyebilirsiniz." mesajını görürsünüz.
Test çalıştırması, neyin yayımlanmış olduğundan bağımsız olarak kaydedilmiş taslağınızı kullanır ve sizin adınıza çalışır. Geri sayım bitene kadar bir şey gelmezse panel "Olay gelmedi. Gönderen hazır olduğunda yeniden dinleyin." der — Yeniden dinle'ye tıklayın. Dinlemeyi durdur erken bitirir. Bu çalıştırmalar Kayıtlar sekmesinde Test olarak etiketlenir.
Son teslimatlar
Son teslimatlar altında, webhook ile başlamış son çalıştırmaları durumları ve saatleriyle görürsünüz — bir teslimatın gerçekten ulaştığının ve bir şey yaptığının en hızlı kanıtı. "Webhook ile tetiklenmiş çalıştırma henüz yok." şimdiye kadar adrese hiçbir şeyin ulaşmadığı anlamına gelir.
API Tetikleyici
Bir API Tetikleyici bloğu iş akışına, başka bir sistemin onu başlatmak — ve isterseniz bir cevap almak — için çağırabileceği bir adres verir.
Adres ve anahtar
Adres, bloğun panelini ilk açtığınızda otomatik olarak oluşturulur; yanında bir kopyalama düğmesi vardır. Altında, çağıranın göndermesi gereken tetikleyici anahtarı durur.
Anahtar yalnızca bir kez gösterilir — oluşturulduktan hemen sonra:
Bu anahtarı şimdi kopyalayın, bir daha gösterilmeyecek. Yeni anahtar eskisini hemen geçersiz kılar.
Ondan sonra panel noktalar ve "Anahtar yalnız oluşturulduğunda gösterilir. Kaybettiyseniz yenisini oluşturun." notunu gösterir.
Yeni anahtar onu iki adımda değiştirir: Yeni anahtar'a, sonra birkaç saniye içinde Emin misiniz?'e tıklayın (× mevcut anahtarı korur). Eski anahtar hemen çalışmaz olur; çağıranı hemen güncelleyin.
Bir çağrı nasıl işler
Panel, kopyalayabileceğiniz örnek bir çağrı yazar. Kısaca:
- Çağıran, anahtarı isteğin
Authorizationbaşlığında gönderir. - İstek gövdesi bloğun Girdi şeması'na uymalıdır — her çağrının taşıması gereken verinin tanımı. Her çağrıda kontrol edilir.
- Varsayılan olarak çağrı hemen, çalıştırmanın numarasıyla yanıtlanır. Çağıran bunun yerine çalıştırmayı 30 saniyeye kadar beklemeyi isteyebilir; iş akışında bir Yanıt bloğu varsa onun cevabı geri gönderilir.
- Her çağrı yayımlanmış sürümü, iş akışını yayımlayan kişi olarak ve onun bağlı hesaplarıyla çalıştırır.
:::caution Yayımlamak için girdi şeması gerekir API Tetikleyici içeren bir iş akışı, blokta bir Girdi şeması olmadan açılamaz ve yayımlanamaz. Mesaj bloğun adını verir: "… API tetikleyicisinin girdi şeması gerekiyor: her çağrının gövdesi buna uymalı". :::
Bir çağrıdan gelen değerler <input.*> olarak ulaşır. Kurumunuzun dışından gelirler — özellikle yapay zekâ istemlerinin içinde güvenilmez sayın.
Duraklatma, reddedilen çağrılar ve son çağrılar
| Panelde | Size ne söyler |
|---|---|
| Çağrı kabul ediyor / Duraklatıldı, yanında Duraklat / Sürdür | Adresin şu anda yanıt verip vermediği |
| Reddedilen çağrılarla ilgili kehribar renkli bir uyarı | Güncel anahtar olmadan çağrılar geldi. Çağıranın bu tetikleyicinin güncel anahtarını gönderdiğini kontrol edin |
| Son çağrılar | Bu tetikleyiciyle başlamış son çalıştırmalar, durumları ve saatleriyle. "Bu tetikleyiciden başlayan çalışma henüz yok." onu henüz hiçbir şeyin çağırmadığı anlamına gelir |
| Test olayını dinle | Test adresine yapılan gerçek bir çağrıyı yakalar ve kaydedilmiş taslağınızı sizin adınıza çalıştırır — webhook ile aynı şekilde |
Slack Tetikleyici
Bir Slack Tetikleyici bloğu, Slack uygulamanız abone olduğunuz bir olayı aldığında iş akışınızı başlatır — yeni bir mesaj, bir bahsetme, bir tepki ve daha fazlası.
Kurulum
api.slack.com/appsadresinde bir Slack uygulaması oluşturun ve Signing Secret değerini kopyalayın (Basic Information → App Credentials).- Blokta, bu Signing Secret değerini tutan bir bağlantı seçin (veya ekleyin). Blok ardından otomatik olarak bir İstek adresi gösterir — bir "üret" düğmesi yoktur.
- Slack uygulamanızda Event Subscriptions'ı açın, etkinleştirin ve İstek adresini yapıştırın. Slack bunu anında doğrular.
- Subscribe to bot events altında istediğiniz olayları ekleyin (örneğin
message.channels,app_mention,reaction_added), ardından Save Changes'e tıklayıp uygulamayı yeniden yükleyin.
İstek adresi oluştuğunda blok Tetikleyici hazır yazısını gösterir — Slack'in kontrol edilecek sürekli bir "bağlı" durumu yoktur, bu yüzden onay bu kadarıyla sınırlıdır; bu noktadan sonra eşleşen olaylar iş akışını başlatır.
:::note Bir uygulama, bir iş akışı Her Slack uygulaması tek bir iş akışına bağlanır. Signing Secret değişirse blok, İstek adresini yeniden üretmek için bir Yeniden bağlan düğmesi gösterir. :::
Slack olayları kurumunuzun dışından gelir. <input.message.text> değerini güvenilmez veri gibi ele alın — özellikle yapay zekâ istemlerinde.
WhatsApp Tetikleyici
Bir WhatsApp Tetikleyici bloğu, bağlı WhatsApp Business numaranıza bir mesaj geldiğinde iş akışınızı başlatır.
Kurulum
- Blokta, Meta uygulamanızın App ID değerini girin ve App Secret değerini tutan bir bağlantı seçin.
- İş akışını etkinleştirin. Slack'ten farklı olarak, hiçbir yere adres yapıştırmazsınız — her iki değer ayarlandığında ve iş akışı etkin olduğunda blok kendini Meta'ya otomatik olarak kaydeder.
- Blok bir durum gösterir: Meta kaydı onayladığında Bağlandı, onaylayamadıysa bir hata bildirimi.
App ID veya App Secret değişirse, kaydı yenilemek için bloktan yeniden bağlanın.
WhatsApp mesajları kurumunuzun dışından gelir. Tetikleyici verisini güvenilmez veri gibi ele alın — özellikle yapay zekâ istemlerinde.
E-posta Tetikleyicileri (Gmail, Outlook ve IMAP)
Bir Gmail Tetikleyici, Outlook Tetikleyici veya IMAP Tetikleyici bloğu, bir posta kutusuna yeni e-posta geldiğinde iş akışınızı başlatır.
Gmail ve Outlook
- Bağlantılar altında Google veya Microsoft hesabınızı bağlayın — bu, diğer Google/Microsoft bloklarının kullandığı aynı oturum açma yöntemidir.
- Bu bağlantıyı tetikleyici blokta seçin.
- İsterseniz, tam mesaj metnini almak için E-posta gövdesini dahil et'i açın (varsayılan olarak kapalıdır) ve iş akışını hangi e-postaların tetikleyeceğini daraltmak için Filtre (isteğe bağlı) alanını doldurun.
IMAP
Başka herhangi bir posta sunucusundaki bir posta kutusu için IMAP Tetikleyici'yi kullanın.
| Alan | Ne girilir |
|---|---|
| IMAP sunucusu | Sunucunun adresi, örneğin mail.company.com. İnternetten erişilebilir olmalıdır; iç ağ adresleri reddedilir |
| Port | 993 (TLS) veya 143 (STARTTLS) |
| Klasör | İzlenecek posta kutusu klasörü, örneğin INBOX |
| Posta kutusu hesabı | Kayıtlı bir kullanıcı adı ve parola — iki adımlı girişte uygulama parolası |
| E-posta gövdesini ekle | Varsayılan olarak kapalıdır: iş akışına yalnızca konu, gönderen ve kısa bir önizleme ulaşır |
İş akışını açmadan önce denemek için bloktaki Son e-postayı getir'e tıklayın. Klasördeki en yeni e-postayı okur ve kaydedilmiş taslağınızı onunla deneme olarak çalıştırır; tetikleyicinin posta kutusundaki yeri değişmez. Boş bir klasörde "Klasör boş; deneyecek bir e-posta yok." yanıtını alırsınız.
Üçünün ortak yanları
- Posta kutusu dakikada bir ve yalnızca iş akışı Aktif iken kontrol edilir. Çalışırken blokta "Yeni e-postalar izleniyor — her dakika kontrol edilir." yazar.
- Bağlanan bir hesap tek bir iş akışını yürütür.
- Tekrarlanan hatalardan sonra blok "Bu tetikleyici tekrarlanan hatalardan sonra duraklatıldı" gösterir. Hesabı yeniden bağlayın, sonra Yeniden başlat'a basın.
- Bir posta kutusuna herkes e-posta gönderebilir. Mesajı güvenilmez sayın — özellikle yapay zekâ istemlerinin içinde.
Form, Klasör ve Hata Tetikleyicileri
Üç tetikleyicinin daha kendi sayfası vardır ya da başka bir yerden kurulur:
| Tetikleyici | Kısaca | Devamı |
|---|---|---|
| Form Tetikleyici | Blokta bir form tasarlarsınız; iş akışı, kişilerin formu doldurmak için açtığı bir bağlantı alır. Gönderilen her form, yayımlanmış sürümün bir çalıştırmasını başlatır | Formlar |
| Paylaşımlı Klasör Tetikleyici | Kurumunuzun paylaşımlı klasöründeki bir klasörü izler ve gelen her dosya için bir çalıştırma başlatır | Paylaşımlı Klasör |
| Hata Tetikleyicisi | Başka bir iş akışının otomatik bir çalıştırması başarısız olduğunda başlar. Hangi iş akışlarının ona bildireceğini, her birinin İş akışı ayarları → Hata iş akışı bölümünden seçersiniz | Araç Çubuğu |
Sohbetten Çalıştırma
Sohbet Tetikleyici bloğu olan bir iş akışı doğrudan bir konuşmadan başlatılabilir:
"Haftalık satış raporu iş akışını çalıştır"
Asistan onu asla sessizce çalıştırmaz. Onay gerektiren işlem başlıklı bir onay kartı gösterir; kartta "İş akışlarınızdan biri sizin adınıza çalıştırılacak." notu, seçtiği İş Akışı ve geçirmek istediği Girdiler yer alır. Siz Onayla'ya tıklamadan hiçbir şey olmaz — İptal ise isteği reddeder.
İçeri ne aktarılır
Kendinizi tekrar etmeniz gerekmez. Az önce gönderdiğiniz mesaj iş akışına otomatik olarak verilir; Sohbet Tetikleyici'de Sohbet geçmişini dahil et açıksa yakın konuşma da onunla gider — ancak yalnızca iş akışı sizinse (veya yöneticiyseniz), böylece konuşmanız asla başkasının iş akışına gitmez. Asistanın geçirdiği ek her şey, tıpkı elle çalıştırmada olduğu gibi iş akışının içinde <input.NAME> olarak okunabilir.
Önce neyin doğru olması gerekir
| Gereksinim | Neden |
|---|---|
| İş akışı bir Sohbet Tetikleyici bloğu içerir | Bu, iş akışını kuranın onayıdır — o olmadan iş akışına sohbetten erişilemez. |
| İş akışı Aktif | Sohbet otomatik bir tetikleyicidir. Aktif olmayan bir iş akışı reddedilir ve size onu İş Akışları sayfasından etkinleştirmeniz söylenir. |
| Yöneticiniz asistan için iş akışı çalıştırmayı açmış olmalı | İş akışı çalıştırma, yönetici denetimindeki bir asistan yeteneğidir. |
| O iş akışını çalıştırma izniniz var | Yalnızca başlatmanıza izin verilen iş akışlarını görürsünüz. |
| Kartı onaylarsınız | Son onay her zaman sizindir. |
Asistanın genel olarak nasıl onay istediği için bkz. Araçları Kullanma.
Çalıştırmadan Sonra
Her çalıştırma — elle, zamanlamayla, webhook ile, formla veya sohbetten — kaydedilir. İncelemek için Kayıtlar sekmesini açın:
- İstediğiniz çalıştırmayı bulmak için iş akışına, duruma veya tetikleyiciye göre filtreleyin.
- Her adımın girdisini ve çıktısını görmek ve doğrudan başarısız olan adıma atlamak için bir çalıştırmayı açın.
- İş akışını elle çalıştırma olarak yeniden başlatmak için Yeniden çalıştır'ı kullanın.
Tam anlatım için bkz. Kayıtlar.
Başarısız çalıştırmaların çoğu bozuk bloklardan değil, veri sorunlarından kaynaklanır. <input.email> veya <agent.content> gibi bir referans, orada olmayan bir şeyi göstermiştir. Değerin tam olarak nerede kaybolduğunu görmenin en hızlı yolu, çalıştırma ayrıntısındaki adım adım girdi ve çıktıdır.
İpuçları
- Önce Çalıştır düğmesiyle test edin. Bir zamanlama eklemeden veya adresi dış bir servise vermeden önce temiz bir elle çalıştırma alın.
- Test değerlerini doldurun. Değer'i olmayan bir Başlat bloğu girdisi, test çalıştırmanızın hiçbir şeyle başlaması ve sonraki referansların boş kalması demektir.
- Etkinleştirmeyi unutmayın. Düzenleyiciden kusursuz çalışan bir iş akışı, Aktif olana kadar kendi kendine başlamaz.
- Bloklarınıza net adlar verin. Blok adları çalıştırma ayrıntısında okuduğunuz — ve
<blokAdı.alan>referanslarında yazdığınız — şeydir. - Webhook imzalama anahtarını ve API tetikleyici anahtarını hemen kopyalayın. Her biri bir kez gösterilir. Yenilemek kolaydır ama göndereni de güncellemeniz gerekir.
- Her çalıştırmadan sonra Kayıtlar sekmesine bakın — iş akışının yalnızca bittiğini değil, beklediğinizi yaptığını doğrulayın.
İlgili Sayfalar
- İş Akışı Oluşturma — çalıştıracağınız akışı kurun
- Bloklar — her tetikleyici ve adımın ne yaptığı
- Değişkenler — bir çalıştırma boyunca değerleri saklayın ve yeniden kullanın
- Bağlantılar — bir çalıştırmanın ihtiyaç duyduğu bağlantıları kurun ve onarın
- Formlar — bir iş akışını bir formla başlatın ya da sürdürün
- Onaylar — birinin kararını bekleyen adımlar
- Zamanlamalar — bir iş akışını kendi başına, belirli aralıklarla çalıştırın
- Kayıtlar — her çalıştırmayı adım adım inceleyin