C2 (előzetes verzió)

A C2 egy ügynöki felügyeleti platform, amely automatizálási munkafolyamatokat vezényel, emberi-robot interakciókat kezel, és univerzális üzenetsorokon keresztül dolgozza fel a munkaelemeket. Ezzel az összekötővel elindíthatja a C2 munkamenetekből származó folyamatokat, kezelheti a munkamenetek életciklusát, létrehozhat és feldolgozhat üzenetsorelemeket, és lehetővé teheti a cikluson belüli emberi interakciókat a digitális feldolgozókkal.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service	Class	Regions
Copilot Studio	prémium	Az összes Power Automate régió kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások	Standard	Az összes Logic Apps-régió , kivéve a következőket: - Azure Government régiók - Azure Kína régiói - Amerikai Védelmi Minisztérium (DoD)
Power Apps	prémium	Az összes Power Apps régió kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)
Power Automate	prémium	Az összes Power Automate régió kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)

Contact
Név	C2 támogatás
URL	https://ctwo.com/
Email	customersuccess@ctwo.com

Összekötő metaadatai
Publisher	C2
Webhely	https://ctwo.com/
Adatvédelmi irányelvek	https://ctwo.com/privacy-policy/
Categories	Üzleti intelligencia; AI

C2

A C2 egy ügynöki felügyeleti platform, amely automatizálási munkafolyamatokat vezényel, emberi-robot interakciókat kezel, és univerzális üzenetsorokon keresztül dolgozza fel a munkaelemeket. Ez az összekötő lehetővé teszi Power Automate, Power Apps, Azure Logic Apps és Copilot Studio eseményindítót, amelyet C2 munkamenetek aktiválnak, kezelheti a munkamenet életciklusát, univerzális üzenetsor-elemeket hozhat létre és dolgozhat fel, valamint lehetővé teszi a digitális feldolgozókkal való emberi interakciót.

A C2 egyetlen vezénylési, irányítási és monitorozási rétegként helyezkedik el az automatizálási tulajdon felett: bármi is hozza létre vagy hajtja végre a munkát, a C TWO SLA-követést, újrapróbálkozást és önjavítást, élő munkamenet telemetriát és teljes auditnaplót ad hozzá.

Prerequisites

A kapcsolat létrehozása előtt a következőkre lesz szüksége:

Aktív C2-bérlő – vagy c2 felhő (üzemeltetett) vagy egy helyszíni C2-kiszolgáló, amely HTTPS-en keresztül érhető el.
A C2-rendszergazda által kibocsátott szolgáltatásfiók-jogkivonat vagy személyes hozzáférési jogkivonat (lásd : Hitelesítő adatok beszerzése).
Ha a C2-t a helyszínen üzemeltetik, a kiszolgálónak HTTPS-en keresztül elérhetőnek kell lennie a Power Platformról (tűzfal, amely lehetővé teszi Microsoft Power Automate kimenő IP-tartományait – Azure szolgáltatáscímkéket AzureConnectors.<region> és PowerPlatformPlex a Power Platform Geo-t).
Egyéni összekötő engedélyekkel és egyéni összekötőket támogató licencszinttel rendelkező Power Platform-környezet (Power Automate Prémium vagy azzal egyenértékű).

Kapcsolat létrehozása

Kapcsolat létrehozásakor három értéket ad meg, mindezt a saját C2-környezetéből:

C TWO-gazdagép – csak a C2 kiszolgáló állomásneve (nincs séma, nincs záró perjel), például connect24.ctwo.cloudegy olyan helyszíni gazdagép, amely nem kötelező porttal rendelkezik, például ctwo.contoso.com:8443.
C2 Alap URL-cím – a C TWO API alap elérési útja, beleértve az osztást is, egy perjellel kezdve, záró perjel nélkül, például. /DEFAULT/CTWO.Server/api
API-kulcs – a jogkivonat, amely a Bearer <your-token>következőképpen van megadva: . Ajánlott szolgáltatásfiók-jogkivonatot létrehozni; a személyes hozzáférési jogkivonat is működik.

A gazdagép és az alap URL-cím együtt irányítja az összekötőt a saját C2-kiszolgálóra (https://{Host}{Base URL}/…), így minden ügyfél a saját környezetéhez csatlakozik – c2 felhőhöz vagy helyszínihez.

Hitelesítő adatok beszerzése

A hitelesítés a fejlécben Authorization tulajdonosi jogkivonatként küldött API-kulcsot használ.

Szolgáltatásfiók jogkivonata (éles környezetben ajánlott)

Jelentkezzen be a C2-példányba.
Nyissa meg az Alkalmazások és kapcsolatok → Microsoft Power Automate → Szolgáltatásfiók létrehozása elemet.
Másolja a létrehozott jogkivonatot azonnal – csak egyszer jelenik meg.

Személyes hozzáférési jogkivonat (fejlesztés/tesztelés)

Nyissa meg a felhasználói profilját a C2-ben.
Lépjen az API-jogkivonatok lapra, és hozzon létre egy új jogkivonatot.
Másolja ki azonnal – csak egyszer jelenik meg, és érvényteleníti, ha a felhasználói fiók le van tiltva.

Mindkét jogkivonattípust titkos kódként kezelje – csak a Power Platform kapcsolat hitelesítő adataiban tárolja őket, soha ne folyamatváltozókban vagy ügyféloldali kódban.

Támogatott műveletek

Eseményindítók – Folyamat indítása, amikor a C2 egy munkamenetet küld, kényszerített időtúllépéssel vagy anélkül.
Munkamenet-kezelés – Jelentés befejezése/sikertelensége, beírt munkamenetnaplók írása, a munkamenet időtúllépésének módosítása és a türelmes leállítási kérelem ellenőrzése.
Univerzális üzenetsor – Üzenetsorelemek létrehozása, listázása, zárolása, feloldása, újrapróbálkozása és elhalasztása; elemadatok frissítése és elemszintű naplók hozzáadása; címkék hozzáadása/eltávolítása; mellékletek lekérése; egyéni elemállapotok létrehozása; listasorok.
Human-in-the-loop – Strukturált emberi segédűrlapok létrehozása, hozzárendelése, hozzárendelése és hozzárendelésének megszüntetése, valamint lekérése/lekérdezése.

A belső segédműveletek dinamikus legördülő listákat (feladat- és felhasználóválasztókat) töltenek fel, és nem hívják őket közvetlenül.

Ismert problémák és korlátozások

Helyes állomás- és alap URL-cím szükséges. Mindkettőt a csatlakozási időpontban adja meg, és az összekötőt a C2-kiszolgálóra irányítja. A helytelen vagy nem elérhető értékek kapcsolati vagy kérési hibákat eredményeznek.
API-kulcsformátum. Az API-kulcs mező a literális sztringet Bearer <token> várja – az előtag kihagyásával az Bearer eredmény a következő lesz 401 Unauthorized: .
JSON-elemadatok megadása. Az elem-adatmezők (Create Queue Item, Set Queue Item Data) JSON-objektumok. Egy folyamatban adja meg a literális JSON-t a json('…') kifejezéssel, hogy a rendszer sztring helyett objektumként küldje el.
Lekérdezési eseményindító késése. Leküldés helyett lekérdezi a lekérdezést, így a C2-ben küldött munkamenet és a folyamat elindulása között (az eseményindító ismétlődése által határolt) kis késleltetés van.
Űrlapmezőtípusok. Az űrlapműveletek által visszaadott azonosítómezők lehetnek egész számok, sztringek vagy null értékek az űrlap állapotától függően.

Gyakori hibák és jogorvoslatok

Hiba	Valószínű ok	Orvoslat
`401 Unauthorized`	Az API-kulcs hiányzik az `Bearer` előtagból, lejárt vagy visszavonva	Adja meg újra a hitelesítő adatokat a következőként `Bearer <token>`: ; hozzon létre egy új szolgáltatásfiók-jogkivonatot, ha visszavonják
`400 Bad request` üzenetsorelem létrehozásakor	Hiányzik egy kötelező mező (`reference`, `queueItemState`, `itemKey`)	Mindhárom kötelező mező kitöltése
A trigger soha nem aktiválódik	Helytelen tevékenység van kijelölve, vagy a C2 tevékenység nem érhető el Power Automate	Győződjön meg arról, hogy a tevékenység megjelenik a Tevékenységazonosító legördülő listában, és a C2-ben közzétett folyamatként van konfigurálva
Szökött sztringként tárolt elemadatok	Objektum helyett szövegként megadott JSON	Használja a `json('…')` kifejezést (folyamatokat) vagy a nyers törzset (összekötő-teszt), hogy objektumként legyen elküldve

GYIK

Használhatom ezt az összekötőt Power Apps, Azure Logic Apps és Copilot Studio, nem csak Power Automate? Yes. Az eseményindítók Power Automate-specifikusak, de a kapcsolat létrehozása után minden művelet meghívható bármelyik platformról.

Ez az összekötő kezeli a licencelést? No. A C2 vezényli és szabályozza a végrehajtást; az ügyfelek felelősek saját Microsoft licencelésükért.

Hol kaphatok segítséget? Lépjen kapcsolatba a C2 ügyfél sikerrel itt customersuccess@ctwo.com: .

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:


Alapértelmezett	A kapcsolat létrehozásának paraméterei.	Minden régió	Nem osztható meg

Alapértelmezett

Alkalmazható: Minden régió

A kapcsolat létrehozásának paraméterei.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Név	Típus	Description	Szükséges
C2 gazdagép	karakterlánc	A C2 kiszolgáló állomásneve csak â € " nincs séma, nincs záró perjel. Például connect24.ctwo.cloud, vagy egy olyan helyszíni gazdagépet, amely opcionális portot (például ctwo.contoso.com:8443) is használhat.	True
C2 Alap URL-címe	karakterlánc	A C TWO API alapútvonala, beleértve az osztást is. Kezdje egy perjellel, nincs záró perjel. Például /DEFAULT/CTWO. Kiszolgáló/api.	True
API-kulcs	securestring	A C2 API-jogkivonat a következőként van megadva: A jogkivonat> tulajdonosának <megadása. Ajánlott szolgáltatásfiók-jogkivonatot létrehozni; a személyes hozzáférési jogkivonat is működik.	True

Műveletek

Címkék eltávolítása az üzenetsorelemből	Eltávolít egy vagy több címkét egy üzenetsorelemből. Ezzel a műveletsel frissítheti a munkaelemek kategorizálását a feldolgozás során.
Címkék hozzáadása üzenetsorelemhez	Egy vagy több címkét ad hozzá egy üzenetsorelemhez kategorizáláshoz és szűréshez. A címkék segítenek a munkaelemek rendszerezésében és keresésében az üzenetsorok között.
Folyamatvégrehajtási állapot beállítása befejezettre	Befejezettként jelöl meg egy C2 munkamenetet, jelezve, hogy a folyamat sikeresen befejeződött. Helyezze ezt a műveletet a folyamat végére, és jelentse vissza a C2-nek, hogy az automatizálás hiba nélkül befejeződött.
Folyamatvégrehajtási állapot beállítása sikertelenre	A C2-munkamenetet sikertelennek jelöli, jelezve, hogy hiba történt a folyamat végrehajtása során. Ezzel a művelettel hibakezelési hatókörökben jelentheti vissza a hibákat a C2-be a hiba részleteivel.
Munkamenet időtúllépésének beállítása	Frissíti az aktív C2 munkamenet időtúllépési értékét. Ezzel a műveletsel meghosszabbíthatja vagy csökkentheti egy futó munkamenet engedélyezett végrehajtási idejét, amikor az eredeti időtúllépést módosítani kell.
Munkamenet leállítása	Ellenőrzi, hogy a C TWO kért-e kecses (helyreállítható) leállást az adott munkamenethez. Ezt a műveletet ciklusokon belül használva rendszeres időközönként ellenőrizheti, hogy a munkamenet korán leálljon-e, így a folyamat a leállítás előtt megtisztíthatja az erőforrásokat.
Napló hozzáadása munkamenethez	Naplóbejegyzést ír egy C2-munkamenetbe. Ezzel a művelettal nyomon követheti az előrehaladást, rögzítheti a döntéseket vagy naplódiagnosztikai adatokat a folyamat végrehajtása során. A naplók a C2 platformon láthatók naplózáshoz és hibaelhárításhoz.
Napló hozzáadása üzenetsorelemhez	Naplóüzenetet ad hozzá egy üzenetsor-elemhez az auditútvonal és a nyomon követhetőség érdekében. Ez a művelet egy adott munkaelem feldolgozási lépéseinek, figyelmeztetéseinek vagy hibáinak rögzítésére használható.
Várólistaelem újrapróbálkozás	Próbálkozzon újra egy adott üzenetsorelemtel, állítsa vissza az adatokat az eredeti értékére, és hozzon létre egy új kísérletet.
Üzenetsor-elem zárolása	Zárol egy üzenetsor-elemet, hogy más feldolgozók ne dolgozzék fel egyidejűleg. A munkaelem feldolgozása előtt használja ezt a műveletet a kizárólagos hozzáférés biztosításához.
Üzenetsorelem adatainak beállítása	Frissíti egy üzenetsorelem adattartalmát. Ezzel a műveletsel módosíthatja egy munkaelem hasznos adatait a feldolgozás során, például köztes eredmények tárolására.
Üzenetsorelem halasztás	Az üzenetsorelemeket a program a megadott dátum/idő értékre állítja, így az nem lesz feldolgozva. Akkor használja ezt a műveletet, ha egy elemet nem lehet most feldolgozni, de később újra meg kell próbálkozni.
Üzenetsorelem létrehozása	Új munkaelemet hoz létre egy megadott univerzális üzenetsorban. Ezzel a művelettel elemeket adhat hozzá a digitális feldolgozók által történő feldolgozáshoz, beleértve az adat hasznos adatait, a címkéket és az opcionális fájlmellékleteket.
Üzenetsorelem mellékletének lekérése	Egy adott fájlmellékletet kér le egy üzenetsorelemből base64 kódolású adatként. Ezzel a műveletsel letöltheti a munkaelemekhez a létrehozás vagy feldolgozás során csatolt fájlokat.
Üzenetsorelem zárolásának feloldása	Felold egy korábban zárolt üzenetsor-elemet, és visszaadja a rendelkezésre álló állapotba. Ezt a műveletet akkor használja, ha a feldolgozás megszakad, és az elemet ki kell szabadítani más feldolgozók számára.
Üzenetsorelem-állapot létrehozása	Új egyéni állapotot hoz létre egy adott üzenetsoron belül. Az egyéni állapotok lehetővé teszik az alapértelmezett állapotokon (Függőben, Befejezve, Hivatkozott) túli munkafolyamat-szakaszok definiálását, így az üzenetsort az üzleti folyamathoz igazíthatja.
Üzenetsorelem állapotának beállítása	Egy üzenetsorelem állapotát (például függőben lévőről befejezettre vagy egyéni állapotra) módosítja. Ezzel a műveletgel előreléptetheti az elemeket a munkafolyamaton keresztül.
Üzenetsorelemek lekérése	Az üzenetsorelemeket a megadott szűrési feltételek, például állapot, címkék, dátumok és üzenetsornevek alapján kéri le. Ezzel a művelettel megkeresheti és figyelheti a munkaelemeket az univerzális üzenetsorokban.
Üzenetsorok lekérése	Szűrőfeltételek alapján kéri le az univerzális üzenetsorokat. Ezzel a művelettel listázhatja az elérhető üzenetsorokat, ellenőrizheti a konfigurációjukat, vagy megkeresheti az üzenetsor részleteit. Ez a művelet más műveletek dinamikus legördülő menüjét is működteti.
Űrlap hozzárendelése	Robot-interakciós űrlapot rendel hozzá egy adott felhasználóhoz, így ő felel az emberi folyamaton belüli kérés áttekintéséért és teljesítéséért.
Űrlap hozzárendelésének megszüntetése	Eltávolítja az aktuális felhasználói hozzárendelést egy robot interakciós űrlapjáról, így más felhasználók is igényelhetik.
Űrlap kitöltése	Befejezettként jelöli meg a robotok interakciós űrlapot, jelezve, hogy az emberi felhasználó megadta a kért bemenetet, és a digitális feldolgozó folytathatja a feldolgozást.
Űrlap lekérése azonosító szerint	Egy adott robot-interakciós űrlapot kér le egyedi azonosítójával. Ezzel a művelettal lekérheti egy digitális feldolgozó által létrehozott emberi ciklusban lévő űrlap részleteit, mezőit és aktuális állapotát.
Űrlap létrehozása	Létrehoz egy új robot-interakciós űrlapot, amely lehetővé teszi a digitális feldolgozó számára, hogy emberi segítséget kérjen. Az űrlap a C2 platform hozzárendelt felhasználói számára jelenik meg, lehetővé téve olyan emberi helyzetek használatát, ahol emberi szakértelemre van szükség a kivételek vagy összetett döntések kezeléséhez.
Űrlapok lekérése	Lekéri a robotok interakciós űrlapjainak listáját opcionális szűréssel. Ezzel a művelettal lekérdezheti a függőben lévő emberi kérelmeket, ellenőrizheti az állapotukat, vagy megkeresheti az adott felhasználókhoz rendelt űrlapokat.

Címkék eltávolítása az üzenetsorelemből

Műveletazonosító:: RemoveItemTag

Eltávolít egy vagy több címkét egy üzenetsorelemből. Ezzel a műveletsel frissítheti a munkaelemek kategorizálását a feldolgozás során.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Üzenetsorelem azonosítója	queueItemId	True	string	A címkék eltávolításához használható üzenetsorelem azonosítója.
Tags	tags		string	Az eltávolítandó címkék vesszővel tagolt listája.

Címkék hozzáadása üzenetsorelemhez

Műveletazonosító:: AddItemTag

Egy vagy több címkét ad hozzá egy üzenetsorelemhez kategorizáláshoz és szűréshez. A címkék segítenek a munkaelemek rendszerezésében és keresésében az üzenetsorok között.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Üzenetsorelem azonosítója	queueItemId	True	string	Annak az üzenetsorelemnek az azonosítója, amelybe címkéket szeretne felvenni.
Tags	tags		string	A hozzáadni kívánt címkék vesszővel tagolt listája.

Folyamatvégrehajtási állapot beállítása befejezettre

Műveletazonosító:: SetSessionCompleted

Befejezettként jelöl meg egy C2 munkamenetet, jelezve, hogy a folyamat sikeresen befejeződött. Helyezze ezt a műveletet a folyamat végére, és jelentse vissza a C2-nek, hogy az automatizálás hiba nélkül befejeződött.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Munkamenet-azonosító	sessionId	True	string	A sikeresként megjelölendő C2 munkamenet-azonosító. Alapértelmezés szerint a munkamenet-azonosító az eseményindító kimenetéből származik.

Válaszok

response: object

Folyamatvégrehajtási állapot beállítása sikertelenre

Műveletazonosító:: SetSessionFailed

A C2-munkamenetet sikertelennek jelöli, jelezve, hogy hiba történt a folyamat végrehajtása során. Ezzel a művelettel hibakezelési hatókörökben jelentheti vissza a hibákat a C2-be a hiba részleteivel.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Munkamenet-azonosító	sessionId	True	string	A sikertelenként megjelölendő C2 munkamenet-azonosító. Alapértelmezés szerint a munkamenet-azonosító az eseményindító kimenetéből származik.
details	details	True	string	A munkamenet meghiúsulását okozó hiba vagy kivétel leírása.

Munkamenet időtúllépésének beállítása

Műveletazonosító:: SetTimeout

Frissíti az aktív C2 munkamenet időtúllépési értékét. Ezzel a műveletsel meghosszabbíthatja vagy csökkentheti egy futó munkamenet engedélyezett végrehajtási idejét, amikor az eredeti időtúllépést módosítani kell.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Munkamenet-azonosító	sessionId	True	string	A C2 munkamenet-azonosító az időtúllépés frissítéséhez. Alapértelmezés szerint a munkamenet-azonosító az eseményindító kimenetéből származik.
Időkorlát	timeout	True	integer	A munkamenetre alkalmazandó új időtúllépési érték másodpercben.

Válaszok

response: string

Munkamenet leállítása

Műveletazonosító:: IsStopRequested

Ellenőrzi, hogy a C TWO kért-e kecses (helyreállítható) leállást az adott munkamenethez. Ezt a műveletet ciklusokon belül használva rendszeres időközönként ellenőrizheti, hogy a munkamenet korán leálljon-e, így a folyamat a leállítás előtt megtisztíthatja az erőforrásokat.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Munkamenet-azonosító	sessionId	True	string	A C2 munkamenet-azonosító a leállítási kérelem ellenőrzéséhez. Alapértelmezés szerint a munkamenet-azonosító az eseményindító kimenetéből származik.

Válaszok

Name	Elérési út	Típus	Description
isStopRequested	isStopRequested	boolean	isStopRequested

Napló hozzáadása munkamenethez

Műveletazonosító:: AddLogToSession

Naplóbejegyzést ír egy C2-munkamenetbe. Ezzel a művelettal nyomon követheti az előrehaladást, rögzítheti a döntéseket vagy naplódiagnosztikai adatokat a folyamat végrehajtása során. A naplók a C2 platformon láthatók naplózáshoz és hibaelhárításhoz.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Munkamenet-azonosító	sessionId	True	string	A C2 munkamenet azonosítója, ahol a naplóbejegyzés rögzítve lesz. Alapértelmezés szerint a munkamenet-azonosító az eseményindító kimenetéből származik.
szint	level	True	string	A naplóbejegyzés súlyossági szintje.
üzenet	message	True	string	A rögzítendő naplóüzenet tartalma.

Napló hozzáadása üzenetsorelemhez

Műveletazonosító:: AddItemLog

Naplóüzenetet ad hozzá egy üzenetsor-elemhez az auditútvonal és a nyomon követhetőség érdekében. Ez a művelet egy adott munkaelem feldolgozási lépéseinek, figyelmeztetéseinek vagy hibáinak rögzítésére használható.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Üzenetsorelem azonosítója	queueItemId	True	string	A naplózni kívánt üzenetsorelem azonosítója.
Naplószint	level		string	A naplóbejegyzés súlyossági szintje.
Message	message		string	A naplóüzenet tartalma.

Várólistaelem újrapróbálkozás

Műveletazonosító:: RetryItem

Próbálkozzon újra egy adott üzenetsorelemtel, állítsa vissza az adatokat az eredeti értékére, és hozzon létre egy új kísérletet.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Üzenetsorelem azonosítója	queueItemId	True	integer	Az újrapróbálkozandó üzenetsorelem-azonosító.
Állapotazonosító	stateId		integer	Meghatározott függőben lévő üzenetsorelem-állapotazonosító, amely be van állítva; elsőbbséget élvez az állapotparaméternél.
State	state		string	Meghatározott függőben lévő üzenetsorelem-állapot neve.
Munkafolyamat tevékenységazonosítója	workflowTaskId		integer	WorkflowTask-azonosító.
alkalmazásazonosító	appId		integer	Alkalmazásazonosító.

Üzenetsor-elem zárolása

Műveletazonosító:: LockItem

Zárol egy üzenetsor-elemet, hogy más feldolgozók ne dolgozzék fel egyidejűleg. A munkaelem feldolgozása előtt használja ezt a műveletet a kizárólagos hozzáférés biztosításához.

Paraméterek

Name	Kulcs	Típus	Description
Üzenetsorelem azonosítója	queueItemId	string	A zárolni kívánt üzenetsorelem azonosítója. Ha nincs megadva, a szűrőnek megfelelő következő elérhető elem zárolva lesz.
Várólista neve	reference	string	Az üzenetsor-hivatkozás egy elem zárolásához.
Állapotazonosító	stateId	string	Az elemek szűréséhez tartozó állapotazonosító.
Államnév	stateName	string	Az elemek szűréséhez megadott állapotnév.
Munkamenet-azonosító	sessionId	string	A zárolás munkamenet-azonosítója.

Válaszok

Name	Elérési út	Típus	Description
id	id	integer	A zárolt elem egyedi azonosítója.
itemKey	itemKey	string	A zárolt elem egyedi kulcsa.
Kísérlet	attempts	integer	A feldolgozási kísérletek száma.
queueId	queueId	integer	A szülősor azonosítója.
id	state.id	integer	Az állapotazonosító.
név	state.name	string	Az állam neve.
state	state.state	string	Az állapotérték.
tags	tags	array of string	Az üzenetsorelemhez társított címkék.
létrehozva	created	string	A létrehozási időbélyeg.
createdByVendorSessionId	createdByVendorSessionId	integer	Az elemet létrehozó munkamenet-azonosító.
lezárult	concluded	string	A következtetés időbélyege.
Halasztott	deferred	string	A késleltetett időbélyeg.
teszt	test	boolean	Tesztelemről van-e szó.
zárolt	locked	boolean	Azt jelzi, hogy az elem zárolva van-e.

Üzenetsorelem adatainak beállítása

Műveletazonosító:: SetItemData

Frissíti egy üzenetsorelem adattartalmát. Ezzel a műveletsel módosíthatja egy munkaelem hasznos adatait a feldolgozás során, például köztes eredmények tárolására.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Üzenetsorelem azonosítója	queueItemId	True	string	A frissíteni kívánt üzenetsorelem azonosítója.
Adatok	data		object	Az üzenetsorelem új adat-hasznos adatai JSON-objektumként.
Létrehozott	created		date-time	Az adatok létrehozási időbélyege.

Üzenetsorelem halasztás

Műveletazonosító:: DeferItem

Az üzenetsorelemeket a program a megadott dátum/idő értékre állítja, így az nem lesz feldolgozva. Akkor használja ezt a műveletet, ha egy elemet nem lehet most feldolgozni, de később újra meg kell próbálkozni.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Üzenetsorelem azonosítója	queueItemId	True	string	A halasztani kívánt üzenetsorelem azonosítója.
Halasztva, amíg	deferredUntil		date-time	A halasztás dátuma/ideje (ISO 8601 formátum).

Válaszok

response: string

Üzenetsorelem létrehozása

Műveletazonosító:: CreateItem

Új munkaelemet hoz létre egy megadott univerzális üzenetsorban. Ezzel a művelettel elemeket adhat hozzá a digitális feldolgozók által történő feldolgozáshoz, beleértve az adat hasznos adatait, a címkéket és az opcionális fájlmellékleteket.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Elemkulcs	itemKey	True	string	Az üzenetsorelem azonosítására szolgáló egyedi üzleti kulcs (például számlaszám, esetazonosító).
Üzenetsorelem állapota	queueItemState	True	string	Az üzenetsorelem kezdeti állapota (például Függőben).
Üzenetsor-referencia	reference	True	string	Az üzenetsor-hivatkozás, ahol az elem létre lesz hozva.
Halasztva, amíg	deferredUntil		date-time	Halasztja a feldolgozást erre a dátumra/időre (ISO 8601 formátum).
Elemadatok	itemData		object	Az üzenetsorelem adat-hasznos adatai JSON formátumban.
Tags	tags		string	Az üzenetsorelem címkéi (vesszővel elválasztva).
fileName	fileName		string	A mellékletfájl neve.
fileData	fileData		string	A base64 kódolású fájladatok.
Munkamenet-azonosító	sessionId		string	Az elemhez társított munkamenet-azonosító.
Készülék	device		string	Az elemet létrehozó eszköz.
User	user		string	Az elemet létrehozó felhasználó.
Automation-szolgáltató	automationProvider		string	Az elem automatizálási szolgáltatója.

Válaszok

Name	Elérési út	Típus	Description
id	id	integer	id
itemKey	itemKey	string	itemKey
Kísérlet	attempts	integer	Kísérlet
queueId	queueId	integer	queueId
id	state.id	integer	id
név	state.name	string	név
state	state.state	string	state
tags	tags	array of string	tags
létrehozva	created	string	létrehozva
createdByVendorSessionId	createdByVendorSessionId	integer	createdByVendorSessionId
Következtet	concluded	string	lezárult
Halasztott	deferred	string	Halasztott
teszt	test	boolean	teszt
zárolt	locked	boolean	zárolt

Üzenetsorelem mellékletének lekérése

Műveletazonosító:: GetItemAttachment

Egy adott fájlmellékletet kér le egy üzenetsorelemből base64 kódolású adatként. Ezzel a műveletsel letöltheti a munkaelemekhez a létrehozás vagy feldolgozás során csatolt fájlokat.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Üzenetsorelem azonosítója	queueItemId	True	string	A mellékletet tartalmazó üzenetsorelem azonosítója.
Melléklet azonosítója	attachmentId	True	string	A lekérni kívánt melléklet azonosítója.
Filename	filename		string	A melléklet fájlneve.

Válaszok

response: string

Üzenetsorelem zárolásának feloldása

Műveletazonosító:: UnlockItem

Felold egy korábban zárolt üzenetsor-elemet, és visszaadja a rendelkezésre álló állapotba. Ezt a műveletet akkor használja, ha a feldolgozás megszakad, és az elemet ki kell szabadítani más feldolgozók számára.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Üzenetsorelem azonosítója	queueItemId	True	string	A feloldandó üzenetsorelem azonosítója.

Üzenetsorelem-állapot létrehozása

Műveletazonosító:: CreateItemState

Új egyéni állapotot hoz létre egy adott üzenetsoron belül. Az egyéni állapotok lehetővé teszik az alapértelmezett állapotokon (Függőben, Befejezve, Hivatkozott) túli munkafolyamat-szakaszok definiálását, így az üzenetsort az üzleti folyamathoz igazíthatja.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Név	name		string	Az új állapot neve.
Válaszidő kiszámítása	responseTimeCalculationBasis	True	string	Meghatározza, hogy a válaszidő SLA-k hogyan legyenek kiszámítva az ilyen állapotba lépő elemek esetében.
Állapottípus	state	True	string	Az állapot típusa (Függőben, Befejezve vagy Hivatkozott).
Feldolgozási sor azonosítója	queueId	True	integer	Annak az üzenetsornak az azonosítója, ahol ez az állapot létrejön.
Description	description		string	Annak leírása, hogy ez az állapot mit jelöl a munkafolyamatban.
Elemenként mentett idő	timeSavedPerItem		integer	Ebben az állapotban (másodpercben) elemenként megtakarított idő, amelyet a ROI-jelentéskészítéshez használnak.
Elemenként generált érték	valueGeneratedPerItem		integer	Ebben az állapotban elemenként generált érték, amely a ROI-jelentéskészítéshez használatos.
Belefoglalás a jelentésekbe	includeInReports		boolean	Azt határozza meg, hogy ezt az állapotot belefoglalja-e az elemzésekbe és jelentésekbe.

Üzenetsorelem állapotának beállítása

Műveletazonosító:: SetItemState

Egy üzenetsorelem állapotát (például függőben lévőről befejezettre vagy egyéni állapotra) módosítja. Ezzel a műveletgel előreléptetheti az elemeket a munkafolyamaton keresztül.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Üzenetsorelem azonosítója	queueItemId	True	string	A frissíteni kívánt üzenetsorelem azonosítója.
State	state		string	Az üzenetsorelem új állapota.

Üzenetsorelemek lekérése

Műveletazonosító:: GetItems

Az üzenetsorelemeket a megadott szűrési feltételek, például állapot, címkék, dátumok és üzenetsornevek alapján kéri le. Ezzel a művelettel megkeresheti és figyelheti a munkaelemeket az univerzális üzenetsorokban.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Elemkulcs	itemKey		string	Szűrés elemkulcs szerint.
Attempts	attempts		integer	Szűrés a kísérletek száma alapján.
Halasztás előtt	deferredBefore		date-time	Szűrje a dátum előtt elhalasztott elemeket.
Halasztás után	deferredAfter		date-time	A dátum után elhalasztott elemek szűrése.
Létrehozás előtt	createdBefore		date-time	Szűrje a dátum előtt létrehozott elemeket.
Létrehozás után	createdAfter		date-time	Szűrje a dátum után létrehozott elemeket.
Lezárult:	concludedBefore		date-time	Szűrje az e dátum előtt befejezett elemeket.
Lezárult:	concludedAfter		date-time	A dátum után befejezett elemek szűrése.
Korábban megadott állapot	stateEnteredTimeBefore		date-time	Szűrje azokat az elemeket, amelyek eddig az időpontig beírták az állapotot.
Az állapot megadása után	stateEnteredTimeAfter		date-time	Szűrje azokat az elemeket, amelyek ezután adták meg az állapotot.
States	states		string	Szűrés üzenetsorelem-állapot szerint.
Üzenetsorelem állapotazonosítói	queueItemStateIds		integer	Szűrés üzenetsorelem-állapotazonosítók szerint.
Üzenetsorelem állapotnevei	queueItemStateNames		string	Szűrés üzenetsorelem-állapotnevek alapján.
Tags	tags		string	Szűrés címkék szerint (vesszővel elválasztva).
Üzenetsor-azonosítók	queueIds		integer	Szűrés üzenetsor-azonosítók szerint.
Üzenetsorok nevei	queueNames	True	string	Szűrés üzenetsornevek alapján (kötelező).
References	references		string	Szűrés üzenetsor-hivatkozások alapján.
Elemadatok belefoglalása	includeItemData		boolean	Az elemek adatainak a válaszba való belefoglalása.
Kihagyás	skip		integer	A lapozáshoz kihagyandó rekordok száma.
Vesz	take		integer	A visszaadni kívánt rekordok száma.

Válaszok

Name	Elérési út	Típus	Description
		array of object
id	id	integer	Az üzenetsorelem egyedi azonosítója.
itemKey	itemKey	string	Az üzenetsorelem egyedi kulcsa.
Kísérlet	attempts	integer	A feldolgozási kísérletek száma.
queueId	queueId	integer	A szülősor azonosítója.
id	state.id	integer	Az állapotazonosító.
név	state.name	string	Az állam neve.
state	state.state	string	Az állapotérték.
tags	tags	array of string	Az üzenetsorelemhez társított címkék.
létrehozva	created	string	A létrehozási időbélyeg.
createdByVendorSessionId	createdByVendorSessionId	integer	Az elemet létrehozó munkamenet-azonosító.
Következtet	concluded	string	A következtetés időbélyege.
Halasztott	deferred	string	A késleltetett időbélyeg.
teszt	test	boolean	Tesztelemről van-e szó.
zárolt	locked	boolean	Azt jelzi, hogy az elem zárolva van-e.

Üzenetsorok lekérése

Műveletazonosító:: GetQueues

Szűrőfeltételek alapján kéri le az univerzális üzenetsorokat. Ezzel a művelettel listázhatja az elérhető üzenetsorokat, ellenőrizheti a konfigurációjukat, vagy megkeresheti az üzenetsor részleteit. Ez a művelet más műveletek dinamikus legördülő menüjét is működteti.

Paraméterek

Name	Kulcs	Típus	Description
Feldolgozási sor azonosítója	id	string	Szűrés üzenetsor-azonosító alapján.
Üzenetsor-referencia	reference	string	Szűrés üzenetsor-hivatkozás alapján.
Várólista neve	name	string	Szűrés üzenetsor neve alapján.
Államnév	stateName	string	Szűrés államnév alapján.
Törölve	deleted	boolean	Szűrés törölt állapot szerint.
Kihagyás	skip	integer	A lapozáshoz kihagyandó rekordok száma.
Vesz	take	integer	A visszaadni kívánt rekordok száma.

Válaszok

Name	Elérési út	Típus	Description
		array of object
id	id	integer	A sor egyedi azonosítója.
törölt	deleted	boolean	Azt jelzi, hogy az üzenetsor törölve van-e.
név	name	string	Az üzenetsor neve.
description	description	string	Az üzenetsor leírása.
látható	visible	boolean	Az üzenetsor látható-e.
includeInReports	includeInReports	boolean	Hogy szerepeljenek-e a jelentésekben.
létrehozva	created	string	A létrehozási időbélyeg.
frissül	updated	string	Az utolsó frissítés időbélyege.
deletedTime	deletedTime	string	A törlés időbélyege.
divisionId	divisionId	integer	Az osztás azonosítója.
típus	type	integer	Az üzenetsor típusa.
hivatkozás	reference	string	Az üzenetsor referenciája.
Államok	states	array of object	Az üzenetsorban elérhető állapotok.
id	states.id	integer	Az állapotazonosító.
név	states.name	string	Az állapot neve.
description	states.description	string	Az állapot leírása.
tagfilter	states.tagfilter	string	Az állapot címkeszűrője.
state	states.state	integer	Az állapot típusa.
timeSavedPerItem	states.timeSavedPerItem	integer	Elemenként mentett idő.
includeInReports	states.includeInReports	boolean	Hogy szerepeljenek-e a jelentésekben.
responseTimeCalculationBasis	states.responseTimeCalculationBasis	integer	A válaszidő kiszámításának alapja.

Űrlap hozzárendelése

Műveletazonosító:: AssignForm

Robot-interakciós űrlapot rendel hozzá egy adott felhasználóhoz, így ő felel az emberi folyamaton belüli kérés áttekintéséért és teljesítéséért.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Űrlapazonosító	formId	True	string	Emberi a hurok űrlapazonosítójában, amelyet hozzárendelni szeretne.
userId	userId		integer	Annak a felhasználónak az azonosítója, akihez hozzá szeretné rendelni az űrlapot.

Űrlap hozzárendelésének megszüntetése

Műveletazonosító:: UnassignForm

Eltávolítja az aktuális felhasználói hozzárendelést egy robot interakciós űrlapjáról, így más felhasználók is igényelhetik.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Űrlapazonosító	formId	True	string	A hurok űrlapazonosítójában szereplő emberi személy a hozzárendelés megszüntetéséhez.

Űrlap kitöltése

Műveletazonosító:: CompleteForm

Befejezettként jelöli meg a robotok interakciós űrlapot, jelezve, hogy az emberi felhasználó megadta a kért bemenetet, és a digitális feldolgozó folytathatja a feldolgozást.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Űrlapazonosító	formId	True	string	A ciklus űrlapazonosítójában szereplő emberi érték, amely befejezettként van megjelölve.
completedAt	completedAt		date-time	Az űrlap befejezésének időbélyege (ISO 8601 formátum).

Űrlap lekérése azonosító szerint

Műveletazonosító:: GetFormById

Egy adott robot-interakciós űrlapot kér le egyedi azonosítójával. Ezzel a művelettal lekérheti egy digitális feldolgozó által létrehozott emberi ciklusban lévő űrlap részleteit, mezőit és aktuális állapotát.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Űrlapazonosító	formId	True	string	A hurok űrlapazonosítójában szereplő emberi adatok a részletek lekéréséhez.

Válaszok

Name	Elérési út	Típus	Description
id	id	integer	id
divisionId	divisionId		divisionId
munkamenet-azonosító	sessionId		munkamenet-azonosító
queueItemId	queueItemId		queueItemId
claimedByUserId	claimedByUserId		claimedByUserId
claimedOn	claimedOn	string	claimedOn
createdByWorkflowTaskId	createdByWorkflowTaskId		createdByWorkflowTaskId
createdByUserId	createdByUserId		createdByUserId
createdOn	createdOn	string	createdOn
határidő	deadline	string	határidő
Befejezett	completed	string	Befejezett
title	title	string	title
Intro	intro	string	bevezetés
Mezők	fields	string	Mezők

Űrlap létrehozása

Műveletazonosító:: CreateForm

Létrehoz egy új robot-interakciós űrlapot, amely lehetővé teszi a digitális feldolgozó számára, hogy emberi segítséget kérjen. Az űrlap a C2 platform hozzárendelt felhasználói számára jelenik meg, lehetővé téve olyan emberi helyzetek használatát, ahol emberi szakértelemre van szükség a kivételek vagy összetett döntések kezeléséhez.

Paraméterek

Name	Kulcs	Típus	Description
Mezők	fields	string	JSON-formátumú sztring, amely meghatározza azokat az űrlapmezőket, amelyeket az emberi felhasználónak ki kell töltenie.
title	title	string	Az űrlap megnyitásakor az emberi felhasználó számára megjelenített cím.
határidő	deadline	date-time	Az a határidő, amellyel az emberi személynek válaszolnia kell az űrlapra (ISO 8601 formátum).
Intro	intro	string	Bevezető szöveg jelenik meg az emberi felhasználó számára, amely elmagyarázza, hogy milyen műveletre van szükség.
cikkszám	itemId	integer	Az űrlaphoz társított üzenetsorelem azonosítója, amely az emberi interakciót egy adott munkaelemhez kapcsolja.
workflowTaskId	workflowTaskId	integer	Az űrlapot létrehozó C2 feladat.

Válaszok

Name	Elérési út	Típus	Description
id	id	integer	id

Űrlapok lekérése

Műveletazonosító:: GetForms

Lekéri a robotok interakciós űrlapjainak listáját opcionális szűréssel. Ezzel a művelettal lekérdezheti a függőben lévő emberi kérelmeket, ellenőrizheti az állapotukat, vagy megkeresheti az adott felhasználókhoz rendelt űrlapokat.

Paraméterek

Name	Kulcs	Típus	Description
Kihagyás	skip	integer	A lapozáshoz kihagyandó rekordok száma.
Vesz	take	integer	A visszaadni kívánt rekordok száma.
Határidő előtt	deadlineBefore	date-time	Űrlapok szűrése határidővel ezen dátum/idő előtt (ISO 8601).
Határidő után	deadlineAfter	date-time	Űrlapok szűrése határidővel a dátum/idő után (ISO 8601).
Befejezett belefoglalás	includeCompleted	boolean	A kitöltött űrlapok belefoglalása az eredményekbe.
Felhasználóazonosító szerint igényelt	claimedByUserId	integer	Adott felhasználói azonosító által igényelt űrlapok szűrése.
Munkafolyamat-tevékenységazonosító alapján létrehozva	createdByWorkflowTaskId	integer	Egy adott munkafolyamat-feladatazonosító által létrehozott űrlapok szűrése.

Válaszok

Name	Elérési út	Típus	Description
		array of object
id	id	integer	id
divisionId	divisionId		divisionId
munkamenet-azonosító	sessionId		munkamenet-azonosító
queueItemId	queueItemId		queueItemId
claimedByUserId	claimedByUserId		claimedByUserId
claimedOn	claimedOn	string	claimedOn
createdByWorkflowTaskId	createdByWorkflowTaskId		createdByWorkflowTaskId
createdByUserId	createdByUserId		createdByUserId
createdOn	createdOn	string	createdOn
határidő	deadline	string	határidő
Befejezett	completed	string	Befejezett
nem késleltetett	undeferred	boolean	nem késleltetett

Triggerek

Folyamat indítása munkamenet-kérelemből időtúllépés nélkül	Lekérdezi az új C2-munkameneteket, és aktiválja a folyamatot, amikor létrejön egy munkamenet a kijelölt tevékenységhez. Ezt az eseményindítót akkor használja, ha az automatizáláshoz nincs szükség időtúllépési korlátozásra. A folyamat megkapja a munkamenet részleteit, beleértve a C2 által átadott bemeneti értékeket is.
Folyamat indítása munkamenet-kérelemből időtúllépéssel	Lekérdezi az új C2-munkameneteket, és időtúllépési korlátozással aktiválja a folyamatot. Ezt az eseményindítót akkor használja, ha az automatizálásnak egy adott időkereten belül kell befejeződnie. Ha a munkamenet túllépi az időtúllépést, a C2 az időtúllépési szabályzatának megfelelően fogja kezelni.

Folyamat indítása munkamenet-kérelemből időtúllépés nélkül

Műveletazonosító:: StartFlowWithoutTimeout

Lekérdezi az új C2-munkameneteket, és aktiválja a folyamatot, amikor létrejön egy munkamenet a kijelölt tevékenységhez. Ezt az eseményindítót akkor használja, ha az automatizáláshoz nincs szükség időtúllépési korlátozásra. A folyamat megkapja a munkamenet részleteit, beleértve a C2 által átadott bemeneti értékeket is.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Tevékenységazonosító	taskId	True	integer	Válassza ki azt a C2 feladatot, amely elindítja ezt a folyamatot. Amikor új munkamenet jön létre ehhez a feladathoz a C2-ben, a folyamat automatikusan elindul időtúllépés kényszerítése nélkül.

Válaszok

Name	Elérési út	Típus	Description
sessions	sessions	array of object	A C2 által időkorlát nélkül aktivált munkamenetek halmaza
munkamenet-azonosító	sessions.sessionId	integer	munkamenet-azonosító
workflowTaskId	sessions.workflowTaskId	integer	workflowTaskId
workflowName	sessions.workflowName	string	workflowName
feladat neve	sessions.taskName	string	feladat neve
létrehozva	sessions.created	string	létrehozva
processInputValues	sessions.processInputValues	object	processInputValues

Folyamat indítása munkamenet-kérelemből időtúllépéssel

Műveletazonosító:: StartFlowWithTimeout

Lekérdezi az új C2-munkameneteket, és időtúllépési korlátozással aktiválja a folyamatot. Ezt az eseményindítót akkor használja, ha az automatizálásnak egy adott időkereten belül kell befejeződnie. Ha a munkamenet túllépi az időtúllépést, a C2 az időtúllépési szabályzatának megfelelően fogja kezelni.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Tevékenységazonosító	taskId	True	integer	Válassza ki azt a C2 feladatot, amely elindítja ezt a folyamatot. Amikor létrehoz egy munkamenetet ehhez a tevékenységhez, a folyamat a megadott időtúllépés kényszerítéssel kezdődik.
Másodpercek időtúllépése	timeout	True	integer	A munkamenet futásának maximális időtartama másodpercben, mielőtt a C2 időkorlátként jelöli meg.

Válaszok

Name	Elérési út	Típus	Description
sessions	sessions	array of object	A C2 által aktivált munkamenetek készlete időtúllépéssel
munkamenet-azonosító	sessions.sessionId	integer	munkamenet-azonosító
workflowTaskId	sessions.workflowTaskId	integer	workflowTaskId
workflowName	sessions.workflowName	string	workflowName
feladat neve	sessions.taskName	string	feladat neve
létrehozva	sessions.created	string	létrehozva
processInputValues	sessions.processInputValues	object	processInputValues