C TVÅ (förhandsversion)
C TWO är en agentisk hanteringsplattform som samordnar automatiseringsarbetsflöden, hanterar interaktion mellan människa och robot och bearbetar arbetsobjekt via universella köer. Använd den här anslutningsappen för att utlösa flöden från C TWO-sessioner, hantera sessionslivscykel, skapa och bearbeta köobjekt och aktivera interaktion mellan människor i loopen med digitala arbetare.
Den här anslutningsappen är tillgänglig i följande produkter och regioner:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alla Power Automate regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Logiska appar | Standard | Alla Logic Apps-regioner utom följande: - Azure Government regioner - Azure kinaregioner - US Department of Defense (DoD) |
| Power Apps | Premium | Alla Power Apps regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alla Power Automate regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Namn | C TWO-stöd |
| URL | https://ctwo.com/ |
| E-postmeddelande | customersuccess@ctwo.com |
| Metadata för anslutningsprogram | |
|---|---|
| Publisher | C TVÅ |
| Webbplats | https://ctwo.com/ |
| Sekretesspolicy | https://ctwo.com/privacy-policy/ |
| Kategorier | Business Intelligence; Artificiell intelligens |
C TVÅ
C TWO är en agentisk hanteringsplattform som samordnar automatiseringsarbetsflöden, hanterar interaktion mellan människa och robot och bearbetar arbetsobjekt via universella köer. Med den här anslutningsappen kan Power Automate, Power Apps, Azure Logic Apps och Copilot Studio utlösa och utlösas av C TWO-sessioner, hantera sessionslivscykeln, skapa och bearbeta universella köobjekt och aktivera interaktion mellan människor i loopen med digitala arbetare.
C TWO ligger ovanför din automationsegendom som ett enda orkestrerings-, styrnings- och övervakningslager: oavsett vad som skapar eller kör arbetet lägger C TWO till SLA-spårning, återförsök och självåterställning, telemetri för livesessioner och en fullständig granskningslogg.
Förutsättningar
Innan du skapar en anslutning behöver du:
- En aktiv C TWO-klient – antingen C TWO Cloud (värdbaserad) eller en lokal C TWO-server som kan nås via HTTPS.
- En token för tjänstkonto eller en personlig åtkomsttoken som utfärdats av C TWO-administratören (se Hämta autentiseringsuppgifter).
- Om C TWO finns lokalt måste servern kunna nås från Power Platform via HTTPS (brandvägg som tillåter Microsoft Power Automate utgående IP-intervall – Azure servicetaggar
AzureConnectors.<region>ochPowerPlatformPlexför din Power Platform Geo). - En Power Platform-miljö med behörigheter för anpassad anslutningsapp och en licensnivå som stöder anpassade anslutningsappar (Power Automate Premium eller motsvarande).
Skapa en anslutning
När du skapar en anslutning anger du tre värden, alla från din egen C TWO-miljö:
-
C TWO-värd – endast C TWO-serverns värdnamn (inget schema, inget avslutande snedstreck), t.ex.
connect24.ctwo.cloudeller en lokal värd med valfri port, till exempelctwo.contoso.com:8443. -
C TWO Base URL – bassökvägen för ditt C TWO-API, inklusive din division, som börjar med ett snedstreck och utan avslutande snedstreck, t.ex.
/DEFAULT/CTWO.Server/api. -
API Key – din token, angiven som
Bearer <your-token>. En token för tjänstkonto rekommenderas. en personlig åtkomsttoken fungerar också.
Tillsammans dirigerar värd- och bas-URL:en anslutningsappen till din egen C TWO-server (https://{Host}{Base URL}/…), så att varje kund ansluter till sin egen miljö – C TWO Cloud eller lokalt.
Hämta autentiseringsuppgifter
Autentisering använder en API-nyckel som skickas som en ägartoken i Authorization huvudet.
Token för tjänstkonto (rekommenderas för produktion)
- Logga in på din C TWO-instans.
- Gå till Appar och anslutningar → Microsoft Power Automate → Skapa tjänstkonto.
- Kopiera den genererade token omedelbart – den visas bara en gång.
Personlig åtkomsttoken (utveckling/testning)
- Öppna användarprofilen i C TWO.
- Gå till fliken API-token och generera en ny token.
- Kopiera den omedelbart – den visas bara en gång och ogiltigförklaras om användarkontot är inaktiverat.
Behandla båda tokentyperna som hemligheter – lagra dem endast i Power Platform-anslutningsautentiseringsuppgifterna, aldrig i flödesvariabler eller kod på klientsidan.
Åtgärder som stöds
- Utlösare – Starta ett flöde när C TWO skickar en session, med eller utan en framtvingad tidsgräns.
- Sessionshantering – Slutförande/fel i rapporten, skrivtypade sessionsloggar, justera tidsgränsen för sessionen och sök efter en korrekt stoppbegäran.
- Universal Queue – Skapa, lista, låsa, låsa upp, försöka igen och skjuta upp köobjekt; uppdatera objektdata och lägga till loggar på objektnivå. lägg till/ta bort taggar; hämta bifogade filer. skapa anpassade objekttillstånd; listköer.
- Human-in-the-loop – Skapa, tilldela, ta bort och slutföra strukturerade formulär för mänsklig hjälp och hämta/fråga dem.
Interna hjälpåtgärder fyller i dynamiska listrutor (uppgifts- och användarväljare) och anropas inte direkt.
Kända problem och begränsningar
- Rätt värd- och bas-URL krävs. Båda anges vid anslutningstiden och dirigerar anslutningsappen till C TWO-servern. Felaktiga eller oåtkomliga värden resulterar i anslutnings- eller begärandefel.
- API-nyckelformat. FÄLTET API-nyckel förväntar sig literalsträngen
Bearer <token>– om prefixet utelämnas resulterar detBeareri401 Unauthorized. - Tillhandahåller JSON-objektdata. Objektdatafält (
Create Queue Item,Set Queue Item Data) är JSON-objekt. I ett flöde anger du literal JSON medjson('…')uttrycket så att det skickas som ett objekt i stället för en sträng. - Svarstid för avsökningsutlösare. Utlösare avsöks i stället för push-överföring, så det finns en liten fördröjning (begränsas av utlösarens upprepning) mellan en session som skickas i C TWO och flödet startar.
- Formulärfälttyper. Vissa identifierarfält som returneras av formuläråtgärderna kan vara ett heltal, en sträng eller null beroende på formulärets tillstånd.
Vanliga fel och åtgärder
| Error | Sannolik orsak | Lösning |
|---|---|---|
401 Unauthorized |
API-nyckeln saknar prefixet Bearer , har upphört att gälla eller återkallats |
Ange autentiseringsuppgifterna igen som Bearer <token>; generera en ny tjänstkontotoken om den återkallas |
400 Bad request på Skapa köobjekt |
Ett obligatoriskt fält saknas (reference, queueItemState, itemKey) |
Fyll i alla tre obligatoriska fält |
| Utlösaren utlöses aldrig | Fel uppgift har valts eller så exponeras inte C TWO-aktiviteten för Power Automate | Bekräfta att aktiviteten visas i listrutan Aktivitets-ID och är konfigurerad som ett exponerat flöde i C TWO |
| Objektdata som lagras som en undantagen sträng | JSON som anges som text i stället för ett objekt |
json('…') Använd uttrycket (flöden) eller Raw Body (anslutningstest) så att det skickas som ett objekt |
FAQ
Kan jag använda den här anslutningsappen från Power Apps, Azure Logic Apps och Copilot Studio, inte bara Power Automate? Yes. Utlösarna är Power Automate specifika, men varje åtgärd kan anropas från någon av dessa plattformar när en anslutning har skapats.
Hanterar den här anslutningsappen licensiering? No. C TWO orkestrerar och styr körningen; kunder ansvarar för sina egna Microsoft licensiering.
Var kan jag få hjälp? Kontakta C TWO Customer Success på customersuccess@ctwo.com.
Skapa en anslutning
Anslutningsappen stöder följande autentiseringstyper:
| Standardinställning | Parametrar för att skapa anslutning. | Alla regioner | Går inte att dela |
Standard
Tillämpligt: Alla regioner
Parametrar för att skapa anslutning.
Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.
| Namn | Type | Description | Obligatoriskt |
|---|---|---|---|
| C TVÅ-värd | string | C TWO-serverns värdnamn är bara â€" inget schema, inget avslutande snedstreck. Till exempel connect24.ctwo.cloud eller en lokal värd med valfri port, till exempel ctwo.contoso.com:8443. | True |
| C TVÅ bas-URL | string | Bassökvägen för ditt C TWO-API, inklusive din division. Börja med ett snedstreck, inget avslutande snedstreck. Till exempel /DEFAULT/CTWO. Server/api. | True |
| API-nyckel | securestring | Din C TWO API-token, angiven som: Bearer <your-token>. En token för tjänstkonto rekommenderas. en personlig åtkomsttoken fungerar också. | True |
Åtgärder
| Ange köobjektdata |
Uppdaterar datainnehållet i ett köobjekt. Använd den här åtgärden för att ändra nyttolasten för ett arbetsobjekt under bearbetningen, till exempel för att lagra mellanliggande resultat. |
| Ange körningstillstånd för flöde till Slutfört |
Markerar en C TWO-session som slutförd, vilket signalerar att flödet har slutfört sitt arbete. Placera den här åtgärden i slutet av flödet för att rapportera tillbaka till C TWO att automatiseringen slutfördes utan fel. |
| Ange status för köobjekt |
Ändrar tillståndet för ett köobjekt (t.ex. från Väntar till Slutfört eller till ett anpassat tillstånd). Använd den här åtgärden för att främja objekt via arbetsflödespipelinen. |
| Ange tidsgräns för session |
Uppdaterar tidsgränsvärdet för en aktiv C TWO-session. Använd den här åtgärden för att utöka eller minska den tillåtna körningstiden för en pågående session när den ursprungliga tidsgränsen behöver justeras. |
| Avtilldela formulär |
Tar bort den aktuella användartilldelningen från ett robotinteraktionsformulär, vilket gör den tillgänglig för andra användare att göra anspråk på. |
| Bör sessionen stoppas |
Kontrollerar om C TWO har begärt ett graciöst (mjukt) stopp för den angivna sessionen. Använd den här åtgärden i loopar för att regelbundet kontrollera om sessionen ska avslutas tidigt, så att flödet kan rensa resurser innan det stoppas. |
| Det gick inte att ange körningstillstånd för flöde |
Markerar en C TWO-session som misslyckad, vilket signalerar att ett fel uppstod under flödeskörningen. Använd den här åtgärden i omfång för felhantering för att rapportera fel tillbaka till C TWO med information om vad som gick fel. |
| Fullständigt formulär |
Markerar ett formulär för robotinteraktion som slutfört, vilket signalerar att den mänskliga användaren har angett de begärda indata och att den digitala arbetaren kan återuppta bearbetningen. |
| Försök att köa igen |
Försök igen med ett specifikt köobjekt, ange dess data tillbaka till det ursprungliga värdet och skapa ett nytt försök. |
| Hämta bifogad köobjekt |
Hämtar en specifik filbilaga från ett köobjekt som base64-kodade data. Använd den här åtgärden för att ladda ned filer som har kopplats till arbetsobjekt under skapandet eller bearbetningen. |
| Hämta formulär |
Hämtar en lista över robotinteraktionsformulär med valfri filtrering. Använd den här åtgärden för att fråga väntande begäranden från människa i loopen, kontrollera deras status eller hitta formulär som tilldelats specifika användare. |
| Hämta formulär efter ID |
Hämtar ett specifikt robotinteraktionsformulär med dess unika identifierare. Använd den här åtgärden för att hämta information, fält och aktuell status för ett human-in-the-loop-formulär som skapades av en digital arbetare. |
| Hämta köer |
Hämtar universella köer baserat på filtervillkor. Använd den här åtgärden om du vill visa en lista över tillgängliga köer, kontrollera deras konfiguration eller leta upp köinformation. Den här åtgärden driver även dynamiska listrutor i andra åtgärder. |
| Hämta köobjekt |
Hämtar köobjekt baserat på angivna filtervillkor, till exempel tillstånd, taggar, datum och könamn. Använd den här åtgärden för att söka efter och övervaka arbetsobjekt i dina universella köer. |
| Lägg till logg i köobjekt |
Lägger till ett loggmeddelande i ett köobjekt för spårningsspårning och spårning. Använd den här åtgärden för att registrera bearbetningssteg, varningar eller fel mot ett specifikt arbetsobjekt. |
| Lägg till logg till session |
Skriver en loggpost till en C TWO-session. Använd den här åtgärden för att spåra förlopp, registrera beslut eller logga diagnostikinformation under flödeskörningen. Loggar visas på C TWO-plattformen för granskning och felsökning. |
| Lägga till taggar i köobjekt |
Lägger till en eller flera taggar i ett köobjekt för kategorisering och filtrering. Taggar hjälper till att organisera och söka efter arbetsobjekt i köer. |
| Lås köobjekt |
Låser ett köobjekt för att förhindra att andra arbetare bearbetar det samtidigt. Använd den här åtgärden innan du bearbetar ett arbetsobjekt för att säkerställa exklusiv åtkomst. |
| Lås upp köobjekt |
Låser upp ett tidigare låst köobjekt och returnerar det till dess tillgängliga tillstånd. Använd den här åtgärden när bearbetningen avbryts och objektet ska släppas för andra arbetare. |
| Skapa formulär |
Skapar ett nytt robotinteraktionsformulär som gör att en digital arbetare kan begära mänsklig hjälp. Formuläret presenteras för tilldelade användare på C TWO-plattformen, vilket möjliggör scenarier för människor i loopen där mänsklig expertis behövs för att hantera undantag eller komplexa beslut. |
| Skapa köobjekt |
Skapar ett nytt arbetsobjekt i en angiven universell kö. Använd den här åtgärden för att lägga till objekt för bearbetning av digitala arbetare, inklusive datanyttolaster, taggar och valfria filbilagor. |
| Skapa köobjekttillstånd |
Skapar ett nytt anpassat tillstånd i en specifik kö. Med anpassade tillstånd kan du definiera arbetsflödessteg utöver standardtillstånden (Väntande, Slutförd, Refererad) och anpassa kön till din affärsprocess. |
| Skjut upp köobjekt |
Defers ett köobjekt så att det inte bearbetas förrän det angivna datumet/tiden. Använd den här åtgärden när ett objekt inte kan bearbetas nu, men bör göras ett nytt försök senare. |
| Ta bort taggar från köobjekt |
Tar bort en eller flera taggar från ett köobjekt. Använd den här åtgärden för att uppdatera kategoriseringen av arbetsobjekt under bearbetningen. |
| Tilldela formulär |
Tilldelar ett robotinteraktionsformulär till en specifik användare, vilket gör dem ansvariga för att granska och slutföra begäran från människan i loopen. |
Ange köobjektdata
Uppdaterar datainnehållet i ett köobjekt. Använd den här åtgärden för att ändra nyttolasten för ett arbetsobjekt under bearbetningen, till exempel för att lagra mellanliggande resultat.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Köobjekt-ID
|
queueItemId | True | string |
ID:t för köobjektet som ska uppdateras. |
|
data
|
data | object |
Den nya datanyttolasten för köobjektet som ett JSON-objekt. |
|
|
Skapades
|
created | date-time |
Tidsstämpeln för att skapa dessa data. |
Ange körningstillstånd för flöde till Slutfört
Markerar en C TWO-session som slutförd, vilket signalerar att flödet har slutfört sitt arbete. Placera den här åtgärden i slutet av flödet för att rapportera tillbaka till C TWO att automatiseringen slutfördes utan fel.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Sessions-ID
|
sessionId | True | string |
C TWO-sessions-ID:t som ska markeras som slutfört. Standardvärdet är sessions-ID:t från utlösarens utdata. |
Returer
- response
- object
Ange status för köobjekt
Ändrar tillståndet för ett köobjekt (t.ex. från Väntar till Slutfört eller till ett anpassat tillstånd). Använd den här åtgärden för att främja objekt via arbetsflödespipelinen.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Köobjekt-ID
|
queueItemId | True | string |
ID:t för köobjektet som ska uppdateras. |
|
Tillstånd
|
state | string |
Det nya tillståndet för köobjektet. |
Ange tidsgräns för session
Uppdaterar tidsgränsvärdet för en aktiv C TWO-session. Använd den här åtgärden för att utöka eller minska den tillåtna körningstiden för en pågående session när den ursprungliga tidsgränsen behöver justeras.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Sessions-ID
|
sessionId | True | string |
C TWO-sessions-ID:t som tidsgränsen ska uppdateras för. Standardvärdet är sessions-ID:t från utlösarens utdata. |
|
Tidsavbrott
|
timeout | True | integer |
Det nya timeout-värdet i sekunder som ska tillämpas på sessionen. |
Returer
- response
- string
Avtilldela formulär
Tar bort den aktuella användartilldelningen från ett robotinteraktionsformulär, vilket gör den tillgänglig för andra användare att göra anspråk på.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Formulär-ID
|
formId | True | string |
Mänskligt i loopform-ID för att avtilldela. |
Bör sessionen stoppas
Kontrollerar om C TWO har begärt ett graciöst (mjukt) stopp för den angivna sessionen. Använd den här åtgärden i loopar för att regelbundet kontrollera om sessionen ska avslutas tidigt, så att flödet kan rensa resurser innan det stoppas.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Sessions-ID
|
sessionId | True | string |
C TWO-sessions-ID:t för att söka efter en stoppbegäran. Standardvärdet är sessions-ID:t från utlösarens utdata. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
isStopRequested
|
isStopRequested | boolean |
isStopRequested |
Det gick inte att ange körningstillstånd för flöde
Markerar en C TWO-session som misslyckad, vilket signalerar att ett fel uppstod under flödeskörningen. Använd den här åtgärden i omfång för felhantering för att rapportera fel tillbaka till C TWO med information om vad som gick fel.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Sessions-ID
|
sessionId | True | string |
C TWO-sessions-ID:t som ska markeras som misslyckat. Standardvärdet är sessions-ID:t från utlösarens utdata. |
|
details
|
details | True | string |
En beskrivning av felet eller undantaget som gjorde att sessionen misslyckades. |
Fullständigt formulär
Markerar ett formulär för robotinteraktion som slutfört, vilket signalerar att den mänskliga användaren har angett de begärda indata och att den digitala arbetaren kan återuppta bearbetningen.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Formulär-ID
|
formId | True | string |
Mänskligt i loopform-ID för att markera som slutfört. |
|
completedAt
|
completedAt | date-time |
Tidsstämpeln när formuläret slutfördes (ISO 8601-format). |
Försök att köa igen
Försök igen med ett specifikt köobjekt, ange dess data tillbaka till det ursprungliga värdet och skapa ett nytt försök.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Köobjekt-ID
|
queueItemId | True | integer |
Specifikt köobjekt-ID som ska försökas igen. |
|
Tillstånds-ID
|
stateId | integer |
Specifikt väntande tillstånds-ID för köobjekt som ska anges. prioriterar över tillståndsparametern. |
|
|
Tillstånd
|
state | string |
Specifikt namn på väntande köobjekt som ska anges. |
|
|
Uppgifts-ID för arbetsflöde
|
workflowTaskId | integer |
WorkflowTask-identifierare. |
|
|
App-ID
|
appId | integer |
Appidentifierare. |
Hämta bifogad köobjekt
Hämtar en specifik filbilaga från ett köobjekt som base64-kodade data. Använd den här åtgärden för att ladda ned filer som har kopplats till arbetsobjekt under skapandet eller bearbetningen.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Köobjekt-ID
|
queueItemId | True | string |
ID:t för köobjektet som innehåller den bifogade filen. |
|
ID för bifogad fil
|
attachmentId | True | string |
ID:t för den bifogade filen som ska hämtas. |
|
Filnamn
|
filename | string |
Filnamnet för den bifogade filen. |
Returer
- response
- string
Hämta formulär
Hämtar en lista över robotinteraktionsformulär med valfri filtrering. Använd den här åtgärden för att fråga väntande begäranden från människa i loopen, kontrollera deras status eller hitta formulär som tilldelats specifika användare.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Hoppa över
|
skip | integer |
Antal poster att hoppa över för sidnumrering. |
|
|
Ta
|
take | integer |
Antal poster som ska returneras. |
|
|
Tidsgräns före
|
deadlineBefore | date-time |
Filtrera formulär med en tidsgräns före detta datum/tid (ISO 8601). |
|
|
Tidsgräns efter
|
deadlineAfter | date-time |
Filtrera formulär med en tidsgräns efter detta datum/tid (ISO 8601). |
|
|
Inkludera slutförd
|
includeCompleted | boolean |
Om du vill inkludera ifyllda formulär i resultatet. |
|
|
Begärd av användar-ID
|
claimedByUserId | integer |
Filtrera formulär som påstås av ett specifikt användar-ID. |
|
|
Skapad av arbetsflödets aktivitets-ID
|
createdByWorkflowTaskId | integer |
Filtrera formulär som skapats av ett specifikt arbetsflödesaktivitets-ID. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
|
array of object | ||
|
id
|
id | integer |
id |
|
divisionId
|
divisionId |
divisionId |
|
|
sessionId
|
sessionId |
sessionId |
|
|
queueItemId
|
queueItemId |
queueItemId |
|
|
claimedByUserId
|
claimedByUserId |
claimedByUserId |
|
|
claimedOn
|
claimedOn | string |
claimedOn |
|
createdByWorkflowTaskId
|
createdByWorkflowTaskId |
createdByWorkflowTaskId |
|
|
createdByUserId
|
createdByUserId |
createdByUserId |
|
|
createdOn
|
createdOn | string |
createdOn |
|
tidsfrist
|
deadline | string |
tidsfrist |
|
slutförd
|
completed | string |
slutförd |
|
undeferred
|
undeferred | boolean |
undeferred |
Hämta formulär efter ID
Hämtar ett specifikt robotinteraktionsformulär med dess unika identifierare. Använd den här åtgärden för att hämta information, fält och aktuell status för ett human-in-the-loop-formulär som skapades av en digital arbetare.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Formulär-ID
|
formId | True | string |
Mänskligt i loopform-ID för att få information. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
id
|
id | integer |
id |
|
divisionId
|
divisionId |
divisionId |
|
|
sessionId
|
sessionId |
sessionId |
|
|
queueItemId
|
queueItemId |
queueItemId |
|
|
claimedByUserId
|
claimedByUserId |
claimedByUserId |
|
|
claimedOn
|
claimedOn | string |
claimedOn |
|
createdByWorkflowTaskId
|
createdByWorkflowTaskId |
createdByWorkflowTaskId |
|
|
createdByUserId
|
createdByUserId |
createdByUserId |
|
|
createdOn
|
createdOn | string |
createdOn |
|
tidsfrist
|
deadline | string |
tidsfrist |
|
slutförd
|
completed | string |
slutförd |
|
rubrik
|
title | string |
rubrik |
|
Intro
|
intro | string |
introduktion |
|
Fält
|
fields | string |
Fält |
Hämta köer
Hämtar universella köer baserat på filtervillkor. Använd den här åtgärden om du vill visa en lista över tillgängliga köer, kontrollera deras konfiguration eller leta upp köinformation. Den här åtgärden driver även dynamiska listrutor i andra åtgärder.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Kö-ID
|
id | string |
Filtrera efter kö-ID. |
|
|
Köreferens
|
reference | string |
Filtrera efter köreferens. |
|
|
Kö namn
|
name | string |
Filtrera efter könamn. |
|
|
Tillståndsnamn
|
stateName | string |
Filtrera efter tillståndsnamn. |
|
|
Deleted
|
deleted | boolean |
Filtrera efter borttagen status. |
|
|
Hoppa över
|
skip | integer |
Antal poster att hoppa över för sidnumrering. |
|
|
Ta
|
take | integer |
Antal poster som ska returneras. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
|
array of object | ||
|
id
|
id | integer |
Den unika identifieraren för kön. |
|
borttagen
|
deleted | boolean |
Om kön tas bort. |
|
Namn
|
name | string |
Namnet på kön. |
|
description
|
description | string |
Beskrivningen av kön. |
|
synlig
|
visible | boolean |
Om kön är synlig. |
|
includeInReports
|
includeInReports | boolean |
Om du vill inkludera i rapporter. |
|
skapad
|
created | string |
Skapandetidsstämpeln. |
|
uppdaterad
|
updated | string |
Tidsstämpeln för senaste uppdatering. |
|
deletedTime
|
deletedTime | string |
Tidsstämpeln för borttagning. |
|
divisionId
|
divisionId | integer |
Divisionsidentifieraren. |
|
type
|
type | integer |
Kötypen. |
|
hänvisning
|
reference | string |
Köreferensen. |
|
Stater
|
states | array of object |
Tillstånden som är tillgängliga i den här kön. |
|
id
|
states.id | integer |
Tillståndsidentifieraren. |
|
Namn
|
states.name | string |
Tillståndsnamnet. |
|
description
|
states.description | string |
Tillståndsbeskrivningen. |
|
Tagfilter
|
states.tagfilter | string |
Taggfiltret för det här tillståndet. |
|
state
|
states.state | integer |
Tillståndstypen. |
|
timeSavedPerItem
|
states.timeSavedPerItem | integer |
Tid som sparats per objekt. |
|
includeInReports
|
states.includeInReports | boolean |
Om du vill inkludera i rapporter. |
|
responseTimeCalculationBasis
|
states.responseTimeCalculationBasis | integer |
Beräkningsbas för svarstid. |
Hämta köobjekt
Hämtar köobjekt baserat på angivna filtervillkor, till exempel tillstånd, taggar, datum och könamn. Använd den här åtgärden för att söka efter och övervaka arbetsobjekt i dina universella köer.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Objektnyckel
|
itemKey | string |
Filtrera efter objektnyckel. |
|
|
Attempts
|
attempts | integer |
Filtrera efter antal försök. |
|
|
Uppskjuten före
|
deferredBefore | date-time |
Filtrera objekt som skjutits upp före det här datumet. |
|
|
Uppskjuten efter
|
deferredAfter | date-time |
Filtrera objekt som skjutits upp efter det här datumet. |
|
|
Skapades före
|
createdBefore | date-time |
Filtrera objekt som skapats före det här datumet. |
|
|
Skapad efter
|
createdAfter | date-time |
Filtrera objekt som skapats efter det här datumet. |
|
|
Avslutades före
|
concludedBefore | date-time |
Filtrera objekt som har slutförts före det här datumet. |
|
|
Avslutad efter
|
concludedAfter | date-time |
Filterobjekt som har slutförts efter det här datumet. |
|
|
Tillstånd som angetts före
|
stateEnteredTimeBefore | date-time |
Filtrera objekt som har angetts som tillstånd före den här tiden. |
|
|
Tillstånd som angetts efter
|
stateEnteredTimeAfter | date-time |
Filtrera objekt som har angetts efter den här tiden. |
|
|
States
|
states | string |
Filtrera efter köobjekttillstånd. |
|
|
Tillstånds-ID för köobjekt
|
queueItemStateIds | integer |
Filtrera efter tillstånds-ID för köobjekt. |
|
|
Namn på köobjekttillstånd
|
queueItemStateNames | string |
Filtrera efter köobjektets tillståndsnamn. |
|
|
Tags
|
tags | string |
Filtrera efter taggar (kommaavgränsade). |
|
|
Kö-ID:t
|
queueIds | integer |
Filtrera efter kö-ID:t. |
|
|
Könamn
|
queueNames | True | string |
Filtrera efter könamn (krävs). |
|
References
|
references | string |
Filtrera efter köreferenser. |
|
|
Inkludera objektdata
|
includeItemData | boolean |
Om objektdata ska tas med som svar. |
|
|
Hoppa över
|
skip | integer |
Antal poster att hoppa över för sidnumrering. |
|
|
Ta
|
take | integer |
Antal poster som ska returneras. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
|
array of object | ||
|
id
|
id | integer |
Den unika identifieraren för köobjektet. |
|
itemKey
|
itemKey | string |
Den unika nyckeln för köobjektet. |
|
Försök
|
attempts | integer |
Antalet bearbetningsförsök. |
|
queueId
|
queueId | integer |
Identifieraren för den överordnade kön. |
|
id
|
state.id | integer |
Tillståndsidentifieraren. |
|
Namn
|
state.name | string |
Namnet på tillståndet. |
|
state
|
state.state | string |
Tillståndsvärdet. |
|
tags
|
tags | array of string |
Taggarna som är associerade med köobjektet. |
|
skapad
|
created | string |
Skapandetidsstämpeln. |
|
createdByVendorSessionId
|
createdByVendorSessionId | integer |
Sessions-ID:t som skapade det här objektet. |
|
avslutades
|
concluded | string |
Tidsstämpeln för slutsats. |
|
Uppskjuten
|
deferred | string |
Den uppskjutna tidsstämpeln. |
|
test
|
test | boolean |
Om det här är ett testobjekt. |
|
låst
|
locked | boolean |
Om objektet är låst. |
Lägg till logg i köobjekt
Lägger till ett loggmeddelande i ett köobjekt för spårningsspårning och spårning. Använd den här åtgärden för att registrera bearbetningssteg, varningar eller fel mot ett specifikt arbetsobjekt.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Köobjekt-ID
|
queueItemId | True | string |
ID:t för köobjektet som du vill logga in på. |
|
Loggningsnivå
|
level | string |
Allvarlighetsgraden för loggposten. |
|
|
Message
|
message | string |
Loggmeddelandets innehåll. |
Lägg till logg till session
Skriver en loggpost till en C TWO-session. Använd den här åtgärden för att spåra förlopp, registrera beslut eller logga diagnostikinformation under flödeskörningen. Loggar visas på C TWO-plattformen för granskning och felsökning.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Sessions-ID
|
sessionId | True | string |
C TWO-sessions-ID:t där loggposten registreras. Standardvärdet är sessions-ID:t från utlösarens utdata. |
|
Nivå
|
level | True | string |
Allvarlighetsgraden för loggposten. |
|
message
|
message | True | string |
Loggmeddelandeinnehållet som ska registreras. |
Lägga till taggar i köobjekt
Lägger till en eller flera taggar i ett köobjekt för kategorisering och filtrering. Taggar hjälper till att organisera och söka efter arbetsobjekt i köer.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Köobjekt-ID
|
queueItemId | True | string |
ID:t för köobjektet som du vill lägga till taggar i. |
|
Tags
|
tags | string |
Kommaavgränsad lista över taggar som ska läggas till. |
Lås köobjekt
Låser ett köobjekt för att förhindra att andra arbetare bearbetar det samtidigt. Använd den här åtgärden innan du bearbetar ett arbetsobjekt för att säkerställa exklusiv åtkomst.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Köobjekt-ID
|
queueItemId | string |
ID:t för köobjektet som ska låsas. Om det utelämnas låses nästa tillgängliga objekt som matchar filtret. |
|
|
Kö namn
|
reference | string |
Köreferensen för att låsa ett objekt från. |
|
|
Tillstånds-ID
|
stateId | string |
Tillstånds-ID för att filtrera objekt. |
|
|
Tillståndsnamn
|
stateName | string |
Tillståndsnamnet som objekt ska filtreras efter. |
|
|
Sessions-ID
|
sessionId | string |
Sessions-ID för det här låset. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
id
|
id | integer |
Den unika identifieraren för det låsta objektet. |
|
itemKey
|
itemKey | string |
Den unika nyckeln för det låsta objektet. |
|
Försök
|
attempts | integer |
Antalet bearbetningsförsök. |
|
queueId
|
queueId | integer |
Identifieraren för den överordnade kön. |
|
id
|
state.id | integer |
Tillståndsidentifieraren. |
|
Namn
|
state.name | string |
Namnet på tillståndet. |
|
state
|
state.state | string |
Tillståndsvärdet. |
|
tags
|
tags | array of string |
Taggarna som är associerade med köobjektet. |
|
skapad
|
created | string |
Skapandetidsstämpeln. |
|
createdByVendorSessionId
|
createdByVendorSessionId | integer |
Sessions-ID:t som skapade det här objektet. |
|
Slutsatsen
|
concluded | string |
Tidsstämpeln för slutsats. |
|
Uppskjuten
|
deferred | string |
Den uppskjutna tidsstämpeln. |
|
test
|
test | boolean |
Om det här är ett testobjekt. |
|
låst
|
locked | boolean |
Om objektet är låst. |
Lås upp köobjekt
Låser upp ett tidigare låst köobjekt och returnerar det till dess tillgängliga tillstånd. Använd den här åtgärden när bearbetningen avbryts och objektet ska släppas för andra arbetare.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Köobjekt-ID
|
queueItemId | True | string |
ID:t för köobjektet som ska låsas upp. |
Skapa formulär
Skapar ett nytt robotinteraktionsformulär som gör att en digital arbetare kan begära mänsklig hjälp. Formuläret presenteras för tilldelade användare på C TWO-plattformen, vilket möjliggör scenarier för människor i loopen där mänsklig expertis behövs för att hantera undantag eller komplexa beslut.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Fält
|
fields | string |
JSON-formaterad sträng som definierar de formulärfält som den mänskliga användaren behöver fylla i. |
|
|
rubrik
|
title | string |
Rubriken visas för den mänskliga användaren när de öppnar formuläret. |
|
|
tidsfrist
|
deadline | date-time |
Den tidsfrist då människan måste svara på formuläret (ISO 8601-format). |
|
|
Intro
|
intro | string |
Inledande text som visas för den mänskliga användaren som förklarar vilken åtgärd som behövs. |
|
|
itemId
|
itemId | integer |
Köobjektets ID som är associerat med det här formuläret och som länkar den mänskliga interaktionen till ett specifikt arbetsobjekt. |
|
|
workflowTaskId
|
workflowTaskId | integer |
C TWO-uppgiften som skapade formuläret. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
id
|
id | integer |
id |
Skapa köobjekt
Skapar ett nytt arbetsobjekt i en angiven universell kö. Använd den här åtgärden för att lägga till objekt för bearbetning av digitala arbetare, inklusive datanyttolaster, taggar och valfria filbilagor.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Objektnyckel
|
itemKey | True | string |
En unik affärsnyckel för att identifiera det här köobjektet (t.ex. fakturanummer, ärende-ID). |
|
Köobjekttillstånd
|
queueItemState | True | string |
Det ursprungliga tillståndet för köobjektet (t.ex. Väntar). |
|
Köreferens
|
reference | True | string |
Köreferensen där objektet ska skapas. |
|
Uppskjuten till
|
deferredUntil | date-time |
Skjut upp bearbetningen tills detta datum/tid (ISO 8601-format). |
|
|
Objektdata
|
itemData | object |
Datanyttolasten för köobjektet i JSON-format. |
|
|
Tags
|
tags | string |
Taggar för köobjektet (kommaavgränsade). |
|
|
fileName
|
fileName | string |
Namnet på den bifogade filen. |
|
|
fileData
|
fileData | string |
Base64-kodade fildata. |
|
|
Sessions-ID
|
sessionId | string |
Sessions-ID:t som är associerat med det här objektet. |
|
|
Enhet
|
device | string |
Enheten som skapade det här objektet. |
|
|
User
|
user | string |
Användaren som skapade det här objektet. |
|
|
Automation-provider
|
automationProvider | string |
Automation-providern för det här objektet. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
id
|
id | integer |
id |
|
itemKey
|
itemKey | string |
itemKey |
|
Försök
|
attempts | integer |
Försök |
|
queueId
|
queueId | integer |
queueId |
|
id
|
state.id | integer |
id |
|
Namn
|
state.name | string |
Namn |
|
state
|
state.state | string |
state |
|
tags
|
tags | array of string |
tags |
|
skapad
|
created | string |
skapad |
|
createdByVendorSessionId
|
createdByVendorSessionId | integer |
createdByVendorSessionId |
|
Slutsatsen
|
concluded | string |
Slutsatsen |
|
Uppskjuten
|
deferred | string |
uppskjuten |
|
test
|
test | boolean |
test |
|
låst
|
locked | boolean |
låst |
Skapa köobjekttillstånd
Skapar ett nytt anpassat tillstånd i en specifik kö. Med anpassade tillstånd kan du definiera arbetsflödessteg utöver standardtillstånden (Väntande, Slutförd, Refererad) och anpassa kön till din affärsprocess.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Namn
|
name | string |
Namnet på det nya tillståndet. |
|
|
Beräkning av svarstid
|
responseTimeCalculationBasis | True | string |
Avgör hur svarstidens serviceavtal beräknas för objekt som anger det här tillståndet. |
|
Tillståndstyp
|
state | True | string |
Typ av tillstånd (Väntar, Slutförd eller Refererad). |
|
Kö-ID
|
queueId | True | integer |
ID:t för kön där det här tillståndet ska skapas. |
|
Description
|
description | string |
En beskrivning av vad det här tillståndet representerar i arbetsflödet. |
|
|
Sparad tid per objekt
|
timeSavedPerItem | integer |
Tid som sparats per objekt i det här tillståndet (sekunder), som används för ROI-rapportering. |
|
|
Värde genererat per objekt
|
valueGeneratedPerItem | integer |
Värde som genereras per objekt i det här tillståndet, som används för ROI-rapportering. |
|
|
Inkludera i rapporter
|
includeInReports | boolean |
Om det här tillståndet ska inkluderas i analys och rapporter. |
Skjut upp köobjekt
Defers ett köobjekt så att det inte bearbetas förrän det angivna datumet/tiden. Använd den här åtgärden när ett objekt inte kan bearbetas nu, men bör göras ett nytt försök senare.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Köobjekt-ID
|
queueItemId | True | string |
ID:t för köobjektet som ska skjutas upp. |
|
Uppskjuten till
|
deferredUntil | date-time |
Datum/tid att skjuta upp till (ISO 8601-format). |
Returer
- response
- string
Ta bort taggar från köobjekt
Tar bort en eller flera taggar från ett köobjekt. Använd den här åtgärden för att uppdatera kategoriseringen av arbetsobjekt under bearbetningen.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Köobjekt-ID
|
queueItemId | True | string |
ID:t för köobjektet som taggarna ska tas bort från. |
|
Tags
|
tags | string |
Kommaavgränsad lista över taggar att ta bort. |
Tilldela formulär
Tilldelar ett robotinteraktionsformulär till en specifik användare, vilket gör dem ansvariga för att granska och slutföra begäran från människan i loopen.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Formulär-ID
|
formId | True | string |
Mänskligt i loopform-ID som ska tilldelas. |
|
userId
|
userId | integer |
ID:t för användaren som formuläret ska tilldelas till. |
Utlösare
| Starta flöde från sessionsbegäran med timeout |
Söker efter nya C TWO-sessioner och utlöser flödet med en tidsgränsbegränsning. Använd den här utlösaren när automatiseringen måste slutföras inom ett visst tidsfönster. Om sessionen överskrider tidsgränsen hanterar C TWO den enligt tidsgränsprincipen. |
| Starta flöde från sessionsbegäran utan tidsgräns |
Söker efter nya C TWO-sessioner och utlöser flödet när en session skapas för den valda aktiviteten. Använd den här utlösaren när automatiseringen inte kräver någon tidsgränsbegränsning. Flödet tar emot sessionsinformation inklusive indatavärden som skickas från C TWO. |
Starta flöde från sessionsbegäran med timeout
Söker efter nya C TWO-sessioner och utlöser flödet med en tidsgränsbegränsning. Använd den här utlösaren när automatiseringen måste slutföras inom ett visst tidsfönster. Om sessionen överskrider tidsgränsen hanterar C TWO den enligt tidsgränsprincipen.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Aktivitets-ID
|
taskId | True | integer |
Välj den C TWO-uppgift som ska utlösa det här flödet. När en session skapas för den här uppgiften börjar flödet med den angivna tidsgränsen framtvingad. |
|
Tidsgräns för sekunder
|
timeout | True | integer |
Maximal tid i sekunder som sessionen tillåts köras innan C TVÅ markerar den som tidsgräns. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
sessions
|
sessions | array of object |
Uppsättning sessioner som utlöses av C TWO med timeout |
|
sessionId
|
sessions.sessionId | integer |
sessionId |
|
workflowTaskId
|
sessions.workflowTaskId | integer |
workflowTaskId |
|
workflowName (arbetsflöde)
|
sessions.workflowName | string |
workflowName (arbetsflöde) |
|
uppgiftsnamn
|
sessions.taskName | string |
uppgiftsnamn |
|
skapad
|
sessions.created | string |
skapad |
|
processInputValues
|
sessions.processInputValues | object |
processInputValues |
Starta flöde från sessionsbegäran utan tidsgräns
Söker efter nya C TWO-sessioner och utlöser flödet när en session skapas för den valda aktiviteten. Använd den här utlösaren när automatiseringen inte kräver någon tidsgränsbegränsning. Flödet tar emot sessionsinformation inklusive indatavärden som skickas från C TWO.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Aktivitets-ID
|
taskId | True | integer |
Välj den C TWO-uppgift som ska utlösa det här flödet. När en ny session skapas för den här uppgiften i C TWO startas flödet automatiskt utan att tidsgränsen nås. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
sessions
|
sessions | array of object |
Uppsättning sessioner som utlöses av C TWO utan timeout |
|
sessionId
|
sessions.sessionId | integer |
sessionId |
|
workflowTaskId
|
sessions.workflowTaskId | integer |
workflowTaskId |
|
workflowName (arbetsflöde)
|
sessions.workflowName | string |
workflowName (arbetsflöde) |
|
uppgiftsnamn
|
sessions.taskName | string |
uppgiftsnamn |
|
skapad
|
sessions.created | string |
skapad |
|
processInputValues
|
sessions.processInputValues | object |
processInputValues |
Definitioner
string
Det här är den grundläggande datatypen "string".
object
Detta är typen 'objekt'.