C TWO (Önizleme)

C TWO, otomasyon iş akışlarını düzenleyen, insan robot etkileşimlerini yöneten ve iş öğelerini evrensel kuyruklar aracılığıyla işleyen bir Aracılı Yönetim Platformudur. Bu bağlayıcıyı kullanarak C TWO oturumlarından akışları tetikleyebilir, oturum yaşam döngüsünü yönetebilir, kuyruk öğelerini oluşturup işleyebilir ve dijital çalışanlarla döngüde insan etkileşimlerini etkinleştirebilirsiniz.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Service	Class	Regions
Copilot Studio	Premium	Aşağıdakiler dışında tüm Power Automate bölgeleri: - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD)
Logic Apps	Standart	Aşağıdakiler dışında tüm Logic Apps bölgeleri : - Azure Kamu bölgeleri - Azure Çin bölgeleri - ABD Savunma Bakanlığı (DoD)
Power Apps	Premium	Aşağıdakiler dışında tüm Power Apps bölgeleri: - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD)
Power Automate	Premium	Aşağıdakiler dışında tüm Power Automate bölgeleri: - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD)

Contact
İsim	C İkİ Destek
URL	https://ctwo.com/
E-posta	customersuccess@ctwo.com

Bağlayıcı Meta Verileri
Publisher	C İKI
Web Sitesi	https://ctwo.com/
Gizlilik ilkesi	https://ctwo.com/privacy-policy/
Kategoriler	İş Zekası; AI

C İKI

C TWO, otomasyon iş akışlarını düzenleyen, insan robot etkileşimlerini yöneten ve iş öğelerini evrensel kuyruklar aracılığıyla işleyen bir Aracılı Yönetim Platformudur. Bu bağlayıcı Power Automate, Power Apps, Azure Logic Apps ve Copilot Studio tetiklenip C TWO oturumları tarafından tetiklenebilmesini, oturum yaşam döngüsünü yönetmesini, Evrensel Kuyruk öğelerini oluşturup işlemesini ve dijital çalışanlarla döngü içinde insan etkileşimlerini etkinleştirmesini sağlar.

C TWO, otomasyon varlığınızın üzerinde tek bir düzenleme, idare ve izleme katmanı olarak yer alır: çalışmayı oluşturan veya yürüten her ne olursa olsun, C TWO SLA izleme, yeniden denemeler ve kendi kendini düzeltme, canlı oturum telemetrisi ve tam denetim izi ekler.

Prerequisites

Bağlantı oluşturmadan önce yapmanız gerekenler:

Etkin bir C TWO kiracısı — C TWO Bulutu (barındırılan) veya HTTPS üzerinden erişilebilen bir şirket içi C İKİ sunucusu.
C TWO yöneticiniz tarafından verilen bir Hizmet Hesabı belirteci veya Kişisel Erişim Belirteci (bkz. Kimlik bilgilerini alma).
C TWO şirket içinde barındırılıyorsa sunucuya HTTPS üzerinden Power Platform'dan ulaşılabilir olmalıdır (Microsoft Power Automate giden IP aralıklarına izin veren güvenlik duvarı ( Hizmet Etiketleri AzureConnectors.<region> ve PowerPlatformPlex Power Platform Geo'nuz için Azure).
Özel Bağlayıcı izinlerine sahip bir Power Platform ortamı ve özel bağlayıcıları destekleyen bir lisans katmanı (Premium veya eşdeğeri Power Automate).

Bağlantı oluşturma

Bir bağlantı oluşturduğunuzda, tümü kendi C TWO ortamınızdan olmak üzere üç değer sağlarsınız:

C TWO Konağı — yalnızca C TWO sunucu ana bilgisayar adınız (düzen yok, sondaki eğik çizgi yok) connect24.ctwo.cloudveya gibi ctwo.contoso.com:8443isteğe bağlı bağlantı noktasına sahip bir şirket içi ana bilgisayar.
C İkİ Temel URL — bölümünüzü de içeren C İkİ API'nizin temel yoludur. Eğik çizgiyle başlar ve sonunda eğik çizgi olmaz, örneğin. /DEFAULT/CTWO.Server/api
API Anahtarı — belirteciniz olarak Bearer <your-token>girilir. Hizmet Hesabı belirteci önerilir; Kişisel Erişim Belirteci de çalışır.

Konak ve Temel URL birlikte bağlayıcıyı kendi C TWO sunucunuza ()https://{Host}{Base URL}/… yönlendirir; böylece her müşteri kendi ortamına (C İKİ Bulut veya şirket içi) bağlanır.

Kimlik bilgilerini alma

Kimlik doğrulaması, üst bilgide Authorization Taşıyıcı belirteci olarak gönderilen bir API anahtarı kullanır.

Hizmet Hesabı belirteci (üretim için önerilir)

C TWO örneğinizde oturum açın.
Uygulamalar ve Bağlantılar → Microsoft Power Automate → Hizmet hesabı oluştur'a gidin.
Oluşturulan belirteci hemen kopyalayın; yalnızca bir kez gösterilir.

Kişisel Erişim Belirteci (geliştirme/test)

C TWO'da kullanıcı profilinizi açın.
API Belirteçleri sekmesine gidin ve yeni bir belirteç oluşturun.
Hemen kopyalayın; yalnızca bir kez gösterilir ve kullanıcı hesabı devre dışı bırakılırsa geçersiz kılınmış olur.

Her iki belirteç türünü de gizli dizi olarak değerlendirin; bunları yalnızca Power Platform bağlantı kimlik bilgisinde depolayın, akış değişkenlerinde veya istemci tarafı kodunda depolayın.

Desteklenen işlemler

Tetikleyiciler — C TWO zorunlu zaman aşımıyla veya zaman aşımı olmadan bir oturum gönderirken bir akış başlatın.
Oturum yönetimi — Tamamlanma/hata bildirme, yazılan oturum günlüklerini yazma, oturum zaman aşımını ayarlama ve düzgün bir durdurma isteği olup olmadığını denetleme.
Evrensel Kuyruk — Kuyruk öğelerini oluşturma, listeleme, kilitleme, kilidini açma, yeniden deneme ve erteleme; öğe verilerini güncelleştirme ve öğe düzeyi günlükleri ekleme; etiket ekleme/kaldırma; ekleri alma; özel öğe durumları oluşturma; liste kuyrukları.
Döngüde insan - — Yapılandırılmış insan yardımı formları oluşturun, atayın, atamayı kaldırın ve tamamlayın ve bunları alın/sorgular.

İç yardımcı işlemleri dinamik açılan listeleri (görev ve kullanıcı seçiciler) doldurur ve doğrudan çağrılmaz.

Bilinen sorunlar ve sınırlamalar

Gerekli Ana Bilgisayar ve Temel URL'yi düzeltin. Her ikisi de bağlantı zamanında girilir ve bağlayıcıyı C TWO sunucunuza yönlendirir. Yanlış veya ulaşılamaz değerler bağlantı veya istek hatalarına neden olur.
API Anahtarı biçimi. API Anahtarı alanı değişmez dizeyi Bearer <token> bekler; ön ekin atlanması Bearer ile 401 Unauthorizedsonuçlanmasını bekler.
JSON öğesi verileri sağlama. Öğe veri alanları (Create Queue Item, Set Queue Item Data) JSON nesneleridir. Bir akışta, dize yerine nesne olarak gönderilmesi için ifadeyle json('…') değişmez JSON sağlayın.
Yoklama tetikleyicisi gecikme süresi. Gönderme yerine yoklamayı tetikler, bu nedenle C İKİ'de dağıtılan bir oturum ile akışın başlatılması arasında küçük bir gecikme (tetikleyici yinelenmeyle sınırlanır) vardır.
Form alanı türleri. Form işlemleri tarafından döndürülen bazı tanımlayıcı alanları, formun durumuna bağlı olarak bir tamsayı, dize veya null olabilir.

Yaygın hatalar ve çözümler

Error	Olası neden	Çare
`401 Unauthorized`	API Anahtarında `Bearer` ön ek eksik, süresi dolmuş veya iptal edilmiş	Kimlik bilgilerini olarak `Bearer <token>`yeniden girin; iptal edilirse yeni bir Hizmet Hesabı belirteci oluşturun
`400 Bad request` Kuyruk Öğesi Oluştur'da	Gerekli bir alan eksik (`reference`, `queueItemState`, `itemKey`)	Gerekli üç alanı da doldurun
Tetikleyici hiçbir zaman tetiklemez	Yanlış görev seçildi veya C TWO görevi Power Automate	Görevin Görev Kimliği açılan listesinde göründüğünü ve C TWO'da kullanıma sunulan akış olarak yapılandırıldığını onaylayın
Kaçış dizesi olarak depolanan öğe verileri	Nesne yerine metin olarak sağlanan JSON	Nesne olarak gönderilmesi için ifadeyi `json('…')` (akışlar) veya Ham Gövdeyi (bağlayıcı testi) kullanın

FAQ

Bu bağlayıcıyı yalnızca Power Automate değil Power Apps, Azure Logic Apps ve Copilot Studio kullanabilir miyim? Yes. Tetikleyiciler Power Automate özgüdür, ancak bir bağlantı oluşturulduktan sonra bu platformların herhangi birinden her eylem çağrılabilir.

Bu bağlayıcı lisanslamayı yönetiyor mu? No. C TWO yürütmeyi düzenler ve yönetir; müşteriler kendi Microsoft lisanslamalarından sorumludur.

Nereden yardım alabilirim? adresindeN C two Customer Success customersuccess@ctwo.comile iletişime geçin.

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:


Varsayılan	Bağlantı oluşturmak için parametreler.	Tüm bölgeler	Paylaşılamaz

Temerrüt

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim	Türü	Description	Zorunlu
C TWO Konağı	string	C TWO sunucu ana bilgisayar adınız yalnızca â€" düzen yok, sondaki eğik çizgi yok. Örneğin connect24.ctwo.cloud veya ctwo.contoso.com:8443 gibi isteğe bağlı bağlantı noktasına sahip bir şirket içi konak.	True
C İki Temel URL	string	Bölme dahil olmak üzere C TWO API'nizin temel yolu. Eğik çizgiyle başlayın, sondaki eğik çizgi yok. Örneğin /DEFAULT/CTWO. Sunucu/api.	True
API Anahtarı	securestring	C TWO API belirteciniz olarak girildi: <Belirtecinizi> taşıyıcı yapın. Hizmet Hesabı belirteci önerilir; Kişisel Erişim Belirteci de çalışır.	True

Eylemler

Akış Yürütme Durumunu Başarısız Olarak Ayarla	C TWO oturumlarını başarısız olarak işaretleyerek akış yürütme sırasında bir hata oluştuğuna işaret eder. Hata işleme kapsamlarında bu eylemi kullanarak hataları C TWO'ya ve neyin yanlış gittiğiyle ilgili ayrıntıları bildirin.
Akış Yürütme Durumunu Tamamlandı olarak ayarlama	C TWO oturumunu tamamlandı olarak işaretler ve akışın çalışmasını başarıyla tamamlandığını gösterir. Bu eylemi akışınızın sonuna yerleştirerek C TWO'ya otomasyonun hatasız tamamlandığını bildirin.
Form Al	İsteğe bağlı filtreleme ile robot etkileşim formlarının listesini alır. Bekleyen döngüdeki insan isteklerini sorgulamak, durumlarını denetlemek veya belirli kullanıcılara atanmış formları bulmak için bu eylemi kullanın.
Form Ata	Belirli bir kullanıcıya robot etkileşim formu atar ve bu formu döngüdeki insan isteğini gözden geçirmek ve tamamlamaktan sorumlu hale getirir.
Form Oluştur	Dijital çalışanın insan yardımı istemesini sağlayan yeni bir robot etkileşim formu oluşturur. Form, C TWO platformunda atanan kullanıcılara sunulur ve özel durumları veya karmaşık kararları işlemek için insan uzmanlığının gerekli olduğu döngüde insan senaryolarına olanak tanır.
Formun Atamasını Kaldır	Geçerli kullanıcı atamasını robot etkileşim formundan kaldırarak diğer kullanıcıların talep etmelerini sağlar.
Kimliğine Göre Form Al	Belirli bir robot etkileşim formunu benzersiz tanımlayıcısıyla alır. Dijital çalışan tarafından oluşturulan döngüdeki insan formunun ayrıntılarını, alanlarını ve geçerli durumunu getirmek için bu eylemi kullanın.
Kuyruk Öğelerini Alma	Durum, etiketler, tarihler ve kuyruk adları gibi belirtilen filtre ölçütlerine göre kuyruk öğelerini alır. Evrensel kuyruklarınızda iş öğelerini aramak ve izlemek için bu eylemi kullanın.
Kuyruk Öğesi Durumu Oluştur	Belirli bir kuyruk içinde yeni bir özel durum oluşturur. Özel durumlar, kuyruğu iş sürecinize göre uyarlayarak varsayılan durumların (Beklemede, Tamamlandı, Başvurulan) ötesinde iş akışı aşamaları tanımlamanızı sağlar.
Kuyruk Öğesi Durumunu Ayarla	Bir kuyruk öğesinin durumunu değiştirir (örneğin, Beklemede'den Tamamlandı'ya veya özel bir duruma). İş akışı işlem hattınızda öğeleri ilerletmek için bu eylemi kullanın.
Kuyruk Öğesi Eki Alma	Bir kuyruk öğesinden base64 ile kodlanmış veriler olarak belirli bir dosya eki alır. Oluşturma veya işleme sırasında iş öğelerine eklenmiş dosyaları indirmek için bu eylemi kullanın.
Kuyruk Öğesi Oluştur	Belirtilen evrensel kuyrukta yeni bir iş öğesi oluşturur. Veri yükleri, etiketler ve isteğe bağlı dosya ekleri dahil olmak üzere dijital çalışanlar tarafından işlenmek üzere öğeler eklemek için bu eylemi kullanın.
Kuyruk Öğesi Verilerini Ayarla	Bir kuyruk öğesinin veri içeriğini güncelleştirir. İşleme sırasında iş öğesinin yükünü değiştirmek için (örneğin ara sonuçları depolamak için) bu eylemi kullanın.
Kuyruk Öğesinden Etiketleri Kaldır	Bir kuyruk öğesinden bir veya daha fazla etiketi kaldırır. İşleme sırasında iş öğelerinin kategorisini güncelleştirmek için bu eylemi kullanın.
Kuyruk Öğesine Etiket Ekleme	Kategorilere ayırma ve filtreleme için kuyruk öğesine bir veya daha fazla etiket ekler. Etiketler, kuyruklar arasında iş öğelerini düzenlemeye ve aramaya yardımcı olur.
Kuyruk Öğesini Ertele	Belirtilen tarih/saate kadar işlenmemesi için bir kuyruk öğesini geçersiz hale getirir. Bir öğe şu anda işlenemediğinde ancak daha sonra yeniden denenmesi gerektiğinde bu eylemi kullanın.
Kuyruk Öğesini Kilitle	Diğer çalışanların aynı anda işlemesini önlemek için bir kuyruk öğesini kilitler. Özel erişim sağlamak için iş öğesini işlemeden önce bu eylemi kullanın.
Kuyruk Öğesini Yeniden Dene	Belirli bir kuyruk öğesini yeniden deneyin, verilerini özgün değerine geri ayarlayın ve yeni bir Deneme oluşturma.
Kuyruk Öğesinin Kilidini Aç	Daha önce kilitlenmiş bir kuyruk öğesinin kilidini açar ve kullanılabilir durumuna döndürür. İşleme kesintiye uğradığında ve öğe diğer çalışanlar için serbest bırakıldığında bu eylemi kullanın.
Kuyrukları Alma	Filtre ölçütlerine göre evrensel kuyrukları alır. Kullanılabilir kuyrukları listelemek, yapılandırmalarını denetlemek veya kuyruk ayrıntılarını aramak için bu eylemi kullanın. Bu işlem, diğer eylemlerde dinamik açılan menüleri de destekler.
Kuyruğa Günlük Ekle	Denetim izi ve izlenebilirlik için bir kuyruk öğesine günlük iletisi ekler. Belirli bir iş öğesine yönelik işleme adımlarını, uyarılarını veya hatalarını kaydetmek için bu eylemi kullanın.
Oturum Durdurulmalıdır	C TWO'nın verilen oturum için düzgün (geçici) bir durdurma isteyip istemediğinizi denetler. Oturumun erken sonlandırılıp sonlandırılamaması gerektiğini düzenli aralıklarla denetlemek ve akışın durdurmadan önce kaynakları temizlemesine izin vermek için döngülerin içinde bu eylemi kullanın.
Oturum Zaman Aşımını Ayarla	Etkin bir C TWO oturumu için zaman aşımı değerini güncelleştirir. Özgün zaman aşımının ayarlanması gerektiğinde çalışan bir oturumun izin verilen yürütme süresini uzatmak veya azaltmak için bu eylemi kullanın.
Oturuma Günlük Ekle	C TWO oturumuna günlük girdisi yazar. Akış yürütme sırasında ilerleme durumunu izlemek, kararları kaydetmek veya tanılama bilgilerini günlüğe kaydetmek için bu eylemi kullanın. Günlükler C TWO platformunda denetim ve sorun giderme için görünür.
Tam Form	Bir robot etkileşim formunu tamamlandı olarak işaretler ve insan kullanıcının istenen girişi sağladığını ve dijital çalışanın işlemeye devam ettiğini gösterir.

Akış Yürütme Durumunu Başarısız Olarak Ayarla

İşlem Kimliği:: SetSessionFailed

C TWO oturumlarını başarısız olarak işaretleyerek akış yürütme sırasında bir hata oluştuğuna işaret eder. Hata işleme kapsamlarında bu eylemi kullanarak hataları C TWO'ya ve neyin yanlış gittiğiyle ilgili ayrıntıları bildirin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Oturum Kimliği	sessionId	True	string	Başarısız olarak işaretlemek için C TWO oturum kimliği. Tetikleyici çıkışından oturum kimliğini varsayılan olarak kullanır.
details	details	True	string	Oturumun başarısız olmasına neden olan hatanın veya özel durumun açıklaması.

Akış Yürütme Durumunu Tamamlandı olarak ayarlama

İşlem Kimliği:: SetSessionCompleted

C TWO oturumunu tamamlandı olarak işaretler ve akışın çalışmasını başarıyla tamamlandığını gösterir. Bu eylemi akışınızın sonuna yerleştirerek C TWO'ya otomasyonun hatasız tamamlandığını bildirin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Oturum Kimliği	sessionId	True	string	Başarıyla tamamlandı olarak işaretlemek için C two oturum kimliği. Tetikleyici çıkışından oturum kimliğini varsayılan olarak kullanır.

Döndürülenler

response: object

Form Al

İşlem Kimliği:: GetForms

İsteğe bağlı filtreleme ile robot etkileşim formlarının listesini alır. Bekleyen döngüdeki insan isteklerini sorgulamak, durumlarını denetlemek veya belirli kullanıcılara atanmış formları bulmak için bu eylemi kullanın.

Parametreler

Name	Anahtar	Tür	Description
Atlamak	skip	integer	Sayfalandırma için atlanması gereken kayıt sayısı.
Almak	take	integer	Döndürülecek kayıt sayısı.
Son Tarih:	deadlineBefore	date-time	Bu tarih/saatten önceki bir son tarihe sahip formları filtreleyin (ISO 8601).
Son Tarih	deadlineAfter	date-time	Bu tarih/saatten sonra son tarihe sahip formları filtreleyin (ISO 8601).
Tamamlananı Ekle	includeCompleted	boolean	Tamamlanan formların sonuçlara eklenip eklenmeyeceği.
Kullanıcı Kimliği tarafından talep edilen	claimedByUserId	integer	Belirli bir kullanıcı kimliği tarafından talep edilen formları filtreleyin.
İş Akışı Görev Kimliği tarafından oluşturuldu	createdByWorkflowTaskId	integer	Belirli bir iş akışı görev kimliği tarafından oluşturulan formları filtreleyin.

Döndürülenler

Name	Yol	Tür	Description
		array of object
kimlik	id	integer	kimlik
divisionId	divisionId		divisionId
oturumKimliği	sessionId		oturumKimliği
queueItemId	queueItemId		queueItemId
claimedByUserId	claimedByUserId		claimedByUserId
claimedOn	claimedOn	string	claimedOn
createdByWorkflowTaskId	createdByWorkflowTaskId		createdByWorkflowTaskId
createdByUserId	createdByUserId		createdByUserId
createdOn (Açık)	createdOn	string	createdOn (Açık)
Son	deadline	string	Son
Tamamlandı	completed	string	Tamamlandı
ertelenmemiş	undeferred	boolean	ertelenmemiş

Form Ata

İşlem Kimliği:: AssignForm

Belirli bir kullanıcıya robot etkileşim formu atar ve bu formu döngüdeki insan isteğini gözden geçirmek ve tamamlamaktan sorumlu hale getirir.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Form Kimliği	formId	True	string	Atanacak döngü formu kimliğindeki insan.
userId	userId		integer	Formun atanacağı kullanıcının kimliği.

Form Oluştur

İşlem Kimliği:: CreateForm

Dijital çalışanın insan yardımı istemesini sağlayan yeni bir robot etkileşim formu oluşturur. Form, C TWO platformunda atanan kullanıcılara sunulur ve özel durumları veya karmaşık kararları işlemek için insan uzmanlığının gerekli olduğu döngüde insan senaryolarına olanak tanır.

Parametreler

Name	Anahtar	Tür	Description
Alanları	fields	string	İnsan kullanıcının doldurması gereken form alanlarını tanımlayan JSON biçimli dize.
başlık	title	string	İnsan kullanıcıya formu açtığında görüntülenen başlık.
Son	deadline	date-time	İnsanoğlunun forma yanıt vermesi gereken son tarih (ISO 8601 biçimi).
ıntro	intro	string	İnsan kullanıcıya hangi eylemin gerekli olduğunu açıklayan giriş metni.
itemId	itemId	integer	Bu formla ilişkilendirilmiş, insan etkileşimini belirli bir iş öğesine bağlayan kuyruk öğesi kimliği.
workflowTaskId	workflowTaskId	integer	Bu formu oluşturan C İKİ görevi.

Döndürülenler

Name	Yol	Tür	Description
kimlik	id	integer	kimlik

Formun Atamasını Kaldır

İşlem Kimliği:: UnassignForm

Geçerli kullanıcı atamasını robot etkileşim formundan kaldırarak diğer kullanıcıların talep etmelerini sağlar.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Form Kimliği	formId	True	string	Atamayı kaldırmaya yönelik döngü formu kimliğindeki insan.

Kimliğine Göre Form Al

İşlem Kimliği:: GetFormById

Belirli bir robot etkileşim formunu benzersiz tanımlayıcısıyla alır. Dijital çalışan tarafından oluşturulan döngüdeki insan formunun ayrıntılarını, alanlarını ve geçerli durumunu getirmek için bu eylemi kullanın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Form Kimliği	formId	True	string	Ayrıntıları almak için döngü formu kimliğindeki insan.

Döndürülenler

Name	Yol	Tür	Description
kimlik	id	integer	kimlik
divisionId	divisionId		divisionId
oturumKimliği	sessionId		oturumKimliği
queueItemId	queueItemId		queueItemId
claimedByUserId	claimedByUserId		claimedByUserId
claimedOn	claimedOn	string	claimedOn
createdByWorkflowTaskId	createdByWorkflowTaskId		createdByWorkflowTaskId
createdByUserId	createdByUserId		createdByUserId
createdOn (Açık)	createdOn	string	createdOn (Açık)
Son	deadline	string	Son
Tamamlandı	completed	string	Tamamlandı
başlık	title	string	başlık
ıntro	intro	string	ıntro
Alanları	fields	string	Alanları

Kuyruk Öğelerini Alma

İşlem Kimliği:: GetItems

Durum, etiketler, tarihler ve kuyruk adları gibi belirtilen filtre ölçütlerine göre kuyruk öğelerini alır. Evrensel kuyruklarınızda iş öğelerini aramak ve izlemek için bu eylemi kullanın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Öğe Anahtarı	itemKey		string	Öğe anahtarına göre filtreleyin.
Attempts	attempts		integer	Deneme sayısına göre filtreleyin.
Önceki Ertelenmiş	deferredBefore		date-time	Bu tarihten önce ertelenen öğeleri filtreleyin.
Ertelendikten Sonra	deferredAfter		date-time	Bu tarihten sonra ertelenen öğeleri filtreleyin.
Daha Önce Oluşturuldu	createdBefore		date-time	Bu tarihten önce oluşturulan öğeleri filtreleyin.
Oluşturulduktan Sonra	createdAfter		date-time	Bu tarihten sonra oluşturulan öğeleri filtreleyin.
Daha Önce Sonlandırıldı	concludedBefore		date-time	Bu tarihten önce sonuçlanan öğeleri filtreleyin.
Sona Erdikten Sonra	concludedAfter		date-time	Bu tarihten sonra sonuçlanan öğeleri filtreleyin.
Önce Girilen Durum	stateEnteredTimeBefore		date-time	Bu saatten önce durum olarak girilen öğeleri filtreleyin.
Sonra Girilen Durum	stateEnteredTimeAfter		date-time	Bu süreden sonra duruma giren öğeleri filtreleyin.
States	states		string	Kuyruk öğesi durumuna göre filtreleyin.
Kuyruk Öğesi Durum Kimlikleri	queueItemStateIds		integer	Kuyruk öğesi durum kimliklerine göre filtreleyin.
Kuyruk Öğesi Durum Adları	queueItemStateNames		string	Kuyruk öğesi durum adlara göre filtreleyin.
Tags	tags		string	Etiketlere göre filtreleyin (virgülle ayrılmış).
Kuyruk Kimlikleri	queueIds		integer	Kuyruk kimliklerine göre filtreleyin.
Kuyruk Adları	queueNames	True	string	Kuyruk adlara göre filtreleyin (gerekli).
References	references		string	Kuyruk başvurularına göre filtreleyin.
Öğe Verilerini Ekle	includeItemData		boolean	Yanıta öğe verilerinin dahil edilip edilmeyeceği.
Atlamak	skip		integer	Sayfalandırma için atlanması gereken kayıt sayısı.
Almak	take		integer	Döndürülecek kayıt sayısı.

Döndürülenler

Name	Yol	Tür	Description
		array of object
kimlik	id	integer	Kuyruk öğesinin benzersiz tanımlayıcısı.
itemKey	itemKey	string	Kuyruk öğesinin benzersiz anahtarı.
Çalışır	attempts	integer	İşlem denemelerinin sayısı.
queueId	queueId	integer	Üst kuyruğun tanımlayıcısı.
kimlik	state.id	integer	Durum tanımlayıcısı.
isim	state.name	string	Durumun adı.
state	state.state	string	Durum değeri.
tags	tags	array of string	Kuyruk öğesiyle ilişkilendirilmiş etiketler.
created	created	string	Yaratım zaman damgası.
createdByVendorSessionId	createdByVendorSessionId	integer	Bu öğeyi oluşturan oturum kimliği.
sonuca varıldı	concluded	string	Sonuç zaman damgası.
Ertelen -miş	deferred	string	Ertelenen zaman damgası.
test	test	boolean	Bunun bir test öğesi olup olmadığı.
Kilitli	locked	boolean	Öğenin kilitli olup olmadığı.

Kuyruk Öğesi Durumu Oluştur

İşlem Kimliği:: CreateItemState

Belirli bir kuyruk içinde yeni bir özel durum oluşturur. Özel durumlar, kuyruğu iş sürecinize göre uyarlayarak varsayılan durumların (Beklemede, Tamamlandı, Başvurulan) ötesinde iş akışı aşamaları tanımlamanızı sağlar.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
İsim	name		string	Yeni durumun adı.
Yanıt Süresi Hesaplaması	responseTimeCalculationBasis	True	string	Bu duruma giren öğeler için yanıt süresi SLA'larının nasıl hesapleneceğini belirler.
Durum Türü	state	True	string	Durum türü (Beklemede, Tamamlandı veya Başvuruldu).
Kuyruk Kimliği	queueId	True	integer	Bu durumun oluşturulacağı kuyruğun kimliği.
Description	description		string	Bu durumun iş akışınızda neyi temsil ettiğiyle ilgili bir açıklama.
Öğe Başına Kaydedilen Süre	timeSavedPerItem		integer	RoI raporlaması için kullanılan bu durumdaki öğe başına kaydedilen süre (saniye).
Öğe Başına Oluşturulan Değer	valueGeneratedPerItem		integer	RoI raporlaması için kullanılan, bu durumdaki öğe başına oluşturulan değer.
Raporlara Ekle	includeInReports		boolean	Bu durumun analiz ve raporlara dahil edilip edilmeyeceği.

Kuyruk Öğesi Durumunu Ayarla

İşlem Kimliği:: SetItemState

Bir kuyruk öğesinin durumunu değiştirir (örneğin, Beklemede'den Tamamlandı'ya veya özel bir duruma). İş akışı işlem hattınızda öğeleri ilerletmek için bu eylemi kullanın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kuyruk Öğesi Kimliği	queueItemId	True	string	Güncelleştirilecek kuyruk öğesinin kimliği.
State	state		string	Kuyruk öğesinin yeni durumu.

Kuyruk Öğesi Eki Alma

İşlem Kimliği:: GetItemAttachment

Bir kuyruk öğesinden base64 ile kodlanmış veriler olarak belirli bir dosya eki alır. Oluşturma veya işleme sırasında iş öğelerine eklenmiş dosyaları indirmek için bu eylemi kullanın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kuyruk Öğesi Kimliği	queueItemId	True	string	Eki içeren kuyruk öğesinin kimliği.
Ek Kimliği	attachmentId	True	string	Alınacak ekin kimliği.
Filename	filename		string	Ekin dosya adı.

Döndürülenler

response: string

Kuyruk Öğesi Oluştur

İşlem Kimliği:: CreateItem

Belirtilen evrensel kuyrukta yeni bir iş öğesi oluşturur. Veri yükleri, etiketler ve isteğe bağlı dosya ekleri dahil olmak üzere dijital çalışanlar tarafından işlenmek üzere öğeler eklemek için bu eylemi kullanın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Öğe Anahtarı	itemKey	True	string	Bu kuyruk öğesini tanımlamak için benzersiz bir iş anahtarı (örneğin, fatura numarası, servis talebi kimliği).
Kuyruk Öğesi Durumu	queueItemState	True	string	Kuyruk öğesinin ilk durumu (örn. Beklemede).
Kuyruk Başvurusu	reference	True	string	Öğenin oluşturulacağı kuyruk başvurusu.
Ertelenene Kadar	deferredUntil		date-time	İşlemeyi bu tarih/saate kadar ertele (ISO 8601 biçimi).
Öğe Verileri	itemData		object	JSON biçimindeki kuyruk öğesinin veri yükü.
Tags	tags		string	Kuyruk öğesi için etiketler (virgülle ayrılmış).
fileName	fileName		string	Ek dosyasının adı.
fileData	fileData		string	base64 kodlanmış dosya verileri.
Oturum Kimliği	sessionId		string	Bu öğeyle ilişkili oturum kimliği.
Cihaz	device		string	Bu öğeyi oluşturan cihaz.
User	user		string	Bu öğeyi oluşturan kullanıcı.
Otomasyon Sağlayıcısı	automationProvider		string	Bu öğenin otomasyon sağlayıcısı.

Döndürülenler

Name	Yol	Tür	Description
kimlik	id	integer	kimlik
itemKey	itemKey	string	itemKey
Çalışır	attempts	integer	Çalışır
queueId	queueId	integer	queueId
kimlik	state.id	integer	kimlik
isim	state.name	string	isim
state	state.state	string	state
tags	tags	array of string	tags
created	created	string	created
createdByVendorSessionId	createdByVendorSessionId	integer	createdByVendorSessionId
sonuca varıldı	concluded	string	sonuca varıldı
Ertelen -miş	deferred	string	Ertelen -miş
test	test	boolean	test
Kilitli	locked	boolean	Kilitli

Kuyruk Öğesi Verilerini Ayarla

İşlem Kimliği:: SetItemData

Bir kuyruk öğesinin veri içeriğini güncelleştirir. İşleme sırasında iş öğesinin yükünü değiştirmek için (örneğin ara sonuçları depolamak için) bu eylemi kullanın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kuyruk Öğesi Kimliği	queueItemId	True	string	Güncelleştirilecek kuyruk öğesinin kimliği.
Veri	data		object	Kuyruk öğesi için JSON nesnesi olarak yeni veri yükü.
Oluşturuldu	created		date-time	Bu veriler için oluşturma zaman damgası.

Kuyruk Öğesinden Etiketleri Kaldır

İşlem Kimliği:: RemoveItemTag

Bir kuyruk öğesinden bir veya daha fazla etiketi kaldırır. İşleme sırasında iş öğelerinin kategorisini güncelleştirmek için bu eylemi kullanın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kuyruk Öğesi Kimliği	queueItemId	True	string	Etiketlerin kaldırılacağı kuyruk öğesinin kimliği.
Tags	tags		string	Kaldırılacak etiketlerin virgülle ayrılmış listesi.

Kuyruk Öğesine Etiket Ekleme

İşlem Kimliği:: AddItemTag

Kategorilere ayırma ve filtreleme için kuyruk öğesine bir veya daha fazla etiket ekler. Etiketler, kuyruklar arasında iş öğelerini düzenlemeye ve aramaya yardımcı olur.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kuyruk Öğesi Kimliği	queueItemId	True	string	Etiket eklenecek kuyruk öğesinin kimliği.
Tags	tags		string	Eklenecek etiketlerin virgülle ayrılmış listesi.

Kuyruk Öğesini Ertele

İşlem Kimliği:: DeferItem

Belirtilen tarih/saate kadar işlenmemesi için bir kuyruk öğesini geçersiz hale getirir. Bir öğe şu anda işlenemediğinde ancak daha sonra yeniden denenmesi gerektiğinde bu eylemi kullanın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kuyruk Öğesi Kimliği	queueItemId	True	string	Ertelenecek kuyruk öğesinin kimliği.
Ertelenene Kadar	deferredUntil		date-time	Ertelenecek tarih/saat (ISO 8601 biçimi).

Döndürülenler

response: string

Kuyruk Öğesini Kilitle

İşlem Kimliği:: LockItem

Diğer çalışanların aynı anda işlemesini önlemek için bir kuyruk öğesini kilitler. Özel erişim sağlamak için iş öğesini işlemeden önce bu eylemi kullanın.

Parametreler

Name	Anahtar	Tür	Description
Kuyruk Öğesi Kimliği	queueItemId	string	Kilitlenmek üzere kuyruk öğesinin kimliği. Atlanırsa, filtreyle eşleşen bir sonraki kullanılabilir öğe kilitlenir.
Kuyruk Adı	reference	string	Bir öğeyi kilitlemek için kuyruk başvurusu.
Durum Kimliği	stateId	string	Öğeleri filtrelemek için durum kimliği.
Durum Adı	stateName	string	Öğeleri filtrelemek için gereken durum adı.
Oturum Kimliği	sessionId	string	Bu kilidin oturum kimliği.

Döndürülenler

Name	Yol	Tür	Description
kimlik	id	integer	Kilitli öğenin benzersiz tanımlayıcısı.
itemKey	itemKey	string	Kilitli öğenin benzersiz anahtarı.
Çalışır	attempts	integer	İşlem denemelerinin sayısı.
queueId	queueId	integer	Üst kuyruğun tanımlayıcısı.
kimlik	state.id	integer	Durum tanımlayıcısı.
isim	state.name	string	Durumun adı.
state	state.state	string	Durum değeri.
tags	tags	array of string	Kuyruk öğesiyle ilişkilendirilmiş etiketler.
created	created	string	Yaratım zaman damgası.
createdByVendorSessionId	createdByVendorSessionId	integer	Bu öğeyi oluşturan oturum kimliği.
sonuca varıldı	concluded	string	Sonuç zaman damgası.
Ertelen -miş	deferred	string	Ertelenen zaman damgası.
test	test	boolean	Bunun bir test öğesi olup olmadığı.
Kilitli	locked	boolean	Öğenin kilitli olup olmadığı.

Kuyruk Öğesini Yeniden Dene

İşlem Kimliği:: RetryItem

Belirli bir kuyruk öğesini yeniden deneyin, verilerini özgün değerine geri ayarlayın ve yeni bir Deneme oluşturma.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kuyruk Öğesi Kimliği	queueItemId	True	integer	Yeniden denenecek belirli kuyruk öğesi kimliği.
Durum Kimliği	stateId		integer	Ayarlanacak belirli bekleyen kuyruk öğesi durum kimliği; durum parametresine göre öncelik alır.
State	state		string	Ayarlanacak belirli bekleyen kuyruk öğesi durum adı.
İş Akışı Görev Kimliği	workflowTaskId		integer	WorkflowTask tanımlayıcısı.
App ID	appId		integer	Uygulama tanımlayıcısı.

Kuyruk Öğesinin Kilidini Aç

İşlem Kimliği:: UnlockItem

Daha önce kilitlenmiş bir kuyruk öğesinin kilidini açar ve kullanılabilir durumuna döndürür. İşleme kesintiye uğradığında ve öğe diğer çalışanlar için serbest bırakıldığında bu eylemi kullanın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kuyruk Öğesi Kimliği	queueItemId	True	string	Kilidini açmak için kuyruk öğesinin kimliği.

Kuyrukları Alma

İşlem Kimliği:: GetQueues

Filtre ölçütlerine göre evrensel kuyrukları alır. Kullanılabilir kuyrukları listelemek, yapılandırmalarını denetlemek veya kuyruk ayrıntılarını aramak için bu eylemi kullanın. Bu işlem, diğer eylemlerde dinamik açılan menüleri de destekler.

Parametreler

Name	Anahtar	Tür	Description
Kuyruk Kimliği	id	string	Kuyruk kimliğine göre filtreleyin.
Kuyruk Başvurusu	reference	string	Kuyruk başvurusuna göre filtreleyin.
Kuyruk Adı	name	string	Kuyruk adına göre filtreleyin.
Durum Adı	stateName	string	Durum adına göre filtreleyin.
Deleted	deleted	boolean	Silinen duruma göre filtreleyin.
Atlamak	skip	integer	Sayfalandırma için atlanması gereken kayıt sayısı.
Almak	take	integer	Döndürülecek kayıt sayısı.

Döndürülenler

Name	Yol	Tür	Description
		array of object
kimlik	id	integer	Kuyruğun benzersiz tanımlayıcısı.
silindi	deleted	boolean	Kuyruğun silinip silinmediği.
isim	name	string	Kuyruğun adı.
description	description	string	Kuyruğun açıklaması.
Görünür	visible	boolean	Kuyruğun görünür olup olmadığı.
includeInReports	includeInReports	boolean	Raporlara dahil edilip edilmeyeceği.
created	created	string	Yaratım zaman damgası.
Güncel -leştirilmiş	updated	string	Son güncelleştirme zaman damgası.
deletedTime	deletedTime	string	Silme zaman damgası.
divisionId	divisionId	integer	Bölme tanımlayıcısı.
type	type	integer	Kuyruk türü.
referans	reference	string	Kuyruk başvurusu.
Devletleri	states	array of object	Bu kuyrukta kullanılabilen durumlar.
kimlik	states.id	integer	Durum tanımlayıcısı.
isim	states.name	string	Durum adı.
description	states.description	string	Durum açıklaması.
tagfilter	states.tagfilter	string	Bu durum için etiket filtresi.
state	states.state	integer	Durum türü.
timeSavedPerItem	states.timeSavedPerItem	integer	Öğe başına kaydedilen süre.
includeInReports	states.includeInReports	boolean	Raporlara dahil edilip edilmeyeceği.
responseTimeCalculationBasis	states.responseTimeCalculationBasis	integer	Yanıt süresi hesaplama temeli.

Kuyruğa Günlük Ekle

İşlem Kimliği:: AddItemLog

Denetim izi ve izlenebilirlik için bir kuyruk öğesine günlük iletisi ekler. Belirli bir iş öğesine yönelik işleme adımlarını, uyarılarını veya hatalarını kaydetmek için bu eylemi kullanın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kuyruk Öğesi Kimliği	queueItemId	True	string	Oturum açmak için kuyruk öğesinin kimliği.
Günlük Düzeyi	level		string	Günlük girdisinin önem düzeyi.
Message	message		string	Günlük iletisi içeriği.

Oturum Durdurulmalıdır

İşlem Kimliği:: IsStopRequested

C TWO'nın verilen oturum için düzgün (geçici) bir durdurma isteyip istemediğinizi denetler. Oturumun erken sonlandırılıp sonlandırılamaması gerektiğini düzenli aralıklarla denetlemek ve akışın durdurmadan önce kaynakları temizlemesine izin vermek için döngülerin içinde bu eylemi kullanın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Oturum Kimliği	sessionId	True	string	Durdurma isteğini denetlemek için C TWO oturum kimliği. Tetikleyici çıkışından oturum kimliğini varsayılan olarak kullanır.

Döndürülenler

Name	Yol	Tür	Description
isStopRequested	isStopRequested	boolean	isStopRequested

Oturum Zaman Aşımını Ayarla

İşlem Kimliği:: SetTimeout

Etkin bir C TWO oturumu için zaman aşımı değerini güncelleştirir. Özgün zaman aşımının ayarlanması gerektiğinde çalışan bir oturumun izin verilen yürütme süresini uzatmak veya azaltmak için bu eylemi kullanın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Oturum Kimliği	sessionId	True	string	Zaman aşımını güncelleştirmek için C TWO oturum kimliği. Tetikleyici çıkışından oturum kimliğini varsayılan olarak kullanır.
Timeout	timeout	True	integer	Oturuma uygulanacak saniye olarak yeni zaman aşımı değeri.

Döndürülenler

response: string

Oturuma Günlük Ekle

İşlem Kimliği:: AddLogToSession

C TWO oturumuna günlük girdisi yazar. Akış yürütme sırasında ilerleme durumunu izlemek, kararları kaydetmek veya tanılama bilgilerini günlüğe kaydetmek için bu eylemi kullanın. Günlükler C TWO platformunda denetim ve sorun giderme için görünür.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Oturum Kimliği	sessionId	True	string	Günlük girişinin kaydedileceği C TWO oturum kimliği. Tetikleyici çıkışından oturum kimliğini varsayılan olarak kullanır.
Düzey	level	True	string	Günlük girdisinin önem düzeyi.
message	message	True	string	Kaydedilecek günlük iletisi içeriği.

Tam Form

İşlem Kimliği:: CompleteForm

Bir robot etkileşim formunu tamamlandı olarak işaretler ve insan kullanıcının istenen girişi sağladığını ve dijital çalışanın işlemeye devam ettiğini gösterir.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Form Kimliği	formId	True	string	Tamamlandı olarak işaretlemek için döngü formu kimliğindeki insan.
completedAt	completedAt		date-time	Formun ne zaman tamamlandığı zaman damgası (ISO 8601 biçimi).

Tetikleyiciler

Zaman Aşımı ile Oturum İsteğinden Akış Başlatma	Yeni C TWO oturumlarını yoklar ve zaman aşımı kısıtlaması ile akışı tetikler. Otomasyonun belirli bir zaman penceresi içinde tamamlanması gerektiğinde bu tetikleyiciyi kullanın. Oturum zaman aşımını aşarsa, C TWO bunu zaman aşımı ilkesine göre işler.
Zaman Aşımı Olmadan Oturum İsteğinden Akış Başlatma	Yeni C TWO oturumlarını yoklar ve seçili görev için bir oturum oluşturulduğunda akışı tetikler. Otomasyon zaman aşımı kısıtlaması gerektirmediğinde bu tetikleyiciyi kullanın. Akış, C TWO'dan geçirilen giriş değerleri de dahil olmak üzere oturum ayrıntılarını alır.

Zaman Aşımı ile Oturum İsteğinden Akış Başlatma

İşlem Kimliği:: StartFlowWithTimeout

Yeni C TWO oturumlarını yoklar ve zaman aşımı kısıtlaması ile akışı tetikler. Otomasyonun belirli bir zaman penceresi içinde tamamlanması gerektiğinde bu tetikleyiciyi kullanın. Oturum zaman aşımını aşarsa, C TWO bunu zaman aşımı ilkesine göre işler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Görev Kimliği	taskId	True	integer	Bu akışı tetikleyecek C İkİ görevini seçin. Bu görev için bir oturum oluşturulduğunda, akış belirtilen zaman aşımının uygulanmasıyla başlar.
Saniye zaman aşımı	timeout	True	integer	C TWO zaman aşımına uğradı olarak işaretlemeden önce oturumun çalışmasına izin verilen saniye cinsinden en uzun süre.

Döndürülenler

Name	Yol	Tür	Description
sessions	sessions	array of object	C TWO tarafından zaman aşımı ile tetiklenen oturum kümesi
oturumKimliği	sessions.sessionId	integer	oturumKimliği
workflowTaskId	sessions.workflowTaskId	integer	workflowTaskId
iş akışı adı	sessions.workflowName	string	iş akışı adı
taskName	sessions.taskName	string	taskName
created	sessions.created	string	created
processInputValues	sessions.processInputValues	object	processInputValues

Zaman Aşımı Olmadan Oturum İsteğinden Akış Başlatma

İşlem Kimliği:: StartFlowWithoutTimeout

Yeni C TWO oturumlarını yoklar ve seçili görev için bir oturum oluşturulduğunda akışı tetikler. Otomasyon zaman aşımı kısıtlaması gerektirmediğinde bu tetikleyiciyi kullanın. Akış, C TWO'dan geçirilen giriş değerleri de dahil olmak üzere oturum ayrıntılarını alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Görev Kimliği	taskId	True	integer	Bu akışı tetikleyecek C İkİ görevini seçin. C TWO'da bu görev için yeni bir oturum oluşturulduğunda, akış zaman aşımına uğramadan otomatik olarak başlatılır.

Döndürülenler

Name	Yol	Tür	Description
sessions	sessions	array of object	C TWO tarafından zaman aşımı olmadan tetiklenen oturum kümesi
oturumKimliği	sessions.sessionId	integer	oturumKimliği
workflowTaskId	sessions.workflowTaskId	integer	workflowTaskId
iş akışı adı	sessions.workflowName	string	iş akışı adı
taskName	sessions.taskName	string	taskName
created	sessions.created	string	created
processInputValues	sessions.processInputValues	object	processInputValues