C TWO (versión preliminar)

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á:

1. Un inquilino activo de C TWO: C TWO Cloud (hospedado) o un servidor C TWO local accesible a través de HTTPS.
2. Un token de cuenta de servicio o un token de acceso personal emitido por el administrador de C TWO (consulte Obtención de credenciales).
3. 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).
4. 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:

1. 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.
2. 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.
3. 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)

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

Token de acceso personal (desarrollo/pruebas)

1. Abra el perfil de usuario en C TWO.
2. Vaya a la pestaña Tokens de API y genere un nuevo token.
3. 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

Agregar registro a la sesión

Agregar registro al elemento de cola

Anular la asignación de formulario

Aplazar elemento de cola

Asignar formulario

Crear elemento de cola

Crear estado de elemento de cola

Crear formulario

Desbloquear elemento de cola

Elemento de cola de bloqueo

Establecer datos de elementos de cola

Establecer el estado de ejecución del flujo en Completado

Establecer el estado de ejecución del flujo en Error

Establecer el estado del elemento de cola

Establecer tiempo de espera de sesión

Formulario completo

Obtener colas

Obtener datos adjuntos de elementos de cola

Obtener elementos de cola

Obtener formulario por identificador

Obtener formularios

Quitar etiquetas del elemento de cola

Reintentar elemento de cola

Se debe detener la sesión

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

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

Definiciones

string

object