C TWO(미리 보기)

C TWO는 자동화 워크플로를 오케스트레이션하고, 인간-로봇 상호 작용을 관리하고, 유니버설 큐를 통해 작업 항목을 처리하는 에이전트 관리 플랫폼입니다. 이 커넥터를 사용하여 C TWO 세션에서 흐름을 트리거하고, 세션 수명 주기를 관리하고, 큐 항목을 만들고 처리하며, 디지털 작업자와의 휴먼 인 더 루프 상호 작용을 사용하도록 설정합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스	클래스	Regions
Copilot Studio	Premium	다음을 제외한 모든 Power Automate 지역:      - 미국 정부(GCC)      - 미국 정부(GCC High)      - 21Vianet에서 운영하는 중국 클라우드      - 미국 국방부(DoD)
논리 앱	스탠다드	다음을 제외한 모든 Logic Apps 지역 :      - Azure Government 지역      - Azure 중국 지역      - 미국 국방부(DoD)
Power Apps	Premium	다음을 제외한 모든 Power Apps 지역:      - 미국 정부(GCC)      - 미국 정부(GCC High)      - 21Vianet에서 운영하는 중국 클라우드      - 미국 국방부(DoD)
파워 오토메이트	Premium	다음을 제외한 모든 Power Automate 지역:      - 미국 정부(GCC)      - 미국 정부(GCC High)      - 21Vianet에서 운영하는 중국 클라우드      - 미국 국방부(DoD)

Contact
이름	C TWO 지원
URL	https://ctwo.com/
전자 메일	customersuccess@ctwo.com

커넥터 메타데이터
Publisher	C TWO
웹 사이트	https://ctwo.com/
개인 정보 보호 정책	https://ctwo.com/privacy-policy/
카테고리	비즈니스 인텔리전스; AI

C TWO

C TWO는 자동화 워크플로를 오케스트레이션하고, 인간-로봇 상호 작용을 관리하고, 유니버설 큐를 통해 작업 항목을 처리하는 에이전트 관리 플랫폼입니다. 이 커넥터를 사용하면 C TWO 세션에서 Power Automate, Power Apps, Azure Logic Apps 및 Copilot Studio 트리거하고, 세션 수명 주기를 관리하고, 유니버설 큐 항목을 만들고 처리하며, 디지털 작업자와의 휴먼-인-더-루프 상호 작용을 사용하도록 설정할 수 있습니다.

C TWO는 자동화 자산 위에 단일 오케스트레이션, 거버넌스 및 모니터링 계층으로 사용됩니다. 작업을 만들거나 실행하는 것이 무엇이든 간에 C TWO는 SLA 추적, 재시도 및 자체 복구, 라이브 세션 원격 분석 및 전체 감사 내역을 추가합니다.

필수 조건

연결을 만들기 전에 다음이 필요합니다.

1. 활성 C TWO 테넌트 - C TWO 클라우드(호스트됨) 또는 HTTPS를 통해 연결할 수 있는 온-프레미스 C TWO 서버.
2. C TWO 관리자가 발급한 서비스 계정 토큰 또는 개인 액세스 토큰 입니다( 자격 증명 가져오기 참조).
3. C TWO가 온-프레미스에서 호스트되는 경우 서버는 HTTPS를 통해 Power Platform에서 연결할 수 있어야 합니다(Microsoft Power Automate 아웃바운드 IP 범위(Azure 서비스 태그 AzureConnectors.<region> 및 PowerPlatformPlex Power Platform Geo를 허용하는 방화벽).
4. 사용자 지정 커넥터 권한이 있는 Power Platform 환경 및 사용자 지정 커넥터를 지원하는 라이선스 계층(Power Automate Premium 또는 해당).

연결을 만드는 중

연결을 만들 때 사용자 고유의 C TWO 환경에서 세 가지 값을 제공합니다.

1. C TWO 호스트 - C TWO 서버 호스트 이름만(체계 없음, 후행 슬래시 없음), 예: connect24.ctwo.cloud선택적 포트가 있는 온-프레미스 호스트(예: ctwo.contoso.com:8443.
2. C TWO 기본 URL - 슬래시로 시작하고 후행 슬래시 없이 나누기를 포함한 C TWO API의 기본 경로입니다. 예를 들어 /DEFAULT/CTWO.Server/api.
3. API 키 - 토큰으로 입력합니다 Bearer <your-token>. 서비스 계정 토큰을 사용하는 것이 좋습니다. 개인용 액세스 토큰도 작동합니다.

호스트 및 기본 URL은 커넥터를 고유한 C TWO 서버(https://{Host}{Base URL}/…)로 라우팅하므로 각 고객은 C TWO 클라우드 또는 온-프레미스와 같은 자체 환경에 연결합니다.

자격 증명 가져오기

인증은 헤더에서 전달자 토큰으로 전송된 Authorization API 키를 사용합니다.

서비스 계정 토큰(프로덕션에 권장)

1. C TWO 인스턴스에 로그인합니다.
2. 앱 및 연결 → Microsoft Power Automate → 서비스 계정 만들기로 이동합니다.
3. 생성된 토큰을 즉시 복사합니다. 이 토큰은 한 번만 표시됩니다.

개인용 액세스 토큰(개발/테스트)

1. C TWO에서 사용자 프로필을 엽니다.
2. API 토큰 탭으로 이동하여 새 토큰을 생성합니다.
3. 즉시 복사 - 한 번만 표시되고 사용자 계정을 사용하지 않도록 설정하면 무효화됩니다.

두 토큰 형식을 모두 비밀로 처리합니다. Power Platform 연결 자격 증명에만 저장하고 흐름 변수 또는 클라이언트 쪽 코드에는 저장하지 않습니다.

지원되는 작업

• 트리거 - C TWO가 적용된 시간 제한 유무에 관계없이 세션을 디스패치할 때 흐름을 시작합니다.
• 세션 관리 - 완료/실패 보고, 형식화된 세션 로그 작성, 세션 시간 제한 조정, 정상적인 중지 요청 확인
• 유니버설 큐 - 큐 항목 만들기, 나열, 잠금 해제, 잠금 해제, 다시 시도 및 연기 항목 데이터를 업데이트하고 항목 수준 로그를 추가합니다. 태그 추가/제거; 첨부 파일을 검색합니다. 사용자 지정 항목 상태 만들기; 큐를 나열합니다.
• 휴먼 인 더 루프 - 구조화된 사람 지원 양식을 만들고, 할당하고, 할당하지 않고, 완성하고, 검색/쿼리합니다.

내부 도우미 작업은 동적 드롭다운(작업 및 사용자 선택기)을 채우며 직접 호출되지 않습니다.

알려진 문제점 및 제한

• 올바른 호스트 및 기본 URL이 필요합니다. 둘 다 연결 시 입력되고 커넥터를 C TWO 서버로 라우팅합니다. 잘못되거나 연결할 수 없는 값으로 인해 연결 또는 요청 오류가 발생합니다.
• API 키 형식입니다. API 키 필드에는 리터럴 문자열 Bearer <token> 이 필요합니다. 접두사 결과는 생략 Bearer 됩니다 401 Unauthorized.
• JSON 항목 데이터 제공 항목 데이터 필드(Create Queue Item, Set Queue Item Data)는 JSON 개체입니다. 흐름에서 리터럴 JSON에 json('…') 식을 제공하므로 문자열이 아닌 개체로 전송됩니다.
• 폴링 트리거 대기 시간 푸시가 아닌 폴링 트리거를 실행하므로 C TWO에서 디스패치되는 세션과 흐름 시작 사이에 약간의 지연(트리거 되풀이에 의해 제한됨)이 발생합니다.
• 양식 필드 형식입니다. 양식 작업에서 반환하는 일부 식별자 필드는 폼의 상태에 따라 정수, 문자열 또는 null일 수 있습니다.

일반적인 오류 및 해결

오류	가능한 원인	해결 방법
401 Unauthorized	접두사 Bearer , 만료됨 또는 해지된 API 키가 없습니다.	자격 증명을 다시 입력합니다 Bearer <token>. 해지된 경우 새 서비스 계정 토큰 생성
400 Bad request 큐 항목 만들기	필수 필드 누락(reference, queueItemState, itemKey)	세 개의 필수 필드 모두 채우기
트리거가 발생하지 않습니다.	잘못된 작업을 선택했거나 C TWO 작업이 Power Automate 노출되지 않음	작업이 작업 ID 드롭다운에 표시되고 C TWO에서 노출된 흐름으로 구성되었는지 확인합니다.
이스케이프된 문자열로 저장된 항목 데이터	개체 대신 텍스트로 제공된 JSON	json('…') 식(흐름) 또는 원시 본문(커넥터 테스트)을 사용하여 개체로 전송되도록 합니다.

FAQ

Power Automate 아니라 Power Apps, Azure Logic Apps 및 Copilot Studio 이 커넥터를 사용할 수 있나요? Yes. 트리거는 Power Automate 고유하지만 연결이 만들어지면 이러한 플랫폼에서 모든 작업을 호출할 수 있습니다.

이 커넥터가 라이선스를 관리하나요? No. C TWO는 실행을 오케스트레이션하고 제어합니다. 고객은 자체 Microsoft 라이선스를 담당합니다.

어디에서 도움을 받을 수 있나요? 에서 C TWO 고객 성공에 customersuccess@ctwo.com문의하세요.

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

기본값	연결을 만들기 위한 매개 변수입니다.	모든 지역	공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름	Type	Description	필수
C TWO 호스트	string	C TWO 서버 호스트 이름만 "구성표 없음, 후행 슬래시 없음. 예를 들어 connect24.ctwo.cloud 또는 ctwo.contoso.com:8443 같은 선택적 포트가 있는 온-프레미스 호스트입니다.	True
C TWO 기본 URL	string	부서를 포함한 C TWO API의 기본 경로입니다. 슬래시, 후행 슬래시로 시작합니다. 예를 들어 /DEFAULT/CTWO입니다. 서버/api.	True
API 키	시큐어스트링 (보안 문자열)	C TWO API 토큰으로 입력합니다. 토큰> 전달자<. 서비스 계정 토큰을 사용하는 것이 좋습니다. 개인용 액세스 토큰도 작동합니다.	True

actions

ID로 양식 가져오기	고유 식별자를 사용하여 특정 로봇 상호 작용 형식을 검색합니다. 이 작업을 사용하여 디지털 작업자가 만든 휴먼 인 더 루프 양식의 세부 정보, 필드 및 현재 상태를 가져옵니다.
세션 시간 제한 설정	활성 C TWO 세션의 시간 제한 값을 업데이트합니다. 이 작업을 사용하여 원래 시간 제한을 조정해야 하는 경우 실행 중인 세션에 허용되는 실행 시간을 연장하거나 줄일 수 있습니다.
세션에 로그 추가	C TWO 세션에 로그 항목을 씁니다. 이 작업을 사용하여 흐름 실행 중에 진행률을 추적하거나, 결정을 기록하거나, 진단 정보를 기록합니다. 로그는 감사 및 문제 해결을 위해 C TWO 플랫폼에 표시됩니다.
세션이 중지되어야 합니다.	C TWO가 지정된 세션에 대해 정상(소프트) 중지를 요청했는지 여부를 확인합니다. 루프 내에서 이 작업을 사용하여 세션이 일찍 종료되어야 하는지 주기적으로 확인하여 흐름이 중지하기 전에 리소스를 정리할 수 있도록 합니다.
양식 가져오기	선택적 필터링을 사용하여 로봇 상호 작용 양식 목록을 검색합니다. 이 작업을 사용하여 보류 중인 휴먼 인 더 루프 요청을 쿼리하거나, 상태를 확인하거나, 특정 사용자에게 할당된 양식을 찾을 수 있습니다.
양식 만들기	디지털 작업자가 사람의 도움을 요청할 수 있는 새로운 로봇 상호 작용 양식을 만듭니다. 이 양식은 C TWO 플랫폼의 할당된 사용자에게 제공되므로 예외 또는 복잡한 결정을 처리하기 위해 인간의 전문 지식이 필요한 휴먼 인 더 루프 시나리오를 사용할 수 있습니다.
양식 할당	로봇 상호 작용 양식을 특정 사용자에게 할당하여 휴먼 인 더 루프 요청을 검토하고 완료할 책임이 있습니다.
양식 할당 취소	로봇 상호 작용 양식에서 현재 사용자 할당을 제거하여 다른 사용자가 클레임할 수 있도록 합니다.
잠금 큐 항목	다른 작업자가 동시에 처리하지 못하도록 큐 항목을 잠급니다. 작업 항목을 처리하기 전에 이 작업을 사용하여 단독 액세스를 보장합니다.
전체 양식	로봇 상호 작용 양식을 완료된 것으로 표시하여 사용자가 요청된 입력을 제공했으며 디지털 작업자가 처리를 다시 시작할 수 있음을 나타냅니다.
큐 가져오기	필터 조건에 따라 범용 큐를 검색합니다. 이 작업을 사용하여 사용 가능한 큐를 나열하거나, 해당 구성을 확인하거나, 큐 세부 정보를 조회합니다. 또한 이 작업은 다른 작업의 동적 드롭다운을 구동합니다.
큐 항목 가져오기	상태, 태그, 날짜 및 큐 이름과 같은 지정된 필터 조건에 따라 큐 항목을 검색합니다. 이 작업을 사용하여 유니버설 큐에서 작업 항목을 검색하고 모니터링합니다.
큐 항목 다시 시도	특정 큐 항목을 다시 시도하고 데이터를 원래 값으로 다시 설정하고 새 시도를 만듭니다.
큐 항목 데이터 설정	큐 항목의 데이터 콘텐츠를 업데이트합니다. 이 작업을 사용하여 처리 중에 작업 항목의 페이로드를 수정합니다(예: 중간 결과 저장).
큐 항목 만들기	지정된 유니버설 큐에 새 작업 항목을 만듭니다. 데이터 페이로드, 태그 및 선택적 파일 첨부 파일을 포함하여 디지털 작업자가 처리하기 위한 항목을 추가하려면 이 작업을 사용합니다.
큐 항목 상태 만들기	특정 큐 내에 새 사용자 지정 상태를 만듭니다. 사용자 지정 상태를 사용하면 기본 상태(보류 중, 완료됨, 참조됨)를 넘어 워크플로 단계를 정의하여 큐를 비즈니스 프로세스에 맞게 조정할 수 있습니다.
큐 항목 상태 설정	큐 항목의 상태를 변경합니다(예: 보류 중에서 완료됨으로 또는 사용자 지정 상태로). 워크플로 파이프라인을 통해 항목을 진행하려면 이 작업을 사용합니다.
큐 항목 연기	지정된 날짜/시간까지 처리되지 않도록 큐 항목을 연기합니다. 항목을 지금 처리할 수 없지만 나중에 다시 시도해야 하는 경우 이 작업을 사용합니다.
큐 항목 잠금 해제	이전에 잠긴 큐 항목의 잠금을 해제하고 사용 가능한 상태로 반환합니다. 처리가 중단되고 다른 작업자에 대해 항목을 해제해야 하는 경우 이 작업을 사용합니다.
큐 항목 첨부 파일 가져오기	큐 항목에서 특정 파일 첨부 파일을 base64로 인코딩된 데이터로 검색합니다. 이 작업을 사용하여 만들거나 처리하는 동안 작업 항목에 첨부된 파일을 다운로드합니다.
큐 항목에 로그 추가	감사 추적 및 추적 가능성을 위해 큐 항목에 로그 메시지를 추가합니다. 이 작업을 사용하여 특정 작업 항목에 대한 처리 단계, 경고 또는 오류를 기록합니다.
큐 항목에 태그 추가	분류 및 필터링을 위해 큐 항목에 하나 이상의 태그를 추가합니다. 태그는 큐에서 작업 항목을 구성하고 검색하는 데 도움이 됩니다.
큐 항목에서 태그 제거	큐 항목에서 하나 이상의 태그를 제거합니다. 처리 중에 작업 항목의 분류를 업데이트하려면 이 작업을 사용합니다.
흐름 실행 상태를 실패로 설정	C TWO 세션을 실패한 것으로 표시하여 흐름 실행 중에 오류가 발생했음을 나타냅니다. 오류 처리 범위에서 이 작업을 사용하여 오류 발생에 대한 세부 정보와 함께 오류를 C TWO에 다시 보고합니다.
흐름 실행 상태를 완료됨으로 설정	C TWO 세션을 완료된 것으로 표시하여 흐름이 작업을 성공적으로 완료했음을 나타냅니다. 이 작업을 흐름의 끝에 배치하여 오류 없이 자동화가 완료되었다는 것을 C TWO에 다시 보고합니다.

ID로 양식 가져오기

작업 ID:

GetFormById

고유 식별자를 사용하여 특정 로봇 상호 작용 형식을 검색합니다. 이 작업을 사용하여 디지털 작업자가 만든 휴먼 인 더 루프 양식의 세부 정보, 필드 및 현재 상태를 가져옵니다.

매개 변수

Name	키	필수	형식	Description
양식 ID	formId	True	string	세부 정보를 가져오는 루프 양식 ID의 사용자입니다.

반품

Name	경로	형식	Description
id	id	integer	id
divisionId	divisionId		divisionId
세션 ID	sessionId		세션 ID
queueItemId	queueItemId		queueItemId
claimedByUserId	claimedByUserId		claimedByUserId
claimedOn	claimedOn	string	claimedOn
createdByWorkflowTaskId	createdByWorkflowTaskId		createdByWorkflowTaskId
createdByUserId	createdByUserId		createdByUserId
createdOn	createdOn	string	createdOn
마감	deadline	string	마감
완료됨	completed	string	완료됨
title	title	string	title
소개	intro	string	소개
필드	fields	string	필드

세션 시간 제한 설정

작업 ID:

SetTimeout

활성 C TWO 세션의 시간 제한 값을 업데이트합니다. 이 작업을 사용하여 원래 시간 제한을 조정해야 하는 경우 실행 중인 세션에 허용되는 실행 시간을 연장하거나 줄일 수 있습니다.

매개 변수

Name	키	필수	형식	Description
세션 ID	sessionId	True	string	시간 제한을 업데이트할 C TWO 세션 ID입니다. 기본값은 트리거 출력의 세션 ID입니다.
일시 중지	timeout	True	integer	세션에 적용할 새 시간 제한 값(초)입니다.

반품

response

string

세션에 로그 추가

작업 ID:

AddLogToSession

C TWO 세션에 로그 항목을 씁니다. 이 작업을 사용하여 흐름 실행 중에 진행률을 추적하거나, 결정을 기록하거나, 진단 정보를 기록합니다. 로그는 감사 및 문제 해결을 위해 C TWO 플랫폼에 표시됩니다.

매개 변수

Name	키	필수	형식	Description
세션 ID	sessionId	True	string	로그 항목이 기록될 C TWO 세션 ID입니다. 기본값은 트리거 출력의 세션 ID입니다.
레벨	level	True	string	로그 항목의 심각도 수준입니다.
message	message	True	string	기록할 로그 메시지 콘텐츠입니다.

세션이 중지되어야 합니다.

작업 ID:

IsStopRequested

C TWO가 지정된 세션에 대해 정상(소프트) 중지를 요청했는지 여부를 확인합니다. 루프 내에서 이 작업을 사용하여 세션이 일찍 종료되어야 하는지 주기적으로 확인하여 흐름이 중지하기 전에 리소스를 정리할 수 있도록 합니다.

매개 변수

Name	키	필수	형식	Description
세션 ID	sessionId	True	string	중지 요청을 확인할 C TWO 세션 ID입니다. 기본값은 트리거 출력의 세션 ID입니다.

반품

Name	경로	형식	Description
isStopRequested	isStopRequested	boolean	isStopRequested

양식 가져오기

작업 ID:

GetForms

선택적 필터링을 사용하여 로봇 상호 작용 양식 목록을 검색합니다. 이 작업을 사용하여 보류 중인 휴먼 인 더 루프 요청을 쿼리하거나, 상태를 확인하거나, 특정 사용자에게 할당된 양식을 찾을 수 있습니다.

매개 변수

Name	키	필수	형식	Description
건너뛰기	skip		integer	페이지 매김을 위해 건너뛸 레코드 수입니다.
잡다	take		integer	반환할 레코드 수입니다.
마감일 전	deadlineBefore		date-time	이 날짜/시간(ISO 8601) 이전의 최종 기한으로 양식을 필터링합니다.
최종 기한 이후	deadlineAfter		date-time	이 날짜/시간(ISO 8601) 이후의 최종 기한으로 양식을 필터링합니다.
완료된 포함	includeCompleted		boolean	결과에 완료된 양식을 포함할지 여부입니다.
사용자 ID로 클레임됨	claimedByUserId		integer	특정 사용자 ID에서 클레임하는 폼을 필터링합니다.
워크플로 작업 ID로 생성됨	createdByWorkflowTaskId		integer	특정 워크플로 작업 ID로 만든 폼을 필터링합니다.

반품

Name	경로	형식	Description
		array of object
id	id	integer	id
divisionId	divisionId		divisionId
세션 ID	sessionId		세션 ID
queueItemId	queueItemId		queueItemId
claimedByUserId	claimedByUserId		claimedByUserId
claimedOn	claimedOn	string	claimedOn
createdByWorkflowTaskId	createdByWorkflowTaskId		createdByWorkflowTaskId
createdByUserId	createdByUserId		createdByUserId
createdOn	createdOn	string	createdOn
마감	deadline	string	마감
완료됨	completed	string	완료됨
지정되지 않음	undeferred	boolean	지정되지 않음

양식 만들기

작업 ID:

CreateForm

디지털 작업자가 사람의 도움을 요청할 수 있는 새로운 로봇 상호 작용 양식을 만듭니다. 이 양식은 C TWO 플랫폼의 할당된 사용자에게 제공되므로 예외 또는 복잡한 결정을 처리하기 위해 인간의 전문 지식이 필요한 휴먼 인 더 루프 시나리오를 사용할 수 있습니다.

매개 변수

Name	키	필수	형식	Description
필드	fields		string	사용자 사용자가 입력해야 하는 양식 필드를 정의하는 JSON 형식 문자열입니다.
title	title		string	폼을 열 때 사용자 사용자에게 표시되는 제목입니다.
마감	deadline		date-time	사람이 양식에 응답해야 하는 최종 기한입니다(ISO 8601 형식).
소개	intro		string	사용자에게 필요한 작업을 설명하는 소개 텍스트입니다.
itemId	itemId		integer	이 양식과 연결된 큐 항목 ID로, 사용자 상호 작용을 특정 작업 항목에 연결합니다.
workflowTaskId	workflowTaskId		integer	이 양식을 만든 C TWO 작업입니다.

반품

Name	경로	형식	Description
id	id	integer	id

양식 할당

작업 ID:

AssignForm

로봇 상호 작용 양식을 특정 사용자에게 할당하여 휴먼 인 더 루프 요청을 검토하고 완료할 책임이 있습니다.

매개 변수

Name	키	필수	형식	Description
양식 ID	formId	True	string	할당할 루프 양식 ID의 휴먼입니다.
userId	userId		integer	양식을 할당할 사용자의 ID입니다.

양식 할당 취소

작업 ID:

UnassignForm

로봇 상호 작용 양식에서 현재 사용자 할당을 제거하여 다른 사용자가 클레임할 수 있도록 합니다.

매개 변수

Name	키	필수	형식	Description
양식 ID	formId	True	string	할당을 취소할 루프 양식 ID의 휴먼입니다.

잠금 큐 항목

작업 ID:

LockItem

다른 작업자가 동시에 처리하지 못하도록 큐 항목을 잠급니다. 작업 항목을 처리하기 전에 이 작업을 사용하여 단독 액세스를 보장합니다.

매개 변수

Name	키	필수	형식	Description
큐 항목 ID	queueItemId		string	잠글 큐 항목의 ID입니다. 생략하면 필터와 일치하는 다음 사용 가능한 항목이 잠깁니다.
큐 이름	reference		string	항목을 잠글 큐 참조입니다.
상태 ID	stateId		string	항목을 필터링할 상태 ID입니다.
상태 이름	stateName		string	항목을 필터링할 상태 이름입니다.
세션 ID	sessionId		string	이 잠금의 세션 ID입니다.

반품

Name	경로	형식	Description
id	id	integer	잠긴 항목의 고유 식별자입니다.
itemKey	itemKey	string	잠긴 항목의 고유 키입니다.
시도	attempts	integer	처리 시도 횟수입니다.
queueId	queueId	integer	부모 큐의 식별자입니다.
id	state.id	integer	상태 식별자입니다.
name	state.name	string	상태 이름.
state	state.state	string	상태 값입니다.
tags	tags	array of string	큐 항목과 연결된 태그입니다.
만든	created	string	생성 타임스탬프.
createdByVendorSessionId	createdByVendorSessionId	integer	이 항목을 만든 세션 ID입니다.
결론	concluded	string	결론 타임스탬프입니다.
지연	deferred	string	지연된 타임스탬프입니다.
테스트	test	boolean	테스트 항목인지 여부입니다.
잠금	locked	boolean	항목이 잠겨 있는지 여부입니다.

전체 양식

작업 ID:

CompleteForm

로봇 상호 작용 양식을 완료된 것으로 표시하여 사용자가 요청된 입력을 제공했으며 디지털 작업자가 처리를 다시 시작할 수 있음을 나타냅니다.

매개 변수

Name	키	필수	형식	Description
양식 ID	formId	True	string	완료된 것으로 표시할 루프 양식 ID의 휴먼입니다.
completedAt	completedAt		date-time	양식이 완료된 타임스탬프입니다(ISO 8601 형식).

큐 가져오기

작업 ID:

GetQueues

필터 조건에 따라 범용 큐를 검색합니다. 이 작업을 사용하여 사용 가능한 큐를 나열하거나, 해당 구성을 확인하거나, 큐 세부 정보를 조회합니다. 또한 이 작업은 다른 작업의 동적 드롭다운을 구동합니다.

매개 변수

Name	키	필수	형식	Description
큐 ID	id		string	큐 ID로 필터링합니다.
큐 참조	reference		string	큐 참조로 필터링합니다.
큐 이름	name		string	큐 이름을 사용하여 필터링합니다.
상태 이름	stateName		string	상태 이름으로 필터링합니다.
삭제됨	deleted		boolean	삭제된 상태를 필터링합니다.
건너뛰기	skip		integer	페이지 매김을 위해 건너뛸 레코드 수입니다.
잡다	take		integer	반환할 레코드 수입니다.

반품

Name	경로	형식	Description
		array of object
id	id	integer	큐의 고유 식별자입니다.
삭제됨	deleted	boolean	큐가 삭제되는지 여부입니다.
name	name	string	큐의 이름입니다.
description	description	string	큐에 대한 설명입니다.
보이는	visible	boolean	큐가 표시되는지 여부입니다.
includeInReports	includeInReports	boolean	보고서에 포함할지 여부입니다.
만든	created	string	생성 타임스탬프.
업데이트	updated	string	마지막 업데이트 타임스탬프입니다.
deletedTime	deletedTime	string	삭제 타임스탬프입니다.
divisionId	divisionId	integer	나누기 식별자입니다.
type	type	integer	큐 유형입니다.
참조	reference	string	큐 참조입니다.
states	states	array of object	이 큐에서 사용할 수 있는 상태입니다.
id	states.id	integer	상태 식별자입니다.
name	states.name	string	상태 이름입니다.
description	states.description	string	상태 설명입니다.
tagfilter	states.tagfilter	string	이 상태에 대한 태그 필터입니다.
state	states.state	integer	상태 형식입니다.
timeSavedPerItem	states.timeSavedPerItem	integer	항목당 저장된 시간입니다.
includeInReports	states.includeInReports	boolean	보고서에 포함할지 여부입니다.
responseTimeCalculationBasis	states.responseTimeCalculationBasis	integer	응답 시간 계산 기준입니다.

큐 항목 가져오기

작업 ID:

GetItems

상태, 태그, 날짜 및 큐 이름과 같은 지정된 필터 조건에 따라 큐 항목을 검색합니다. 이 작업을 사용하여 유니버설 큐에서 작업 항목을 검색하고 모니터링합니다.

매개 변수

Name	키	필수	형식	Description
항목 키	itemKey		string	항목 키별로 필터링합니다.
Attempts	attempts		integer	시도 횟수를 기준으로 필터링합니다.
이전에 지연됨	deferredBefore		date-time	이 날짜 이전에 지연된 항목을 필터링합니다.
지연 후	deferredAfter		date-time	이 날짜 이후에 지연된 항목을 필터링합니다.
이전에 만든 경우	createdBefore		date-time	이 날짜 이전에 만든 항목을 필터링합니다.
만든 후	createdAfter		date-time	이 날짜 이후에 만든 항목을 필터링합니다.
이전에 완료됨	concludedBefore		date-time	이 날짜 이전에 완료된 필터 항목입니다.
종료 후	concludedAfter		date-time	이 날짜 이후에 완료된 필터 항목입니다.
이전에 입력한 상태	stateEnteredTimeBefore		date-time	이 시간 전에 상태를 입력한 항목을 필터링합니다.
다음으로 입력된 상태	stateEnteredTimeAfter		date-time	이 시간 이후에 상태가 된 항목을 필터링합니다.
States	states		string	큐 항목 상태별로 필터링합니다.
큐 항목 상태 ID	queueItemStateIds		integer	큐 항목 상태 ID별로 필터링합니다.
큐 항목 상태 이름	queueItemStateNames		string	큐 항목 상태 이름으로 필터링합니다.
Tags	tags		string	태그(쉼표로 구분)로 필터링합니다.
큐 ID	queueIds		integer	큐 ID별로 필터링합니다.
큐 이름	queueNames	True	string	큐 이름(필수)으로 필터링합니다.
참고문헌	references		string	큐 참조를 기준으로 필터링합니다.
항목 데이터 포함	includeItemData		boolean	응답에 항목 데이터를 포함할지 여부입니다.
건너뛰기	skip		integer	페이지 매김을 위해 건너뛸 레코드 수입니다.
잡다	take		integer	반환할 레코드 수입니다.

반품

Name	경로	형식	Description
		array of object
id	id	integer	큐 항목의 고유 식별자입니다.
itemKey	itemKey	string	큐 항목의 고유 키입니다.
시도	attempts	integer	처리 시도 횟수입니다.
queueId	queueId	integer	부모 큐의 식별자입니다.
id	state.id	integer	상태 식별자입니다.
name	state.name	string	상태 이름.
state	state.state	string	상태 값입니다.
tags	tags	array of string	큐 항목과 연결된 태그입니다.
만든	created	string	생성 타임스탬프.
createdByVendorSessionId	createdByVendorSessionId	integer	이 항목을 만든 세션 ID입니다.
결론	concluded	string	결론 타임스탬프입니다.
지연	deferred	string	지연된 타임스탬프입니다.
테스트	test	boolean	테스트 항목인지 여부입니다.
잠금	locked	boolean	항목이 잠겨 있는지 여부입니다.

큐 항목 다시 시도

작업 ID:

RetryItem

특정 큐 항목을 다시 시도하고 데이터를 원래 값으로 다시 설정하고 새 시도를 만듭니다.

매개 변수

Name	키	필수	형식	Description
큐 항목 ID	queueItemId	True	integer	다시 시도할 특정 큐 항목 ID입니다.
상태 ID	stateId		integer	설정할 특정 보류 중인 큐 항목 상태 ID입니다. 는 상태 매개 변수보다 우선 순위를 찍습니다.
상태	state		string	설정할 특정 보류 중인 큐 항목 상태 이름입니다.
워크플로 작업 ID	workflowTaskId		integer	WorkflowTask 식별자입니다.
App ID	appId		integer	앱 식별자입니다.

큐 항목 데이터 설정

작업 ID:

SetItemData

큐 항목의 데이터 콘텐츠를 업데이트합니다. 이 작업을 사용하여 처리 중에 작업 항목의 페이로드를 수정합니다(예: 중간 결과 저장).

매개 변수

Name	키	필수	형식	Description
큐 항목 ID	queueItemId	True	string	업데이트할 큐 항목의 ID입니다.
데이터	data		object	큐 항목에 대한 새 데이터 페이로드(JSON 개체)입니다.
생성됨	created		date-time	이 데이터의 생성 타임스탬프입니다.

큐 항목 만들기

작업 ID:

CreateItem

지정된 유니버설 큐에 새 작업 항목을 만듭니다. 데이터 페이로드, 태그 및 선택적 파일 첨부 파일을 포함하여 디지털 작업자가 처리하기 위한 항목을 추가하려면 이 작업을 사용합니다.

매개 변수

Name	키	필수	형식	Description
항목 키	itemKey	True	string	이 큐 항목(예: 청구서 번호, 사례 ID)을 식별하는 고유한 비즈니스 키입니다.
큐 항목 상태	queueItemState	True	string	큐 항목의 초기 상태(예: 보류 중)입니다.
큐 참조	reference	True	string	항목을 만들 큐 참조입니다.
지연된 날짜까지	deferredUntil		date-time	이 날짜/시간(ISO 8601 형식)까지 처리를 연기합니다.
항목 데이터	itemData		object	JSON 형식의 큐 항목에 대한 데이터 페이로드입니다.
Tags	tags		string	큐 항목에 대한 태그(쉼표로 구분).
fileName	fileName		string	첨부 파일의 이름입니다.
fileData	fileData		string	base64로 인코딩된 파일 데이터입니다.
세션 ID	sessionId		string	이 항목과 연결된 세션 ID입니다.
디바이스	device		string	이 항목을 만든 디바이스입니다.
사용자	user		string	이 항목을 만든 사용자입니다.
Automation 공급자	automationProvider		string	이 항목의 자동화 공급자입니다.

반품

Name	경로	형식	Description
id	id	integer	id
itemKey	itemKey	string	itemKey
시도	attempts	integer	시도
queueId	queueId	integer	queueId
id	state.id	integer	id
name	state.name	string	name
state	state.state	string	state
tags	tags	array of string	tags
만든	created	string	만든
createdByVendorSessionId	createdByVendorSessionId	integer	createdByVendorSessionId
결론	concluded	string	결론
지연	deferred	string	지연
테스트	test	boolean	테스트
잠금	locked	boolean	잠금

큐 항목 상태 만들기

작업 ID:

CreateItemState

특정 큐 내에 새 사용자 지정 상태를 만듭니다. 사용자 지정 상태를 사용하면 기본 상태(보류 중, 완료됨, 참조됨)를 넘어 워크플로 단계를 정의하여 큐를 비즈니스 프로세스에 맞게 조정할 수 있습니다.

매개 변수

Name	키	필수	형식	Description
이름	name		string	새 상태의 이름입니다.
응답 시간 계산	responseTimeCalculationBasis	True	string	이 상태를 입력하는 항목에 대해 응답 시간 SLA를 계산하는 방법을 결정합니다.
상태 유형	state	True	string	상태 유형(보류 중, 완료됨 또는 참조됨)입니다.
큐 ID	queueId	True	integer	이 상태를 만들 큐의 ID입니다.
Description	description		string	워크플로에서 이 상태가 나타내는 내용에 대한 설명입니다.
항목당 저장된 시간	timeSavedPerItem		integer	이 상태(초)의 항목당 저장된 시간(초)으로, ROI 보고에 사용됩니다.
항목당 생성된 값	valueGeneratedPerItem		integer	이 상태의 항목당 생성된 값으로, ROI 보고에 사용됩니다.
보고서에 포함	includeInReports		boolean	분석 및 보고서에 이 상태를 포함할지 여부입니다.

큐 항목 상태 설정

작업 ID:

SetItemState

큐 항목의 상태를 변경합니다(예: 보류 중에서 완료됨으로 또는 사용자 지정 상태로). 워크플로 파이프라인을 통해 항목을 진행하려면 이 작업을 사용합니다.

매개 변수

Name	키	필수	형식	Description
큐 항목 ID	queueItemId	True	string	업데이트할 큐 항목의 ID입니다.
상태	state		string	큐 항목의 새 상태입니다.

큐 항목 연기

작업 ID:

DeferItem

지정된 날짜/시간까지 처리되지 않도록 큐 항목을 연기합니다. 항목을 지금 처리할 수 없지만 나중에 다시 시도해야 하는 경우 이 작업을 사용합니다.

매개 변수

Name	키	필수	형식	Description
큐 항목 ID	queueItemId	True	string	연기할 큐 항목의 ID입니다.
지연된 날짜까지	deferredUntil		date-time	지연할 날짜/시간(ISO 8601 형식)입니다.

반품

response

string

큐 항목 잠금 해제

작업 ID:

UnlockItem

이전에 잠긴 큐 항목의 잠금을 해제하고 사용 가능한 상태로 반환합니다. 처리가 중단되고 다른 작업자에 대해 항목을 해제해야 하는 경우 이 작업을 사용합니다.

매개 변수

Name	키	필수	형식	Description
큐 항목 ID	queueItemId	True	string	잠금을 해제할 큐 항목의 ID입니다.

큐 항목 첨부 파일 가져오기

작업 ID:

GetItemAttachment

큐 항목에서 특정 파일 첨부 파일을 base64로 인코딩된 데이터로 검색합니다. 이 작업을 사용하여 만들거나 처리하는 동안 작업 항목에 첨부된 파일을 다운로드합니다.

매개 변수

Name	키	필수	형식	Description
큐 항목 ID	queueItemId	True	string	첨부 파일이 포함된 큐 항목의 ID입니다.
첨부 파일 ID	attachmentId	True	string	검색할 첨부 파일의 ID입니다.
Filename	filename		string	첨부 파일의 파일 이름입니다.

반품

response

string

큐 항목에 로그 추가

작업 ID:

AddItemLog

감사 추적 및 추적 가능성을 위해 큐 항목에 로그 메시지를 추가합니다. 이 작업을 사용하여 특정 작업 항목에 대한 처리 단계, 경고 또는 오류를 기록합니다.

매개 변수

Name	키	필수	형식	Description
큐 항목 ID	queueItemId	True	string	기록할 큐 항목의 ID입니다.
로그 수준	level		string	로그 항목의 심각도 수준입니다.
Message	message		string	로그 메시지 콘텐츠입니다.

큐 항목에 태그 추가

작업 ID:

AddItemTag

분류 및 필터링을 위해 큐 항목에 하나 이상의 태그를 추가합니다. 태그는 큐에서 작업 항목을 구성하고 검색하는 데 도움이 됩니다.

매개 변수

Name	키	필수	형식	Description
큐 항목 ID	queueItemId	True	string	태그를 추가할 큐 항목의 ID입니다.
Tags	tags		string	추가할 태그의 쉼표로 구분된 목록입니다.

큐 항목에서 태그 제거

작업 ID:

RemoveItemTag

큐 항목에서 하나 이상의 태그를 제거합니다. 처리 중에 작업 항목의 분류를 업데이트하려면 이 작업을 사용합니다.

매개 변수

Name	키	필수	형식	Description
큐 항목 ID	queueItemId	True	string	태그를 제거할 큐 항목의 ID입니다.
Tags	tags		string	제거할 태그의 쉼표로 구분된 목록입니다.

흐름 실행 상태를 실패로 설정

작업 ID:

SetSessionFailed

C TWO 세션을 실패한 것으로 표시하여 흐름 실행 중에 오류가 발생했음을 나타냅니다. 오류 처리 범위에서 이 작업을 사용하여 오류 발생에 대한 세부 정보와 함께 오류를 C TWO에 다시 보고합니다.

매개 변수

Name	키	필수	형식	Description
세션 ID	sessionId	True	string	실패한 것으로 표시할 C TWO 세션 ID입니다. 기본값은 트리거 출력의 세션 ID입니다.
details	details	True	string	세션이 실패하게 한 오류 또는 예외에 대한 설명입니다.

흐름 실행 상태를 완료됨으로 설정

작업 ID:

SetSessionCompleted

C TWO 세션을 완료된 것으로 표시하여 흐름이 작업을 성공적으로 완료했음을 나타냅니다. 이 작업을 흐름의 끝에 배치하여 오류 없이 자동화가 완료되었다는 것을 C TWO에 다시 보고합니다.

매개 변수

Name	키	필수	형식	Description
세션 ID	sessionId	True	string	성공적으로 완료된 것으로 표시할 C TWO 세션 ID입니다. 기본값은 트리거 출력의 세션 ID입니다.

반품

response

object

트리거

시간 제한 없이 세션 요청에서 흐름 시작	새 C TWO 세션을 폴링하고 선택한 작업에 대한 세션을 만들 때 흐름을 트리거합니다. 자동화에 시간 제한 제약 조건이 필요하지 않은 경우 이 트리거를 사용합니다. 흐름은 C TWO에서 전달된 입력 값을 포함하여 세션 세부 정보를 받습니다.
시간 제한이 있는 세션 요청의 시작 흐름	새 C TWO 세션을 폴링하고 시간 제한 제약 조건으로 흐름을 트리거합니다. 자동화가 특정 기간 내에 완료되어야 하는 경우 이 트리거를 사용합니다. 세션이 시간 제한을 초과하면 C TWO는 시간 제한 정책에 따라 세션을 처리합니다.

시간 제한 없이 세션 요청에서 흐름 시작

작업 ID:

StartFlowWithoutTimeout

새 C TWO 세션을 폴링하고 선택한 작업에 대한 세션을 만들 때 흐름을 트리거합니다. 자동화에 시간 제한 제약 조건이 필요하지 않은 경우 이 트리거를 사용합니다. 흐름은 C TWO에서 전달된 입력 값을 포함하여 세션 세부 정보를 받습니다.

매개 변수

Name	키	필수	형식	Description
작업 ID	taskId	True	integer	이 흐름을 트리거할 C TWO 작업을 선택합니다. C TWO에서 이 작업에 대한 새 세션을 만들면 시간 제한을 적용하지 않고 흐름이 자동으로 시작됩니다.

반품

Name	경로	형식	Description
sessions	sessions	array of object	시간 제한 없이 C TWO에 의해 트리거되는 세션 집합
세션 ID	sessions.sessionId	integer	세션 ID
workflowTaskId	sessions.workflowTaskId	integer	workflowTaskId
workflowName	sessions.workflowName	string	workflowName
태스크명	sessions.taskName	string	태스크명
만든	sessions.created	string	만든
processInputValues	sessions.processInputValues	object	processInputValues

시간 제한이 있는 세션 요청의 시작 흐름

작업 ID:

StartFlowWithTimeout

새 C TWO 세션을 폴링하고 시간 제한 제약 조건으로 흐름을 트리거합니다. 자동화가 특정 기간 내에 완료되어야 하는 경우 이 트리거를 사용합니다. 세션이 시간 제한을 초과하면 C TWO는 시간 제한 정책에 따라 세션을 처리합니다.

매개 변수

Name	키	필수	형식	Description
작업 ID	taskId	True	integer	이 흐름을 트리거할 C TWO 작업을 선택합니다. 이 작업에 대한 세션을 만들면 흐름이 지정된 시간 제한 적용으로 시작됩니다.
초 시간 제한	timeout	True	integer	C TWO가 시간 초과로 표시하기 전에 세션을 실행할 수 있는 최대 시간(초)입니다.

반품

Name	경로	형식	Description
sessions	sessions	array of object	시간 제한이 있는 C TWO에 의해 트리거되는 세션 집합
세션 ID	sessions.sessionId	integer	세션 ID
workflowTaskId	sessions.workflowTaskId	integer	workflowTaskId
workflowName	sessions.workflowName	string	workflowName
태스크명	sessions.taskName	string	태스크명
만든	sessions.created	string	만든
processInputValues	sessions.processInputValues	object	processInputValues

정의

string

기본 데이터 형식 'string'입니다.

object

'object' 형식입니다.