C TWO (anteprima)

C TWO è una piattaforma di gestione agentic che orchestra i flussi di lavoro di automazione, gestisce le interazioni tra robot umani ed elabora gli elementi di lavoro tramite code universali. Usare questo connettore per attivare i flussi dalle sessioni C TWO, gestire il ciclo di vita della sessione, creare ed elaborare gli elementi della coda e abilitare le interazioni umane nel ciclo con i ruoli di lavoro digitali.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Service	Class	Regions
Copilot Studio	Premium	Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica	Standard	Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Premium	Tutte le aree di Power Apps , ad eccezione dei seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Premium	Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)

Contact
Nome	Supporto di C TWO
URL	https://ctwo.com/
Email	customersuccess@ctwo.com

Metadati del connettore
Editore	C TWO
Sito web	https://ctwo.com/
Informativa sulla privacy	https://ctwo.com/privacy-policy/
Categorie	Business intelligence; Intelligenza artificiale

C TWO

C TWO è una piattaforma di gestione agentic che orchestra i flussi di lavoro di automazione, gestisce le interazioni tra robot umani ed elabora gli elementi di lavoro tramite code universali. Questo connettore consente di attivare Power Automate, Power Apps, App per la logica di Azure e Copilot Studio trigger e di essere attivati da sessioni C TWO, gestire il ciclo di vita della sessione, creare ed elaborare elementi della coda universale e abilitare le interazioni umane nel ciclo con i ruoli di lavoro digitali.

C TWO si trova sopra il patrimonio di automazione come un singolo livello di orchestrazione, governance e monitoraggio: qualsiasi cosa crei o esegua il lavoro, C TWO aggiunge il rilevamento del contratto di servizio, i tentativi e la riparazione automatica, i dati di telemetria delle sessioni in tempo reale e un audit trail completo.

Prerequisites

Prima di creare una connessione, è necessario:

Un tenant C TWO attivo, C TWO Cloud (ospitato) o un server C TWO locale raggiungibile tramite HTTPS.
Un token dell'account del servizio o un token di accesso personale rilasciato dall'amministratore C TWO (vedere Recupero delle credenziali).
Se C TWO è ospitato in locale, il server deve essere raggiungibile da Power Platform tramite HTTPS (firewall che consente l'Power Automate intervalli IP in uscita di Microsoft, ovvero tag del servizio AzureConnectors.<region> Azure e PowerPlatformPlex per l'area geografica di Power Platform).
Un ambiente Power Platform con autorizzazioni connettore personalizzato e un livello di licenza che supporta connettori personalizzati (Power Automate Premium o equivalente).

Creazione di una connessione

Quando si crea una connessione si forniscono tre valori, tutti dal proprio ambiente C TWO:

Host C TWO : solo il nome host del server C TWO (nessuna combinazione, nessuna barra finale), ad esempio connect24.ctwo.cloudo un host locale con porta facoltativa, ctwo.contoso.com:8443ad esempio .
C TWO Base URL : il percorso di base dell'API C TWO, inclusa la divisione, a partire da una barra e senza barra finale, ad esempio /DEFAULT/CTWO.Server/api.
Chiave API : il token immesso come Bearer <your-token>. È consigliabile un token dell'account del servizio ; funziona anche un token di accesso personale .

Insieme, host e URL di base instradano il connettore al proprio server C TWO (https://{Host}{Base URL}/…), in modo che ogni cliente si connetta al proprio ambiente: C TWO Cloud o locale.

Recupero delle credenziali

L'autenticazione usa una chiave API inviata come token di connessione nell'intestazione Authorization .

Token dell'account del servizio (consigliato per la produzione)

Accedere all'istanza di C TWO.
Passare ad App e connessioni → Microsoft Power Automate → Creare un account del servizio.
Copiare immediatamente il token generato, che viene visualizzato una sola volta.

Token di accesso personale (sviluppo/test)

Aprire il profilo utente in C TWO.
Passare alla scheda Token API e generare un nuovo token.
Copiarlo immediatamente: viene visualizzato una sola volta e viene invalidato se l'account utente è disabilitato.

Considerare entrambi i tipi di token come segreti: archiviarli solo nelle credenziali di connessione di Power Platform, mai nelle variabili di flusso o nel codice lato client.

Operazioni supportate

Trigger: avviare un flusso quando C TWO invia una sessione, con o senza un timeout applicato.
Gestione delle sessioni: segnala completamento/errore, scrivere log di sessione tipizzato, regolare il timeout della sessione e verificare la presenza di una richiesta di arresto normale.
Coda universale : creare, elencare, bloccare, sbloccare, riprovare e rinviare gli elementi della coda; aggiornare i dati degli elementi e aggiungere log a livello di elemento; aggiungere/rimuovere tag; recuperare allegati; creare stati di elemento personalizzati; list queues.
Human-in-the-loop : creare, assegnare, annullare l'assegnazione e completare moduli strutturati di assistenza umana e recuperarli/eseguirne query.

Le operazioni helper interne popolano elenchi a discesa dinamici (selezione attività e utenti) e non vengono chiamati direttamente.

Problemi noti e limitazioni

Corretto l'host e l'URL di base necessari. Entrambi vengono immessi in fase di connessione e instradano il connettore al server C TWO. I valori non corretti o non raggiungibili generano errori di connessione o richiesta.
Formato della chiave API. Il campo Chiave API prevede la stringa Bearer <token> letterale, omettendo i risultati del Bearer prefisso in 401 Unauthorized.
Specifica dei dati degli elementi JSON. I campi item-data (Create Queue Item, Set Queue Item Data) sono oggetti JSON. In un flusso fornire codice JSON letterale con l'espressione json('…') in modo che venga inviato come oggetto anziché come stringa.
Latenza del trigger di polling. Attiva il polling anziché il push, quindi si verifica un piccolo ritardo (delimitato dalla ricorrenza del trigger) tra una sessione inviata in C TWO e l'avvio del flusso.
Tipi di campo modulo. Alcuni campi di identificatore restituiti dalle operazioni del modulo possono essere un numero intero, una stringa o null a seconda dello stato del modulo.

Errori e rimedi comuni

Error	Causa possibile	Rimedio
`401 Unauthorized`	Chiave API senza prefisso `Bearer` , scaduto o revocato	Immettere nuovamente le credenziali come `Bearer <token>`; generare un nuovo token dell'account del servizio se revocato
`400 Bad request` in Crea elemento coda	Campo obbligatorio mancante (`reference`, `queueItemState`, `itemKey`)	Popolare tutti e tre i campi obbligatori
Il trigger non viene mai attivato	Attività non corretta selezionata oppure l'attività C TWO non è esposta a Power Automate	Verificare che l'attività venga visualizzata nell'elenco a discesa ID attività ed è configurata come flusso esposto in C TWO
Dati degli elementi archiviati come stringa di escape	JSON fornito come testo invece di un oggetto	Usare l'espressione `json('…')` (flussi) o il corpo non elaborato (test del connettore) in modo che venga inviato come oggetto

FAQ

È possibile usare questo connettore da Power Apps, App per la logica di Azure e Copilot Studio, non solo Power Automate? Yes. I trigger sono Power Automate specifici, ma ogni azione può essere chiamata da una qualsiasi di queste piattaforme dopo la creazione di una connessione.

Questo connettore gestisce le licenze? No. C TWO orchestra e regola l'esecuzione; i clienti sono responsabili delle proprie licenze Microsoft.

Dove posso ottenere assistenza? Contattare C TWO Customer Success all'indirizzo customersuccess@ctwo.com.

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:


Predefinita	Parametri per la creazione della connessione.	Tutte le aree geografiche	Non condivisibile

Predefinito

Applicabile: tutte le aree

Parametri per la creazione della connessione.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome	Tipo	Description	Obbligatorio
C TWO Host	Stringa	Il nome host del server C TWO non è solo uno schema, nessuna barra finale. Ad esempio, connect24.ctwo.cloud o un host locale con porta facoltativa, ad esempio ctwo.contoso.com:8443.	True
C TWO Base URL	Stringa	Percorso di base dell'API C TWO, inclusa la divisione. Iniziare con una barra, senza barra finale. Ad esempio /DEFAULT/CTWO. Server/API.	True
Chiave API	securestring	Il token DELL'API C TWO, immesso come: Bearer <your-token>. È consigliabile un token dell'account del servizio; funziona anche un token di accesso personale.	True

Azioni

Aggiungere il log all'elemento della coda	Aggiunge un messaggio di log a un elemento della coda per la traccia di controllo e la tracciabilità. Usare questa azione per registrare i passaggi di elaborazione, gli avvisi o gli errori relativi a un elemento di lavoro specifico.
Aggiungere il log alla sessione	Scrive una voce di log in una sessione C TWO. Usare questa azione per tenere traccia dello stato di avanzamento, registrare le decisioni o registrare le informazioni di diagnostica durante l'esecuzione del flusso. I log sono visibili nella piattaforma C TWO per il controllo e la risoluzione dei problemi.
Aggiungere tag all'elemento della coda	Aggiunge uno o più tag a un elemento della coda per la categorizzazione e il filtro. I tag consentono di organizzare e cercare elementi di lavoro tra le code.
Assegna modulo	Assegna un modulo di interazione robot a un utente specifico, rendendolo responsabile della revisione e del completamento della richiesta umana nel ciclo.
Blocca elemento coda	Blocca un elemento della coda per impedire ad altri ruoli di lavoro di elaborarlo simultaneamente. Usare questa azione prima di elaborare un elemento di lavoro per garantire l'accesso esclusivo.
Crea modulo	Crea un nuovo modulo di interazione robot che consente a un lavoratore digitale di richiedere assistenza umana. Il modulo viene presentato agli utenti assegnati nella piattaforma C TWO, consentendo scenari umani nel ciclo in cui è necessaria l'esperienza umana per gestire eccezioni o decisioni complesse.
Creare lo stato dell'elemento della coda	Crea un nuovo stato personalizzato all'interno di una coda specifica. Gli stati personalizzati consentono di definire fasi del flusso di lavoro oltre gli stati predefiniti (in sospeso, completato, a cui si fa riferimento), adattando la coda al processo aziendale.
Creare un elemento della coda	Crea un nuovo elemento di lavoro in una coda universale specificata. Usare questa azione per aggiungere elementi per l'elaborazione da parte di ruoli di lavoro digitali, inclusi payload dei dati, tag e allegati di file facoltativi.
Dovrebbe arrestare la sessione	Verifica se C TWO ha richiesto un arresto normale (soft) per la sessione specificata. Usare questa azione all'interno di cicli per verificare periodicamente se la sessione deve terminare in anticipo, consentendo al flusso di pulire le risorse prima dell'arresto.
Imposta timeout sessione	Aggiorna il valore di timeout per una sessione C TWO attiva. Usare questa azione per estendere o ridurre il tempo di esecuzione consentito per una sessione in esecuzione quando il timeout originale richiede una regolazione.
Impostare i dati dell'elemento della coda	Aggiorna il contenuto dei dati di un elemento della coda. Usare questa azione per modificare il payload di un elemento di lavoro durante l'elaborazione, ad esempio per archiviare i risultati intermedi.
Impostare lo stato dell'elemento della coda	Modifica lo stato di un elemento della coda( ad esempio, da In sospeso a Completato o a uno stato personalizzato). Usare questa azione per far avanzare gli elementi tramite la pipeline del flusso di lavoro.
Impostare lo stato di esecuzione del flusso su Completato	Contrassegna una sessione C TWO come completata, segnalando che il flusso ha completato correttamente il lavoro. Posizionare questa azione alla fine del flusso per segnalare a C TWO che l'automazione è stata completata senza errori.
Impostare lo stato di esecuzione del flusso su Non riuscito	Contrassegna una sessione C TWO come non riuscita, segnalando che si è verificato un errore durante l'esecuzione del flusso. Usare questa azione negli ambiti di gestione degli errori per segnalare gli errori a C TWO con informazioni dettagliate su cosa si è verificato un errore.
Modulo completo	Contrassegna un modulo di interazione robot come completato, segnalando che l'utente umano ha fornito l'input richiesto e il lavoratore digitale può riprendere l'elaborazione.
Modulo di annullare l'assegnazione	Rimuove l'assegnazione dell'utente corrente da un modulo di interazione robot, rendendola disponibile per gli altri utenti a richiedere.
Nuovo elemento della coda di tentativi	Riprovare a un elemento della coda specifico, impostandone i dati sul valore originale e creando un nuovo tentativo.
Ottenere il modulo per ID	Recupera un modulo di interazione robot specifico in base al relativo identificatore univoco. Usare questa azione per recuperare i dettagli, i campi e lo stato corrente di un modulo umano nel ciclo creato da un ruolo di lavoro digitale.
Ottenere l'allegato dell'elemento della coda	Recupera un allegato di file specifico da un elemento della coda come dati con codifica Base64. Usare questa azione per scaricare i file allegati agli elementi di lavoro durante la creazione o l'elaborazione.
Ottenere le code	Recupera le code universali in base ai criteri di filtro. Usare questa azione per elencare le code disponibili, controllarne la configurazione o cercare i dettagli della coda. Questa operazione supporta anche elenchi a discesa dinamici in altre azioni.
Ottenere moduli	Recupera un elenco di moduli di interazione robot con filtri facoltativi. Usare questa azione per eseguire query sulle richieste di ciclo umano in sospeso, controllarne lo stato o trovare moduli assegnati a utenti specifici.
Recupera elementi della coda	Recupera gli elementi della coda in base a criteri di filtro specificati, ad esempio lo stato, i tag, le date e i nomi delle code. Usare questa azione per cercare e monitorare gli elementi di lavoro nelle code universali.
Rimuovere tag dall'elemento della coda	Rimuove uno o più tag da un elemento della coda. Utilizzare questa azione per aggiornare la categorizzazione degli elementi di lavoro durante l'elaborazione.
Rinviare l'elemento della coda	Rinvia un elemento della coda in modo che non venga elaborato fino alla data/ora specificata. Usare questa azione quando un elemento non può essere elaborato ora, ma dovrebbe essere riprovato in un secondo momento.
Sblocca elemento coda	Sblocca un elemento della coda bloccato in precedenza e lo restituisce allo stato disponibile. Utilizzare questa azione quando l'elaborazione viene interrotta e l'elemento deve essere rilasciato per altri ruoli di lavoro.

Aggiungere il log all'elemento della coda

ID operazione:: AddItemLog

Aggiunge un messaggio di log a un elemento della coda per la traccia di controllo e la tracciabilità. Usare questa azione per registrare i passaggi di elaborazione, gli avvisi o gli errori relativi a un elemento di lavoro specifico.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID elemento coda	queueItemId	True	string	ID dell'elemento della coda a cui accedere.
Livello di log	level		string	Livello di gravità della voce di log.
Message	message		string	Contenuto del messaggio di log.

Aggiungere il log alla sessione

ID operazione:: AddLogToSession

Scrive una voce di log in una sessione C TWO. Usare questa azione per tenere traccia dello stato di avanzamento, registrare le decisioni o registrare le informazioni di diagnostica durante l'esecuzione del flusso. I log sono visibili nella piattaforma C TWO per il controllo e la risoluzione dei problemi.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID della sessione	sessionId	True	string	ID sessione C TWO in cui verrà registrata la voce di log. L'impostazione predefinita è l'ID sessione dell'output del trigger.
level	level	True	string	Livello di gravità della voce di log.
message	message	True	string	Contenuto del messaggio di log da registrare.

Aggiungere tag all'elemento della coda

ID operazione:: AddItemTag

Aggiunge uno o più tag a un elemento della coda per la categorizzazione e il filtro. I tag consentono di organizzare e cercare elementi di lavoro tra le code.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID elemento coda	queueItemId	True	string	ID dell'elemento della coda a cui aggiungere tag.
Tags	tags		string	Elenco delimitato da virgole di tag da aggiungere.

Assegna modulo

ID operazione:: AssignForm

Assegna un modulo di interazione robot a un utente specifico, rendendolo responsabile della revisione e del completamento della richiesta umana nel ciclo.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID modulo	formId	True	string	Id modulo ciclo umano da assegnare.
userId	userId		integer	ID dell'utente a cui assegnare il modulo.

Blocca elemento coda

ID operazione:: LockItem

Blocca un elemento della coda per impedire ad altri ruoli di lavoro di elaborarlo simultaneamente. Usare questa azione prima di elaborare un elemento di lavoro per garantire l'accesso esclusivo.

Parametri

Nome	Chiave	Tipo	Descrizione
ID elemento coda	queueItemId	string	ID dell'elemento della coda da bloccare. Se omesso, l'elemento successivo disponibile corrispondente al filtro verrà bloccato.
Nome coda	reference	string	Riferimento alla coda da cui bloccare un elemento.
ID stato	stateId	string	ID di stato per filtrare gli elementi.
Nome stato	stateName	string	Nome dello stato in base al quale filtrare gli elementi.
ID della sessione	sessionId	string	ID sessione per questo blocco.

Valori restituiti

Nome	Percorso	Tipo	Descrizione
id	id	integer	Identificatore univoco dell'elemento bloccato.
itemKey	itemKey	string	Chiave univoca dell'elemento bloccato.
Tentativi	attempts	integer	Numero di tentativi di elaborazione.
queueId	queueId	integer	Identificatore della coda padre.
id	state.id	integer	Identificatore dello stato.
nome	state.name	string	Nome dello stato.
state	state.state	string	Valore dello stato.
tags	tags	array of string	Tag associati all'elemento della coda.
creato	created	string	Il timestamp della creazione.
createdByVendorSessionId	createdByVendorSessionId	integer	ID sessione che ha creato questo elemento.
Concluso	concluded	string	Timestamp di conclusione.
posticipato	deferred	string	Timestamp posticipato.
test	test	boolean	Indica se si tratta di un elemento di test.
bloccato	locked	boolean	Indica se l'elemento è bloccato.

Crea modulo

ID operazione:: CreateForm

Crea un nuovo modulo di interazione robot che consente a un lavoratore digitale di richiedere assistenza umana. Il modulo viene presentato agli utenti assegnati nella piattaforma C TWO, consentendo scenari umani nel ciclo in cui è necessaria l'esperienza umana per gestire eccezioni o decisioni complesse.

Parametri

Nome	Chiave	Tipo	Descrizione
Campi	fields	string	Stringa in formato JSON che definisce i campi modulo che l'utente umano deve compilare.
titolo	title	string	Titolo visualizzato all'utente umano quando apre il modulo.
scadenza	deadline	date-time	Scadenza entro la quale l'uomo deve rispondere al modulo (formato ISO 8601).
Intro	intro	string	Testo introduttivo mostrato all'utente umano che spiega quale azione è necessaria.
itemId	itemId	integer	ID elemento della coda associato a questo modulo, collegando l'interazione umana a un elemento di lavoro specifico.
workflowTaskId	workflowTaskId	integer	Attività C TWO che ha creato questo modulo.

Valori restituiti

Nome	Percorso	Tipo	Descrizione
id	id	integer	id

Creare lo stato dell'elemento della coda

ID operazione:: CreateItemState

Crea un nuovo stato personalizzato all'interno di una coda specifica. Gli stati personalizzati consentono di definire fasi del flusso di lavoro oltre gli stati predefiniti (in sospeso, completato, a cui si fa riferimento), adattando la coda al processo aziendale.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome	name		string	Nome del nuovo stato.
Calcolo del tempo di risposta	responseTimeCalculationBasis	True	string	Determina il modo in cui i contratti di servizio del tempo di risposta vengono calcolati per gli elementi che entrano in questo stato.
Tipo di stato	state	True	string	Tipo di stato (in sospeso, completato o a cui si fa riferimento).
ID coda	queueId	True	integer	ID della coda in cui verrà creato questo stato.
Description	description		string	Descrizione di ciò che questo stato rappresenta nel flusso di lavoro.
Tempo salvato per elemento	timeSavedPerItem		integer	Tempo salvato per elemento in questo stato (secondi), usato per la creazione di report ROI.
Valore generato per elemento	valueGeneratedPerItem		integer	Valore generato per elemento in questo stato, usato per la creazione di report ROI.
Includi nei report	includeInReports		boolean	Indica se includere questo stato in analisi e report.

Creare un elemento della coda

ID operazione:: CreateItem

Crea un nuovo elemento di lavoro in una coda universale specificata. Usare questa azione per aggiungere elementi per l'elaborazione da parte di ruoli di lavoro digitali, inclusi payload dei dati, tag e allegati di file facoltativi.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Chiave elemento	itemKey	True	string	Chiave aziendale univoca per identificare l'elemento della coda, ad esempio il numero di fattura, l'ID del caso.
Stato elemento coda	queueItemState	True	string	Stato iniziale dell'elemento della coda ,ad esempio In sospeso.
Riferimento alla coda	reference	True	string	Riferimento alla coda in cui verrà creato l'elemento.
Posticipato fino a	deferredUntil		date-time	Rinviare l'elaborazione fino a questa data/ora (formato ISO 8601).
Dati elemento	itemData		object	Payload dei dati per l'elemento della coda in formato JSON.
Tags	tags		string	Tag per l'elemento della coda (delimitato da virgole).
fileName	fileName		string	Nome del file allegato.
Filedata	fileData		string	Dati di file con codifica Base64.
ID della sessione	sessionId		string	ID sessione associato a questo elemento.
Dispositivo	device		string	Dispositivo che ha creato questo elemento.
User	user		string	Utente che ha creato l'elemento.
Provider di automazione	automationProvider		string	Provider di automazione per questo elemento.

Valori restituiti

Nome	Percorso	Tipo	Descrizione
id	id	integer	id
itemKey	itemKey	string	itemKey
Tentativi	attempts	integer	Tentativi
queueId	queueId	integer	queueId
id	state.id	integer	id
nome	state.name	string	nome
state	state.state	string	state
tags	tags	array of string	tags
creato	created	string	creato
createdByVendorSessionId	createdByVendorSessionId	integer	createdByVendorSessionId
Concluso	concluded	string	Concluso
Differita	deferred	string	posticipato
test	test	boolean	test
bloccato	locked	boolean	bloccato

Dovrebbe arrestare la sessione

ID operazione:: IsStopRequested

Verifica se C TWO ha richiesto un arresto normale (soft) per la sessione specificata. Usare questa azione all'interno di cicli per verificare periodicamente se la sessione deve terminare in anticipo, consentendo al flusso di pulire le risorse prima dell'arresto.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID della sessione	sessionId	True	string	ID sessione C TWO per verificare la presenza di una richiesta di arresto. L'impostazione predefinita è l'ID sessione dell'output del trigger.

Valori restituiti

Nome	Percorso	Tipo	Descrizione
isStopRequested	isStopRequested	boolean	isStopRequested

Imposta timeout sessione

ID operazione:: SetTimeout

Aggiorna il valore di timeout per una sessione C TWO attiva. Usare questa azione per estendere o ridurre il tempo di esecuzione consentito per una sessione in esecuzione quando il timeout originale richiede una regolazione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID della sessione	sessionId	True	string	ID sessione C TWO per cui aggiornare il timeout. L'impostazione predefinita è l'ID sessione dell'output del trigger.
Interruzione temporanea	timeout	True	integer	Nuovo valore di timeout in secondi da applicare alla sessione.

Valori restituiti

response: string

Impostare i dati dell'elemento della coda

ID operazione:: SetItemData

Aggiorna il contenuto dei dati di un elemento della coda. Usare questa azione per modificare il payload di un elemento di lavoro durante l'elaborazione, ad esempio per archiviare i risultati intermedi.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID elemento coda	queueItemId	True	string	ID dell'elemento della coda da aggiornare.
Dati	data		object	Nuovo payload di dati per l'elemento della coda, come oggetto JSON.
Creata	created		date-time	Timestamp di creazione per questi dati.

Impostare lo stato dell'elemento della coda

ID operazione:: SetItemState

Modifica lo stato di un elemento della coda( ad esempio, da In sospeso a Completato o a uno stato personalizzato). Usare questa azione per far avanzare gli elementi tramite la pipeline del flusso di lavoro.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID elemento coda	queueItemId	True	string	ID dell'elemento della coda da aggiornare.
State	state		string	Nuovo stato per l'elemento della coda.

Impostare lo stato di esecuzione del flusso su Completato

ID operazione:: SetSessionCompleted

Contrassegna una sessione C TWO come completata, segnalando che il flusso ha completato correttamente il lavoro. Posizionare questa azione alla fine del flusso per segnalare a C TWO che l'automazione è stata completata senza errori.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID della sessione	sessionId	True	string	ID sessione C TWO da contrassegnare come completato correttamente. L'impostazione predefinita è l'ID sessione dell'output del trigger.

Valori restituiti

response: object

Impostare lo stato di esecuzione del flusso su Non riuscito

ID operazione:: SetSessionFailed

Contrassegna una sessione C TWO come non riuscita, segnalando che si è verificato un errore durante l'esecuzione del flusso. Usare questa azione negli ambiti di gestione degli errori per segnalare gli errori a C TWO con informazioni dettagliate su cosa si è verificato un errore.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID della sessione	sessionId	True	string	ID sessione C TWO da contrassegnare come non riuscito. L'impostazione predefinita è l'ID sessione dell'output del trigger.
details	details	True	string	Descrizione dell'errore o dell'eccezione che ha causato l'esito negativo della sessione.

Modulo completo

ID operazione:: CompleteForm

Contrassegna un modulo di interazione robot come completato, segnalando che l'utente umano ha fornito l'input richiesto e il lavoratore digitale può riprendere l'elaborazione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID modulo	formId	True	string	Id modulo ciclo umano da contrassegnare come completato.
completedAt	completedAt		date-time	Timestamp al termine del modulo (formato ISO 8601).

Modulo di annullare l'assegnazione

ID operazione:: UnassignForm

Rimuove l'assegnazione dell'utente corrente da un modulo di interazione robot, rendendola disponibile per gli altri utenti a richiedere.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID modulo	formId	True	string	Id modulo ciclo umano per annullare l'assegnazione.

Nuovo elemento della coda di tentativi

ID operazione:: RetryItem

Riprovare a un elemento della coda specifico, impostandone i dati sul valore originale e creando un nuovo tentativo.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID elemento coda	queueItemId	True	integer	ID dell'elemento della coda specifico da riprovare.
ID stato	stateId		integer	ID dello stato dell'elemento della coda in sospeso specifico da impostare; assume la priorità rispetto al parametro di stato.
State	state		string	Nome specifico dello stato dell'elemento della coda in sospeso da impostare.
ID attività flusso di lavoro	workflowTaskId		integer	Identificatore WorkflowTask.
ID dell'app	appId		integer	Identificatore dell'app.

Ottenere il modulo per ID

ID operazione:: GetFormById

Recupera un modulo di interazione robot specifico in base al relativo identificatore univoco. Usare questa azione per recuperare i dettagli, i campi e lo stato corrente di un modulo umano nel ciclo creato da un ruolo di lavoro digitale.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID modulo	formId	True	string	Id modulo ciclo umano per ottenere i dettagli.

Valori restituiti

Nome	Percorso	Tipo	Descrizione
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
scadenza	deadline	string	scadenza
completato	completed	string	completato
titolo	title	string	titolo
Intro	intro	string	Intro
Campi	fields	string	Campi

Ottenere l'allegato dell'elemento della coda

ID operazione:: GetItemAttachment

Recupera un allegato di file specifico da un elemento della coda come dati con codifica Base64. Usare questa azione per scaricare i file allegati agli elementi di lavoro durante la creazione o l'elaborazione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID elemento coda	queueItemId	True	string	ID dell'elemento della coda contenente l'allegato.
ID allegato	attachmentId	True	string	ID dell'allegato da recuperare.
Filename	filename		string	Nome file dell'allegato.

Valori restituiti

response: string

Ottenere le code

ID operazione:: GetQueues

Recupera le code universali in base ai criteri di filtro. Usare questa azione per elencare le code disponibili, controllarne la configurazione o cercare i dettagli della coda. Questa operazione supporta anche elenchi a discesa dinamici in altre azioni.

Parametri

Nome	Chiave	Tipo	Descrizione
ID coda	id	string	Filtrare in base all'ID coda.
Riferimento alla coda	reference	string	Filtrare in base al riferimento alla coda.
Nome coda	name	string	Filtrare in base al nome della coda.
Nome stato	stateName	string	Filtrare in base al nome dello stato.
Deleted	deleted	boolean	Filtrare in base allo stato eliminato.
Salta	skip	integer	Numero di record da ignorare per la paginazione.
Prendere	take	integer	Numero di record da restituire.

Valori restituiti

Nome	Percorso	Tipo	Descrizione
		array of object
id	id	integer	Identificatore univoco della coda.
cancellato	deleted	boolean	Indica se la coda viene eliminata.
nome	name	string	Nome della coda.
description	description	string	Descrizione della coda.
visibile	visible	boolean	Indica se la coda è visibile.
includeInReports	includeInReports	boolean	Indica se includere nei report.
creato	created	string	Il timestamp della creazione.
aggiornato	updated	string	Timestamp dell'ultimo aggiornamento.
deletedTime	deletedTime	string	Timestamp di eliminazione.
divisionId	divisionId	integer	Identificatore di divisione.
type	type	integer	Tipo di coda.
riferimento	reference	string	Riferimento alla coda.
stati	states	array of object	Stati disponibili in questa coda.
id	states.id	integer	Identificatore dello stato.
nome	states.name	string	Nome dello stato.
description	states.description	string	Descrizione dello stato.
tagfilter	states.tagfilter	string	Filtro tag per questo stato.
state	states.state	integer	Tipo di stato.
timeSavedPerItem	states.timeSavedPerItem	integer	Tempo salvato per elemento.
includeInReports	states.includeInReports	boolean	Indica se includere nei report.
responseTimeCalculationBasis	states.responseTimeCalculationBasis	integer	Base di calcolo del tempo di risposta.

Ottenere moduli

ID operazione:: GetForms

Recupera un elenco di moduli di interazione robot con filtri facoltativi. Usare questa azione per eseguire query sulle richieste di ciclo umano in sospeso, controllarne lo stato o trovare moduli assegnati a utenti specifici.

Parametri

Nome	Chiave	Tipo	Descrizione
Salta	skip	integer	Numero di record da ignorare per la paginazione.
Prendere	take	integer	Numero di record da restituire.
Scadenza prima	deadlineBefore	date-time	Filtrare i moduli con una scadenza prima di questa data/ora (ISO 8601).
Scadenza dopo	deadlineAfter	date-time	Filtrare i moduli con una scadenza successiva a questa data/ora (ISO 8601).
Includi completato	includeCompleted	boolean	Indica se includere moduli completati nei risultati.
Richiesta dall'ID utente	claimedByUserId	integer	Filtrare i moduli richiesti da un ID utente specifico.
Creato dall'ID attività flusso di lavoro	createdByWorkflowTaskId	integer	Filtrare i moduli creati da un ID attività del flusso di lavoro specifico.

Valori restituiti

Nome	Percorso	Tipo	Descrizione
		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
scadenza	deadline	string	scadenza
completato	completed	string	completato
non dedotto	undeferred	boolean	non dedotto

Recupera elementi della coda

ID operazione:: GetItems

Recupera gli elementi della coda in base a criteri di filtro specificati, ad esempio lo stato, i tag, le date e i nomi delle code. Usare questa azione per cercare e monitorare gli elementi di lavoro nelle code universali.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Chiave elemento	itemKey		string	Filtrare in base alla chiave dell'elemento.
Attempts	attempts		integer	Filtrare in base al numero di tentativi.
Posticipato prima	deferredBefore		date-time	Filtrare gli elementi posticipati prima di questa data.
Posticipato dopo	deferredAfter		date-time	Filtra gli elementi posticipati dopo questa data.
Creato prima	createdBefore		date-time	Filtra gli elementi creati prima di questa data.
Creato dopo	createdAfter		date-time	Filtrare gli elementi creati dopo questa data.
Concluso prima	concludedBefore		date-time	Filtrare gli elementi conclusi prima di questa data.
Concluso dopo	concludedAfter		date-time	Filtrare gli elementi terminati dopo questa data.
Stato immesso prima	stateEnteredTimeBefore		date-time	Filtra gli elementi che hanno immesso lo stato prima di questa volta.
Stato immesso dopo	stateEnteredTimeAfter		date-time	Filtra gli elementi che hanno immesso lo stato dopo questa volta.
States	states		string	Filtrare in base allo stato dell'elemento della coda.
ID stato elemento coda	queueItemStateIds		integer	Filtrare in base agli ID dello stato dell'elemento della coda.
Nomi dello stato dell'elemento della coda	queueItemStateNames		string	Filtrare in base ai nomi dello stato dell'elemento della coda.
Tags	tags		string	Filtrare in base ai tag (delimitati da virgole).
ID coda	queueIds		integer	Filtrare in base agli ID coda.
Nomi delle code	queueNames	True	string	Filtrare in base ai nomi delle code (obbligatorio).
Riferimenti	references		string	Filtrare in base ai riferimenti alle code.
Includi dati elemento	includeItemData		boolean	Indica se includere i dati dell'elemento in risposta.
Salta	skip		integer	Numero di record da ignorare per la paginazione.
Prendere	take		integer	Numero di record da restituire.

Valori restituiti

Nome	Percorso	Tipo	Descrizione
		array of object
id	id	integer	Identificatore univoco dell'elemento della coda.
itemKey	itemKey	string	Chiave univoca dell'elemento della coda.
Tentativi	attempts	integer	Numero di tentativi di elaborazione.
queueId	queueId	integer	Identificatore della coda padre.
id	state.id	integer	Identificatore dello stato.
nome	state.name	string	Nome dello stato.
state	state.state	string	Valore dello stato.
tags	tags	array of string	Tag associati all'elemento della coda.
creato	created	string	Il timestamp della creazione.
createdByVendorSessionId	createdByVendorSessionId	integer	ID sessione che ha creato questo elemento.
concluso	concluded	string	Timestamp di conclusione.
Differita	deferred	string	Timestamp posticipato.
test	test	boolean	Indica se si tratta di un elemento di test.
bloccato	locked	boolean	Indica se l'elemento è bloccato.

Rimuovere tag dall'elemento della coda

ID operazione:: RemoveItemTag

Rimuove uno o più tag da un elemento della coda. Utilizzare questa azione per aggiornare la categorizzazione degli elementi di lavoro durante l'elaborazione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID elemento coda	queueItemId	True	string	ID dell'elemento della coda da cui rimuovere i tag.
Tags	tags		string	Elenco delimitato da virgole di tag da rimuovere.

Rinviare l'elemento della coda

ID operazione:: DeferItem

Rinvia un elemento della coda in modo che non venga elaborato fino alla data/ora specificata. Usare questa azione quando un elemento non può essere elaborato ora, ma dovrebbe essere riprovato in un secondo momento.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID elemento coda	queueItemId	True	string	ID dell'elemento della coda da rinviare.
Posticipato fino a	deferredUntil		date-time	Data/ora di rinvio fino a (formato ISO 8601).

Valori restituiti

response: string

Sblocca elemento coda

ID operazione:: UnlockItem

Sblocca un elemento della coda bloccato in precedenza e lo restituisce allo stato disponibile. Utilizzare questa azione quando l'elaborazione viene interrotta e l'elemento deve essere rilasciato per altri ruoli di lavoro.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID elemento coda	queueItemId	True	string	ID dell'elemento della coda da sbloccare.

Trigger

Avviare il flusso dalla richiesta di sessione con timeout	Esegue il polling delle nuove sessioni C TWO e attiva il flusso con un vincolo di timeout. Usare questo trigger quando l'automazione deve essere completata entro un intervallo di tempo specifico. Se la sessione supera il timeout, C TWO la gestirà in base ai criteri di timeout.
Avviare il flusso dalla richiesta di sessione senza timeout	Esegue il polling delle nuove sessioni C TWO e attiva il flusso quando viene creata una sessione per l'attività selezionata. Usare questo trigger quando l'automazione non richiede un vincolo di timeout. Il flusso riceve i dettagli della sessione, inclusi i valori di input passati da C TWO.

Avviare il flusso dalla richiesta di sessione con timeout

ID operazione:: StartFlowWithTimeout

Esegue il polling delle nuove sessioni C TWO e attiva il flusso con un vincolo di timeout. Usare questo trigger quando l'automazione deve essere completata entro un intervallo di tempo specifico. Se la sessione supera il timeout, C TWO la gestirà in base ai criteri di timeout.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID attività	taskId	True	integer	Selezionare l'attività C TWO che attiverà questo flusso. Quando viene creata una sessione per questa attività, il flusso inizia con il timeout specificato applicato.
Timeout secondi	timeout	True	integer	Tempo massimo in secondi per l'esecuzione della sessione prima che C TWO lo contrassegni come timeout.

Valori restituiti

Nome	Percorso	Tipo	Descrizione
sessions	sessions	array of object	Set di sessioni attivate da C TWO con timeout
sessionId	sessions.sessionId	integer	sessionId
workflowTaskId	sessions.workflowTaskId	integer	workflowTaskId
workflowName	sessions.workflowName	string	workflowName
nomeAttività	sessions.taskName	string	nomeAttività
creato	sessions.created	string	creato
processInputValues	sessions.processInputValues	object	processInputValues

Avviare il flusso dalla richiesta di sessione senza timeout

ID operazione:: StartFlowWithoutTimeout

Esegue il polling delle nuove sessioni C TWO e attiva il flusso quando viene creata una sessione per l'attività selezionata. Usare questo trigger quando l'automazione non richiede un vincolo di timeout. Il flusso riceve i dettagli della sessione, inclusi i valori di input passati da C TWO.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID attività	taskId	True	integer	Selezionare l'attività C TWO che attiverà questo flusso. Quando viene creata una nuova sessione per questa attività in C TWO, il flusso verrà avviato automaticamente senza applicare un timeout.

Valori restituiti

Nome	Percorso	Tipo	Descrizione
sessions	sessions	array of object	Set di sessioni attivate da C TWO senza timeout
sessionId	sessions.sessionId	integer	sessionId
workflowTaskId	sessions.workflowTaskId	integer	workflowTaskId
workflowName	sessions.workflowName	string	workflowName
nomeAttività	sessions.taskName	string	nomeAttività
creato	sessions.created	string	creato
processInputValues	sessions.processInputValues	object	processInputValues