C TWO (versión preliminar)

C TWO es una plataforma de administración agente que organiza flujos de trabajo de automatización, administra interacciones de robots humanos y procesa elementos de trabajo a través de colas universales. Use este conector para desencadenar flujos desde sesiones de C TWO, administrar el ciclo de vida de la sesión, crear y procesar elementos de cola y habilitar interacciones humanas en bucle con los trabajadores digitales.

Este conector está disponible en los siguientes productos y regiones:

Service	Class	Regions
Copilot Studio	Premium	Todas las regiones Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas	Estándar	Todas las regiones de Logic Apps excepto las siguientes: - regiones de Azure Government - Azure regiones de China - Departamento de Defensa de EE. UU. (DoD)
Power Apps	Premium	Todas las regiones Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)
Power Automate	Premium	Todas las regiones Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)

Contact
Nombre	Compatibilidad con C TWO
URL	https://ctwo.com/
Correo electrónico	customersuccess@ctwo.com

Metadatos del conector
Publicador	C TWO
Sitio web	https://ctwo.com/
Directiva de privacidad	https://ctwo.com/privacy-policy/
Categories	Business Intelligence; IA

C TWO

C TWO es una plataforma de administración agente que organiza flujos de trabajo de automatización, administra interacciones de robots humanos y procesa elementos de trabajo a través de colas universales. Este conector permite desencadenar Power Automate, Power Apps, Azure Logic Apps y Copilot Studio y desencadenarse mediante sesiones de C TWO, administrar el ciclo de vida de la sesión, crear y procesar elementos de cola universal y habilitar interacciones humanas en bucle con los trabajos digitales.

C TWO se encuentra encima del patrimonio de automatización como una sola capa de orquestación, gobernanza y supervisión: lo que cree o ejecute el trabajo, C TWO agrega seguimiento de SLA, reintentos y recuperación automática, telemetría de sesión activa y una pista de auditoría completa.

Prerequisites

Antes de crear una conexión, necesitará:

Un inquilino activo de C TWO: C TWO Cloud (hospedado) o un servidor C TWO local accesible a través de HTTPS.
Un token de cuenta de servicio o un token de acceso personal emitido por el administrador de C TWO (consulte Obtención de credenciales).
Si C TWO está hospedado localmente, el servidor debe ser accesible desde Power Platform a través de HTTPS (firewall que permite el Power Automate intervalos IP de salida de Microsoft, Azure etiquetas AzureConnectors.<region> de servicio y PowerPlatformPlex para la geo de Power Platform).
Un entorno de Power Platform con permisos de conector personalizado y un nivel de licencia que admita conectores personalizados (Power Automate Premium o equivalente).

Creación de una conexión

Cuando se crea una conexión, se proporcionan tres valores, todos desde su propio entorno de C TWO:

Host C TWO : solo el nombre de host del servidor C TWO (sin esquema, ninguna barra diagonal final), por ejemplo connect24.ctwo.cloud, o un host local con puerto opcional, como ctwo.contoso.com:8443.
DIRECCIÓN URL base de C TWO : la ruta de acceso base de la API de C TWO, incluida la división, empezando por una barra diagonal y sin barra diagonal final, por ejemplo /DEFAULT/CTWO.Server/api.
Clave de API : el token, especificado como Bearer <your-token>. Se recomienda un token de cuenta de servicio ; También funciona un token de acceso personal .

Juntos, host y dirección URL base enrutan el conector a su propio servidor C TWO (https://{Host}{Base URL}/…), por lo que cada cliente se conecta a su propio entorno: C TWO Cloud o local.

Obtención de credenciales

La autenticación usa una clave de API enviada como token de portador en el Authorization encabezado.

Token de cuenta de servicio (recomendado para producción)

Inicie sesión en la instancia de C TWO.
Vaya a Aplicaciones y conexiones → Microsoft Power Automate → Crear cuenta de servicio.
Copie el token generado inmediatamente; solo se muestra una vez.

Token de acceso personal (desarrollo/pruebas)

Abra el perfil de usuario en C TWO.
Vaya a la pestaña Tokens de API y genere un nuevo token.
Cópielo inmediatamente: solo se muestra una vez y se invalida si la cuenta de usuario está deshabilitada.

Tratar ambos tipos de token como secretos: almacénelos solo en la credencial de conexión de Power Platform, nunca en variables de flujo o código del lado cliente.

Operaciones soportadas

Desencadenadores : inicie un flujo cuando C TWO envía una sesión, con o sin un tiempo de espera aplicado.
Administración de sesiones : notificar la finalización o el error, escribir registros de sesión con tipo, ajustar el tiempo de espera de la sesión y comprobar si hay una solicitud de detención correcta.
Cola universal : crear, enumerar, bloquear, desbloquear, reintentar y aplazar elementos de cola; actualizar datos de elementos y agregar registros de nivel de elemento; add/remove tags; recuperar datos adjuntos; crear estados de elementos personalizados; enumerar colas.
Human-in-the-loop : cree, asigne, desasigne y complete formularios estructurados de asistencia humana y recupere o consultelos.

Las operaciones auxiliares internas rellenan listas desplegables dinámicas (selectores de tareas y usuarios) y no se llaman directamente.

Problemas y limitaciones conocidos

Se requiere el host y la dirección URL base correctos. Ambos se escriben en el momento de la conexión y enrutan el conector al servidor C TWO. Los valores incorrectos o inaccesibles producen errores de conexión o solicitud.
Formato de clave de API. El campo Clave de API espera la cadena Bearer <token> literal: si se omite el Bearer prefijo, se 401 Unauthorizedproduce .
Proporcionar datos de elementos JSON. Los campos de datos de elemento (Create Queue Item, Set Queue Item Data) son objetos JSON. En un flujo, proporcione json literal con la json('…') expresión para que se envíe como un objeto en lugar de una cadena.
Latencia del desencadenador de sondeo. Desencadena el sondeo en lugar de insertar, por lo que hay un pequeño retraso (limitado por la periodicidad del desencadenador) entre una sesión que se envía en C TWO y el inicio del flujo.
Tipos de campo de formulario. Algunos campos de identificador devueltos por las operaciones de formulario pueden ser un entero, una cadena o null en función del estado del formulario.

Errores y soluciones comunes

Error	Causa probable	Solución
`401 Unauthorized`	Clave de API que falta el `Bearer` prefijo, expirado o revocado	Vuelva a escribir la credencial como `Bearer <token>`; genere un nuevo token de cuenta de servicio si se revoca.
`400 Bad request` en Crear elemento de cola	Falta un campo obligatorio (`reference`, `queueItemState`, `itemKey`)	Rellenar los tres campos obligatorios
El desencadenador nunca se desencadena	Tarea incorrecta seleccionada o la tarea C TWO no está expuesta a Power Automate	Confirme que la tarea aparece en la lista desplegable Id. de tarea y está configurada como un flujo expuesto en C TWO
Datos de elementos almacenados como una cadena de escape	JSON proporcionado como texto en lugar de un objeto	Use la `json('…')` expresión (flujos) o el cuerpo sin procesar (prueba del conector) para que se envíe como un objeto.

FAQ

¿Puedo usar este conector desde Power Apps, Azure Logic Apps y Copilot Studio, no solo Power Automate? Yes. Los desencadenadores son Power Automate específicos, pero cada acción se puede llamar desde cualquiera de estas plataformas una vez creada una conexión.

¿Este conector administra las licencias? N.º C TWO organiza y rige la ejecución; los clientes son responsables de sus propias licencias de Microsoft.

¿Dónde puedo obtener ayuda? Póngase en contacto con el éxito del cliente de C TWO en customersuccess@ctwo.com.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:


Predeterminado	Parámetros para crear una conexión.	Todas las regiones	No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre	Tipo	Description	Obligatorio
C TWO Host	string	El nombre de host del servidor C TWO solo no tiene ningún esquema, sin barra diagonal final. Por ejemplo, connect24.ctwo.cloud o un host local con puerto opcional, como ctwo.contoso.com:8443.	True
C TWO Base URL	string	Ruta de acceso base de la API de C TWO, incluida la división. Comience con una barra diagonal, sin barra diagonal final. Por ejemplo, /DEFAULT/CTWO. Servidor o API.	True
Clave de API	securestring	El token de API de C TWO, especificado como: Portador <del token>. Se recomienda un token de cuenta de servicio; También funciona un token de acceso personal.	True

Acciones

Agregar etiquetas al elemento de cola	Agrega una o varias etiquetas a un elemento de cola para categorización y filtrado. Las etiquetas ayudan a organizar y buscar elementos de trabajo entre colas.
Agregar registro a la sesión	Escribe una entrada de registro en una sesión de C TWO. Use esta acción para realizar un seguimiento del progreso, las decisiones de registro o la información de diagnóstico del registro durante la ejecución del flujo. Los registros están visibles en la plataforma C TWO para la auditoría y la solución de problemas.
Agregar registro al elemento de cola	Agrega un mensaje de registro a un elemento de cola para la traza de auditoría y la rastreabilidad. Use esta acción para registrar pasos de procesamiento, advertencias o errores en un elemento de trabajo específico.
Anular la asignación de formulario	Quita la asignación de usuario actual de un formulario de interacción de robot, lo que hace que esté disponible para que otros usuarios puedan reclamar.
Aplazar elemento de cola	Aplaza un elemento de cola para que no se procese hasta la fecha y hora especificadas. Use esta acción cuando un elemento no se pueda procesar ahora, pero se debe reintentar más adelante.
Asignar formulario	Asigna un formulario de interacción de robot a un usuario específico, por lo que es responsable de revisar y completar la solicitud human-in-the-loop.
Crear elemento de cola	Crea un nuevo elemento de trabajo en una cola universal especificada. Use esta acción para agregar elementos para su procesamiento por parte de los trabajadores digitales, incluidas las cargas de datos, las etiquetas y los datos adjuntos de archivos opcionales.
Crear estado de elemento de cola	Crea un nuevo estado personalizado dentro de una cola específica. Los estados personalizados permiten definir fases de flujo de trabajo más allá de los estados predeterminados (Pendiente, Completado, Referencia), adaptando la cola al proceso empresarial.
Crear formulario	Crea un nuevo formulario de interacción de robot que permite a un trabajador digital solicitar asistencia humana. El formulario se presenta a los usuarios asignados en la plataforma C TWO, lo que permite escenarios humanos en bucle en los que se necesita experiencia humana para controlar excepciones o decisiones complejas.
Desbloquear elemento de cola	Desbloquea un elemento de cola bloqueado previamente y lo devuelve a su estado disponible. Use esta acción cuando se interrumpa el procesamiento y el elemento se debe liberar para otros trabajos.
Elemento de cola de bloqueo	Bloquea un elemento de cola para evitar que otros trabajadores lo procesen simultáneamente. Use esta acción antes de procesar un elemento de trabajo para garantizar el acceso exclusivo.
Establecer datos de elementos de cola	Actualiza el contenido de datos de un elemento de cola. Use esta acción para modificar la carga de un elemento de trabajo durante el procesamiento, por ejemplo, para almacenar resultados intermedios.
Establecer el estado de ejecución del flujo en Completado	Marca una sesión C TWO como completada, lo que indica que el flujo ha terminado su trabajo correctamente. Coloque esta acción al final del flujo para informar a C TWO de que la automatización se completó sin errores.
Establecer el estado de ejecución del flujo en Error	Marca una sesión de C TWO como errónea, lo que indica que se produjo un error durante la ejecución del flujo. Use esta acción en ámbitos de control de errores para notificar errores de nuevo a C TWO con detalles sobre lo que salió mal.
Establecer el estado del elemento de cola	Cambia el estado de un elemento de cola (por ejemplo, de Pendiente a Completado o a un estado personalizado). Use esta acción para avanzar los elementos a través de la canalización de flujo de trabajo.
Establecer tiempo de espera de sesión	Actualiza el valor de tiempo de espera de una sesión activa de C TWO. Use esta acción para ampliar o reducir el tiempo de ejecución permitido para una sesión en ejecución cuando el tiempo de espera original necesite ajuste.
Formulario completo	Marca un formulario de interacción de robot como completado, lo que indica que el usuario humano ha proporcionado la entrada solicitada y el trabajo digital puede reanudar el procesamiento.
Obtener colas	Recupera colas universales basadas en criterios de filtro. Use esta acción para enumerar las colas disponibles, comprobar su configuración o buscar los detalles de la cola. Esta operación también impulsa las listas desplegables dinámicas en otras acciones.
Obtener datos adjuntos de elementos de cola	Recupera un archivo adjunto específico de un elemento de cola como datos codificados en base64. Use esta acción para descargar archivos adjuntos a elementos de trabajo durante la creación o el procesamiento.
Obtener elementos de cola	Recupera los elementos de cola en función de los criterios de filtro especificados, como el estado, las etiquetas, las fechas y los nombres de cola. Use esta acción para buscar y supervisar elementos de trabajo en las colas universales.
Obtener formulario por identificador	Recupera un formulario de interacción de robot específico por su identificador único. Use esta acción para capturar los detalles, los campos y el estado actual de un formulario humano en el bucle creado por un trabajador digital.
Obtener formularios	Recupera una lista de formularios de interacción de robot con filtrado opcional. Use esta acción para consultar las solicitudes humanas pendientes en el bucle, comprobar su estado o buscar formularios asignados a usuarios específicos.
Quitar etiquetas del elemento de cola	Quita una o varias etiquetas de un elemento de cola. Use esta acción para actualizar la categorización de los elementos de trabajo durante el procesamiento.
Reintentar elemento de cola	Vuelva a intentar un elemento de cola específico, estableciendo sus datos en su valor original y creando un nuevo intento.
Se debe detener la sesión	Comprueba si C TWO ha solicitado una detención correcta (suave) para la sesión especificada. Use esta acción dentro de bucles para comprobar periódicamente si la sesión debe finalizar antes, lo que permite que el flujo limpie los recursos antes de detenerla.

Agregar etiquetas al elemento de cola

Id. de la operación:: AddItemTag

Agrega una o varias etiquetas a un elemento de cola para categorización y filtrado. Las etiquetas ayudan a organizar y buscar elementos de trabajo entre colas.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de elemento de cola	queueItemId	True	string	Identificador del elemento de cola al que se van a agregar etiquetas.
Tags	tags		string	Lista separada por comas de etiquetas que se van a agregar.

Agregar registro a la sesión

Id. de la operación:: AddLogToSession

Escribe una entrada de registro en una sesión de C TWO. Use esta acción para realizar un seguimiento del progreso, las decisiones de registro o la información de diagnóstico del registro durante la ejecución del flujo. Los registros están visibles en la plataforma C TWO para la auditoría y la solución de problemas.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Identificador de sesión	sessionId	True	string	Identificador de sesión de C TWO donde se registrará la entrada de registro. El valor predeterminado es el identificador de sesión de la salida del desencadenador.
nivel	level	True	string	Nivel de gravedad de la entrada de registro.
message	message	True	string	Contenido del mensaje de registro que se va a registrar.

Agregar registro al elemento de cola

Id. de la operación:: AddItemLog

Agrega un mensaje de registro a un elemento de cola para la traza de auditoría y la rastreabilidad. Use esta acción para registrar pasos de procesamiento, advertencias o errores en un elemento de trabajo específico.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de elemento de cola	queueItemId	True	string	Identificador del elemento de cola en el que se va a iniciar sesión.
Nivel de registro	level		string	Nivel de gravedad de la entrada de registro.
Mensaje	message		string	Contenido del mensaje de registro.

Anular la asignación de formulario

Id. de la operación:: UnassignForm

Quita la asignación de usuario actual de un formulario de interacción de robot, lo que hace que esté disponible para que otros usuarios puedan reclamar.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de formulario	formId	True	string	Humano en el identificador del formulario de bucle para cancelar la asignación.

Aplazar elemento de cola

Id. de la operación:: DeferItem

Aplaza un elemento de cola para que no se procese hasta la fecha y hora especificadas. Use esta acción cuando un elemento no se pueda procesar ahora, pero se debe reintentar más adelante.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de elemento de cola	queueItemId	True	string	Identificador del elemento de cola que se va a aplazar.
Hasta diferido	deferredUntil		date-time	Fecha y hora a aplazar hasta (formato ISO 8601).

Devoluciones

response: string

Asignar formulario

Id. de la operación:: AssignForm

Asigna un formulario de interacción de robot a un usuario específico, por lo que es responsable de revisar y completar la solicitud human-in-the-loop.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de formulario	formId	True	string	Humano en el identificador de formulario de bucle que se va a asignar.
userId	userId		integer	Identificador del usuario al que se va a asignar el formulario.

Crear elemento de cola

Id. de la operación:: CreateItem

Crea un nuevo elemento de trabajo en una cola universal especificada. Use esta acción para agregar elementos para su procesamiento por parte de los trabajadores digitales, incluidas las cargas de datos, las etiquetas y los datos adjuntos de archivos opcionales.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Clave de elemento	itemKey	True	string	Clave empresarial única para identificar este elemento de cola (por ejemplo, número de factura, identificador de caso).
Estado del elemento de cola	queueItemState	True	string	Estado inicial del elemento de cola (por ejemplo, Pendiente).
Referencia de cola	reference	True	string	Referencia de cola donde se creará el elemento.
Hasta diferido	deferredUntil		date-time	Aplazar el procesamiento hasta esta fecha y hora (formato ISO 8601).
Datos de elementos	itemData		object	La carga de datos del elemento de cola en formato JSON.
Tags	tags		string	Etiquetas para el elemento de cola (separados por comas).
fileName	fileName		string	Nombre del archivo adjunto.
fileData	fileData		string	Datos de archivo codificados en base64.
Identificador de sesión	sessionId		string	Identificador de sesión asociado a este elemento.
Dispositivo	device		string	Dispositivo que creó este elemento.
Usuario	user		string	Usuario que creó este elemento.
Proveedor de automatización	automationProvider		string	Proveedor de automatización de este elemento.

Devoluciones

Nombre	Ruta de acceso	Tipo	Description
id	id	integer	id
itemKey	itemKey	string	itemKey
Intentos	attempts	integer	Intentos
queueId	queueId	integer	queueId
id	state.id	integer	id
nombre	state.name	string	nombre
state	state.state	string	state
tags	tags	array of string	tags
creado	created	string	creado
createdByVendorSessionId	createdByVendorSessionId	integer	createdByVendorSessionId
concluida	concluded	string	concluida
Diferido	deferred	string	Diferido
test	test	boolean	test
bloqueado	locked	boolean	bloqueado

Crear estado de elemento de cola

Id. de la operación:: CreateItemState

Crea un nuevo estado personalizado dentro de una cola específica. Los estados personalizados permiten definir fases de flujo de trabajo más allá de los estados predeterminados (Pendiente, Completado, Referencia), adaptando la cola al proceso empresarial.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Nombre	name		string	Nombre del nuevo estado.
Cálculo del tiempo de respuesta	responseTimeCalculationBasis	True	string	Determina cómo se calculan los Acuerdos de Nivel de Servicio de tiempo de respuesta para los elementos que entran en este estado.
Tipo de estado	state	True	string	Tipo de estado (Pendiente, Completado o Referencia).
Id. de cola	queueId	True	integer	Identificador de la cola donde se creará este estado.
Description	description		string	Descripción de lo que este estado representa en el flujo de trabajo.
Tiempo guardado por elemento	timeSavedPerItem		integer	Tiempo guardado por elemento en este estado (segundos), usado para los informes de ROI.
Valor generado por elemento	valueGeneratedPerItem		integer	Valor generado por elemento en este estado, que se usa para los informes de ROI.
Incluir en informes	includeInReports		boolean	Si se debe incluir este estado en análisis e informes.

Crear formulario

Id. de la operación:: CreateForm

Crea un nuevo formulario de interacción de robot que permite a un trabajador digital solicitar asistencia humana. El formulario se presenta a los usuarios asignados en la plataforma C TWO, lo que permite escenarios humanos en bucle en los que se necesita experiencia humana para controlar excepciones o decisiones complejas.

Parámetros

Nombre	Clave	Tipo	Description
Campos	fields	string	Cadena con formato JSON que define los campos de formulario que el usuario humano necesita rellenar.
título	title	string	Título que se muestra al usuario humano cuando abre el formulario.
fecha tope	deadline	date-time	Fecha límite en la que el humano debe responder al formulario (formato ISO 8601).
introducción	intro	string	Texto introductorio que se muestra al usuario humano explicando qué acción es necesaria.
idDeArtículo	itemId	integer	El identificador del elemento de cola asociado a este formulario, vinculando la interacción humana a un elemento de trabajo específico.
workflowTaskId	workflowTaskId	integer	Tarea C TWO que creó este formulario.

Devoluciones

Nombre	Ruta de acceso	Tipo	Description
id	id	integer	id

Desbloquear elemento de cola

Id. de la operación:: UnlockItem

Desbloquea un elemento de cola bloqueado previamente y lo devuelve a su estado disponible. Use esta acción cuando se interrumpa el procesamiento y el elemento se debe liberar para otros trabajos.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de elemento de cola	queueItemId	True	string	Identificador del elemento de cola que se va a desbloquear.

Elemento de cola de bloqueo

Id. de la operación:: LockItem

Bloquea un elemento de cola para evitar que otros trabajadores lo procesen simultáneamente. Use esta acción antes de procesar un elemento de trabajo para garantizar el acceso exclusivo.

Parámetros

Nombre	Clave	Tipo	Description
Id. de elemento de cola	queueItemId	string	Identificador del elemento de cola que se va a bloquear. Si se omite, se bloqueará el siguiente elemento disponible que coincida con el filtro.
Nombre de la cola	reference	string	Referencia de cola desde la que se bloquea un elemento.
Id. de estado	stateId	string	Identificador de estado que se va a filtrar los elementos.
Nombre de estado	stateName	string	Nombre de estado por el que se van a filtrar los elementos.
Identificador de sesión	sessionId	string	Identificador de sesión de este bloqueo.

Devoluciones

Nombre	Ruta de acceso	Tipo	Description
id	id	integer	Identificador único del elemento bloqueado.
itemKey	itemKey	string	Clave única del elemento bloqueado.
Intentos	attempts	integer	Número de intentos de procesamiento.
queueId	queueId	integer	Identificador de la cola primaria.
id	state.id	integer	Identificador de estado.
nombre	state.name	string	El nombre del estado.
state	state.state	string	Valor de estado.
tags	tags	array of string	Etiquetas asociadas al elemento de cola.
creado	created	string	La marca de tiempo de la creación.
createdByVendorSessionId	createdByVendorSessionId	integer	Identificador de sesión que creó este elemento.
concluida	concluded	string	Marca de tiempo de conclusión.
Diferido	deferred	string	Marca de tiempo diferida.
test	test	boolean	Si se trata de un elemento de prueba.
bloqueado	locked	boolean	Si el elemento está bloqueado.

Establecer datos de elementos de cola

Id. de la operación:: SetItemData

Actualiza el contenido de datos de un elemento de cola. Use esta acción para modificar la carga de un elemento de trabajo durante el procesamiento, por ejemplo, para almacenar resultados intermedios.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de elemento de cola	queueItemId	True	string	Identificador del elemento de cola que se va a actualizar.
Data	data		object	La nueva carga de datos para el elemento de cola, como un objeto JSON.
Creado	created		date-time	Marca de tiempo de creación para estos datos.

Establecer el estado de ejecución del flujo en Completado

Id. de la operación:: SetSessionCompleted

Marca una sesión C TWO como completada, lo que indica que el flujo ha terminado su trabajo correctamente. Coloque esta acción al final del flujo para informar a C TWO de que la automatización se completó sin errores.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Identificador de sesión	sessionId	True	string	Identificador de sesión de C TWO que se va a marcar como completado correctamente. El valor predeterminado es el identificador de sesión de la salida del desencadenador.

Devoluciones

response: object

Establecer el estado de ejecución del flujo en Error

Id. de la operación:: SetSessionFailed

Marca una sesión de C TWO como errónea, lo que indica que se produjo un error durante la ejecución del flujo. Use esta acción en ámbitos de control de errores para notificar errores de nuevo a C TWO con detalles sobre lo que salió mal.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Identificador de sesión	sessionId	True	string	Identificador de sesión de C TWO que se va a marcar como erróneo. El valor predeterminado es el identificador de sesión de la salida del desencadenador.
detalles	details	True	string	Descripción del error o excepción que provocó un error en la sesión.

Establecer el estado del elemento de cola

Id. de la operación:: SetItemState

Cambia el estado de un elemento de cola (por ejemplo, de Pendiente a Completado o a un estado personalizado). Use esta acción para avanzar los elementos a través de la canalización de flujo de trabajo.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de elemento de cola	queueItemId	True	string	Identificador del elemento de cola que se va a actualizar.
Estado	state		string	Nuevo estado del elemento de cola.

Establecer tiempo de espera de sesión

Id. de la operación:: SetTimeout

Actualiza el valor de tiempo de espera de una sesión activa de C TWO. Use esta acción para ampliar o reducir el tiempo de ejecución permitido para una sesión en ejecución cuando el tiempo de espera original necesite ajuste.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Identificador de sesión	sessionId	True	string	Identificador de sesión de C TWO para el que se va a actualizar el tiempo de espera. El valor predeterminado es el identificador de sesión de la salida del desencadenador.
Tiempo de espera	timeout	True	integer	Nuevo valor de tiempo de espera en segundos que se aplicará a la sesión.

Devoluciones

response: string

Formulario completo

Id. de la operación:: CompleteForm

Marca un formulario de interacción de robot como completado, lo que indica que el usuario humano ha proporcionado la entrada solicitada y el trabajo digital puede reanudar el procesamiento.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de formulario	formId	True	string	Humano en el identificador del formulario de bucle que se va a marcar como completado.
completedAt	completedAt		date-time	Marca de tiempo cuando se completó el formulario (formato ISO 8601).

Obtener colas

Id. de la operación:: GetQueues

Recupera colas universales basadas en criterios de filtro. Use esta acción para enumerar las colas disponibles, comprobar su configuración o buscar los detalles de la cola. Esta operación también impulsa las listas desplegables dinámicas en otras acciones.

Parámetros

Nombre	Clave	Tipo	Description
Id. de cola	id	string	Filtre por identificador de cola.
Referencia de cola	reference	string	Filtre por referencia de cola.
Nombre de la cola	name	string	Filtre por nombre de cola.
Nombre de estado	stateName	string	Filtre por nombre de estado.
Deleted	deleted	boolean	Filtre por estado eliminado.
Omitir	skip	integer	Número de registros que se van a omitir para la paginación.
Take	take	integer	Número de registros que se van a devolver.

Devoluciones

Nombre	Ruta de acceso	Tipo	Description
		array of object
id	id	integer	Identificador único de la cola.
eliminado	deleted	boolean	Si se elimina la cola.
nombre	name	string	Nombre de la cola.
description	description	string	Descripción de la cola.
visible	visible	boolean	Indica si la cola está visible.
includeInReports	includeInReports	boolean	Si se van a incluir en los informes.
creado	created	string	La marca de tiempo de la creación.
actualizado	updated	string	Marca de tiempo de la última actualización.
deletedTime	deletedTime	string	Marca de tiempo de eliminación.
divisionId	divisionId	integer	Identificador de división.
type	type	integer	Tipo de cola.
referencia	reference	string	Referencia de cola.
states	states	array of object	Estados disponibles en esta cola.
id	states.id	integer	Identificador de estado.
nombre	states.name	string	Nombre de estado.
description	states.description	string	Descripción del estado.
tagfilter	states.tagfilter	string	Filtro de etiqueta para este estado.
state	states.state	integer	Tipo de estado.
timeSavedPerItem	states.timeSavedPerItem	integer	Tiempo guardado por elemento.
includeInReports	states.includeInReports	boolean	Si se van a incluir en los informes.
responseTimeCalculationBasis	states.responseTimeCalculationBasis	integer	Base de cálculo del tiempo de respuesta.

Obtener datos adjuntos de elementos de cola

Id. de la operación:: GetItemAttachment

Recupera un archivo adjunto específico de un elemento de cola como datos codificados en base64. Use esta acción para descargar archivos adjuntos a elementos de trabajo durante la creación o el procesamiento.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de elemento de cola	queueItemId	True	string	Identificador del elemento de cola que contiene los datos adjuntos.
Identificador de datos adjuntos	attachmentId	True	string	Identificador de los datos adjuntos que se van a recuperar.
Filename	filename		string	Nombre de archivo de los datos adjuntos.

Devoluciones

response: string

Obtener elementos de cola

Id. de la operación:: GetItems

Recupera los elementos de cola en función de los criterios de filtro especificados, como el estado, las etiquetas, las fechas y los nombres de cola. Use esta acción para buscar y supervisar elementos de trabajo en las colas universales.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Clave de elemento	itemKey		string	Filtre por clave de elemento.
Attempts	attempts		integer	Filtre por número de intentos.
Aplazado antes	deferredBefore		date-time	Filtrar elementos aplazados antes de esta fecha.
Después diferido	deferredAfter		date-time	Filtrar elementos aplazados después de esta fecha.
Creado antes	createdBefore		date-time	Filtrar elementos creados antes de esta fecha.
Creado después	createdAfter		date-time	Filtrar elementos creados después de esta fecha.
Concluida antes	concludedBefore		date-time	Filtrar elementos finalizados antes de esta fecha.
Finalizado después de	concludedAfter		date-time	Filtrar elementos finalizados después de esta fecha.
Estado especificado antes	stateEnteredTimeBefore		date-time	Filtre los elementos que entraron en estado antes de esta hora.
Estado especificado después	stateEnteredTimeAfter		date-time	Filtre los elementos que entraron en estado después de este tiempo.
States	states		string	Filtre por estado de elemento de cola.
Identificadores de estado de elemento de cola	queueItemStateIds		integer	Filtre por identificadores de estado de elemento de cola.
Nombres de estado de elemento de cola	queueItemStateNames		string	Filtre por nombres de estado de elemento de cola.
Tags	tags		string	Filtre por etiquetas (separadas por comas).
Identificadores de cola	queueIds		integer	Filtre por identificadores de cola.
Nombres de cola	queueNames	True	string	Filtre por nombres de cola (obligatorio).
References	references		string	Filtre por referencias de cola.
Incluir datos de elementos	includeItemData		boolean	Si se van a incluir datos de elementos en respuesta.
Omitir	skip		integer	Número de registros que se van a omitir para la paginación.
Take	take		integer	Número de registros que se van a devolver.

Devoluciones

Nombre	Ruta de acceso	Tipo	Description
		array of object
id	id	integer	Identificador único del elemento de cola.
itemKey	itemKey	string	Clave única del elemento de cola.
Intentos	attempts	integer	Número de intentos de procesamiento.
queueId	queueId	integer	Identificador de la cola primaria.
id	state.id	integer	Identificador de estado.
nombre	state.name	string	El nombre del estado.
state	state.state	string	Valor de estado.
tags	tags	array of string	Etiquetas asociadas al elemento de cola.
creado	created	string	La marca de tiempo de la creación.
createdByVendorSessionId	createdByVendorSessionId	integer	Identificador de sesión que creó este elemento.
concluida	concluded	string	Marca de tiempo de conclusión.
Diferido	deferred	string	Marca de tiempo diferida.
test	test	boolean	Si se trata de un elemento de prueba.
bloqueado	locked	boolean	Si el elemento está bloqueado.

Obtener formulario por identificador

Id. de la operación:: GetFormById

Recupera un formulario de interacción de robot específico por su identificador único. Use esta acción para capturar los detalles, los campos y el estado actual de un formulario humano en el bucle creado por un trabajador digital.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de formulario	formId	True	string	Humano en el identificador del formulario de bucle para obtener detalles.

Devoluciones

Nombre	Ruta de acceso	Tipo	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
fecha tope	deadline	string	fecha tope
completado	completed	string	completado
título	title	string	título
introducción	intro	string	introducción
Campos	fields	string	Campos

Obtener formularios

Id. de la operación:: GetForms

Recupera una lista de formularios de interacción de robot con filtrado opcional. Use esta acción para consultar las solicitudes humanas pendientes en el bucle, comprobar su estado o buscar formularios asignados a usuarios específicos.

Parámetros

Nombre	Clave	Tipo	Description
Omitir	skip	integer	Número de registros que se van a omitir para la paginación.
Take	take	integer	Número de registros que se van a devolver.
Fecha límite antes	deadlineBefore	date-time	Filtre formularios con una fecha y hora antes de esta fecha y hora (ISO 8601).
Fecha límite después	deadlineAfter	date-time	Filtre formularios con una fecha y hora después de esta fecha y hora (ISO 8601).
Incluir completado	includeCompleted	boolean	Si se deben incluir formularios completados en los resultados.
Reclamado por identificador de usuario	claimedByUserId	integer	Filtrar formularios reclamados por un identificador de usuario específico.
Creado por identificador de tarea de flujo de trabajo	createdByWorkflowTaskId	integer	Filtrar formularios creados por un identificador de tarea de flujo de trabajo específico.

Devoluciones

Nombre	Ruta de acceso	Tipo	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
fecha tope	deadline	string	fecha tope
completado	completed	string	completado
undeferred	undeferred	boolean	undeferred

Quitar etiquetas del elemento de cola

Id. de la operación:: RemoveItemTag

Quita una o varias etiquetas de un elemento de cola. Use esta acción para actualizar la categorización de los elementos de trabajo durante el procesamiento.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de elemento de cola	queueItemId	True	string	Identificador del elemento de cola del que se van a quitar las etiquetas.
Tags	tags		string	Lista separada por comas de etiquetas que se van a quitar.

Reintentar elemento de cola

Id. de la operación:: RetryItem

Vuelva a intentar un elemento de cola específico, estableciendo sus datos en su valor original y creando un nuevo intento.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de elemento de cola	queueItemId	True	integer	Identificador de elemento de cola específico para reintentar.
Id. de estado	stateId		integer	Identificador de estado de elemento de cola pendiente específico que se va a establecer; tiene prioridad sobre el parámetro de estado.
Estado	state		string	Nombre de estado de elemento de cola pendiente específico que se va a establecer.
Id. de tarea de flujo de trabajo	workflowTaskId		integer	Identificador workflowTask.
App ID	appId		integer	Identificador de la aplicación.

Se debe detener la sesión

Id. de la operación:: IsStopRequested

Comprueba si C TWO ha solicitado una detención correcta (suave) para la sesión especificada. Use esta acción dentro de bucles para comprobar periódicamente si la sesión debe finalizar antes, lo que permite que el flujo limpie los recursos antes de detenerla.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Identificador de sesión	sessionId	True	string	Identificador de sesión de C TWO para comprobar si hay una solicitud de detención. El valor predeterminado es el identificador de sesión de la salida del desencadenador.

Devoluciones

Nombre	Ruta de acceso	Tipo	Description
isStopRequested	isStopRequested	boolean	isStopRequested

Desencadenadores

Iniciar flujo desde la solicitud de sesión con tiempo de espera	Sondea las nuevas sesiones de C TWO y desencadena el flujo con una restricción de tiempo de espera. Use este desencadenador cuando la automatización se complete dentro de un período de tiempo específico. Si la sesión supera el tiempo de espera, C TWO la controlará según su directiva de tiempo de espera.
Iniciar flujo desde la solicitud de sesión sin tiempo de espera	Sondea las nuevas sesiones de C TWO y desencadena el flujo cuando se crea una sesión para la tarea seleccionada. Use este desencadenador cuando la automatización no requiera una restricción de tiempo de espera. El flujo recibe detalles de sesión, incluidos los valores de entrada pasados desde C TWO.

Iniciar flujo desde la solicitud de sesión con tiempo de espera

Id. de la operación:: StartFlowWithTimeout

Sondea las nuevas sesiones de C TWO y desencadena el flujo con una restricción de tiempo de espera. Use este desencadenador cuando la automatización se complete dentro de un período de tiempo específico. Si la sesión supera el tiempo de espera, C TWO la controlará según su directiva de tiempo de espera.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tarea	taskId	True	integer	Seleccione la tarea C TWO que desencadenará este flujo. Cuando se crea una sesión para esta tarea, el flujo comienza con el tiempo de espera especificado aplicado.
Tiempo de espera de segundos	timeout	True	integer	Tiempo máximo en segundos que la sesión puede ejecutarse antes de que C TWO lo marque como agotado.

Devoluciones

Nombre	Ruta de acceso	Tipo	Description
sesiones	sessions	array of object	Conjunto de sesiones desencadenadas por C TWO con tiempo de espera
sessionID	sessions.sessionId	integer	sessionID
workflowTaskId	sessions.workflowTaskId	integer	workflowTaskId
workflowName	sessions.workflowName	string	workflowName
taskName	sessions.taskName	string	taskName
creado	sessions.created	string	creado
processInputValues	sessions.processInputValues	object	processInputValues

Iniciar flujo desde la solicitud de sesión sin tiempo de espera

Id. de la operación:: StartFlowWithoutTimeout

Sondea las nuevas sesiones de C TWO y desencadena el flujo cuando se crea una sesión para la tarea seleccionada. Use este desencadenador cuando la automatización no requiera una restricción de tiempo de espera. El flujo recibe detalles de sesión, incluidos los valores de entrada pasados desde C TWO.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tarea	taskId	True	integer	Seleccione la tarea C TWO que desencadenará este flujo. Cuando se crea una nueva sesión para esta tarea en C TWO, el flujo se iniciará automáticamente sin aplicar un tiempo de espera.

Devoluciones

Nombre	Ruta de acceso	Tipo	Description
sesiones	sessions	array of object	Conjunto de sesiones desencadenadas por C TWO sin tiempo de espera
sessionID	sessions.sessionId	integer	sessionID
workflowTaskId	sessions.workflowTaskId	integer	workflowTaskId
workflowName	sessions.workflowName	string	workflowName
taskName	sessions.taskName	string	taskName
creado	sessions.created	string	creado
processInputValues	sessions.processInputValues	object	processInputValues