다음을 통해 공유

Luware Nimbus

Nimbus Contact Center 및 엔터프라이즈 라우팅 사용이 허가된 서비스를 위한 커넥터는 Nimbus를 타사 시스템과 빠르게 연결합니다. 커넥터는 트리거 이벤트를 수신 대기하고 반응하여 흐름 작업(예: 외부 시스템에서 데이터를 검색하고 Nimbus 매개 변수에 저장하여 나중에 Nimbus 워크플로 내에서 사용할 수 있도록)을 추적할 수 있습니다.

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

서비스 클래스 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)
Power Automate Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 Luware Helpdesk
URL https://helpdesk.luware.cloud/
전자 메일 nimbus.support@luware.com
커넥터 메타데이터
게시자 Luware
웹 사이트 https://luware.com/
개인 정보 취급 방침 https://luware.com/en/privacy-policy/
카테고리 통신; 합작

Luware Nimbus 커넥터를 사용하면 Nimbus와 타사 소프트웨어(예: CRM 또는 티켓 시스템)를 통합할 수 있습니다. 이를 통해 Luware Nimbus에서 발생하는 작업 및 스케줄러 항목 이벤트를 들을 수 있습니다. 작업을 만들거나, 호출자 정보 데이터를 사용하여 기존 작업을 보강하거나, 라우팅 매개 변수를 추가하거나, 타사 시스템에서 이벤트를 트리거할 수 있습니다. 또한 주소록을 관리하거나, 아웃바운드 호출을 예약하거나, 외부 작업을 추가할 수 있습니다.

일부 사용 사례는 다음과 같습니다.

  • 인바운드 통화에 대한 연락처 세부 정보를 Nimbus에 표시합니다.
  • Nimbus의 IVR에서 CRM으로 언어 선택을 유지합니다.
  • CRM에서 호출 후 호출 후 작업 항목을 만듭니다.
  • CRM에서 부재 중 호출에 대한 콜백 작업을 만듭니다.
  • CRM의 캠페인을 기반으로 Nimbus 아웃바운드 호출을 만듭니다.
  • 고객 기본 설정에 따라 통화를 라우팅합니다.
  • 인바운드 호출에 대한 호출자 기본 설정을 표시합니다.
  • 타사 시스템에서 티켓을 만듭니다.
  • 타사 시스템에서 부재 중 호출 목록을 만듭니다.
  • 에이전트가 전화를 걸 때 고객의 레코드를 엽니다.

Luware 기술 자료에 대한 자세한 내용과 많은 도움말을 확인하세요. https://help.luware.com/nimbus-power-automate-connector

필수 조건

  • "프리미엄" 계층을 사용하는 Microsoft PowerApps 또는 PowerAutomate 플랜
  • Azure 테넌트
  • 하나 이상의 Luware Nimbus 서비스가 프로비전됨
  • Luware Nimbus 커넥터를 사용할 수 있도록 하는 Luware Nimbus의 역할(https://help.luware.com/power-automate-roles)

보안 연결을 설정하는 방법

Nimbus API는 위임된 권한을 사용하여 AAD(Azure Active Directory) /Microsoft Entra ID를 통해 보호됩니다. 테넌트 관리자는 커넥터가 Luware Nimbus에 안전하게 액세스할 수 있도록 "Luware Nimbus 로그인" 애플리케이션에 대해 이러한 권한을 부여해야 합니다. 대부분의 경우 이러한 권한은 이미 Nimbus를 온보딩하는 동안 부여되었으며 다시 확인되지 않아도 됩니다.

이 단계가 완료되면 Nimbus 클러스터에 대한 연결을 설정하여 커넥터를 사용할 수 있습니다. Nimbus 설치와 동일한 클러스터 위치를 선택해야 합니다. 이에 대해 확실하지 않은 경우 Nimbus 관리에 로그인하여 리디렉션될 클러스터를 확인합니다.

커넥터 시작

  1. Luware Nimbus 트리거에서 "태스크가 상태를 변경하는 경우" 트리거를 선택합니다.
  2. 수신 전화를 수신 대기할 Nimbus 서비스를 구성합니다.
  3. "시스템 수락됨" 이벤트를 선택합니다(워크플로의 "대화 수락" 활동에 도달할 때 트리거됨).
  4. CRM 또는 Sharepoint에서 호스트되는 Excel 시트의 테스트 목적으로 발신자 전화 번호를 기반으로 발신자 정보의 조회를 구현합니다.
  5. 작업 "업데이트 작업"을 사용하여 작업에 대한 이름/성, 주소, 도시, 국가 등과 같은 고객 정보를 설정합니다.

기술 자료에 대한 사용 사례 섹션을 참조하세요. https://help.luware.com/power-automate-use-cases

알려진 문제 및 제한 사항

  • Luware Nimbus의 RBAC(사용 권한 손실)는 최종 사용자에 대한 투명한 정보 없이 전원 자동화에서 트리거를 사용하지 않도록 설정합니다. 흐름은 더 이상 트리거되지 않습니다.
  • Luware는 흐름의 실행 시간에 영향을 주지 않으므로 결과가 지연되어 Nimbus에 다시 도착할 수 있습니다. 흐름의 완료에 따라 워크플로는 이 제한을 염두에 두고 빌드해야 합니다.

일반적인 오류 및 해결

HTTP 오류 코드:

  • 400: Luware Nimbus API에 보낸 요청에 유효한 매개 변수가 없거나 적용할 수 없습니다. 예: 전달된 기본 설정 사용자가 모두 유효하지 않으므로 기본 설정 사용자가 설정되지 않았거나 사용자에게 이미 할당된 외부 작업을 삭제하려고 합니다.
  • 401: 제공된 인증 토큰을 구문 분석할 수 없거나 유효하지 않습니다. Azure AD/Entra ID 애플리케이션 등록의 올바른 설정을 확인하고 O365 계정에 대한 올바른 자격 증명을 제공했는지 확인합니다.
  • 403: 사용자 계정에 흐름에 구성된 작업을 수행하는 데 필요한 Nimbus 권한이 없습니다. 추가 역할/권한이 필요한 경우 기술 자료를 참조하고 관리자에게 문의하세요.
  • 404: 전달된 식별자는 백 엔드의 엔터티와 일치시킬 수 없습니다.

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.
기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

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

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

이름 유형 Description 필수
위치 문자열 테넌트가 있는 위치입니다. 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

가상 사용자 도우미 데이터 가져오기

선택한 서비스 세션에 대한 가상 사용자 도우미 데이터를 반환합니다.
모든 스케줄러 항목 가져오기

지정된 서비스에 대한 모든 스케줄러 항목을 반환합니다.
새 아웃바운드 호출 예약

새 아웃바운드 호출(스케줄러 항목)을 예약합니다.
새 외부 작업 추가

새 외부 작업 추가
스케줄러 항목 업데이트

이미 만든 스케줄러 항목에 대한 설정을 변경합니다.
스케줄러 항목 제거

시스템에서 스케줄러 항목을 제거합니다. 스케줄러 항목이 아직 진행되지 않은 동안에만 가능합니다.
영업 시간 가져오기

서비스 영업 시간 가져오기: 지정된 시간에 서비스의 상태(열기, 닫힘, 휴일 등)를 반환합니다.
외부 작업 제거

외부 작업 제거
워크플로 스케줄러 항목을 사용하여 아웃바운드 호출 업데이트

워크플로 스케줄러 항목을 사용하여 이미 만든 아웃바운드 호출에 대한 설정을 변경합니다.
워크플로를 사용하여 새 아웃바운드 호출 예약

워크플로(스케줄러 항목)를 사용하여 새 아웃바운드 호출을 예약합니다.
작업 업데이트

진행 중인 작업에 대한 고객 정보, 컨텍스트 매개 변수 및/또는 기본 설정 사용자 설정을 업데이트합니다.
주소록 비우기

지정한 주소록의 모든 연락처를 제거합니다.
주소록에 연락처 추가

특정 주소록에 새 연락처를 추가합니다. ExternalId는 추가 요청에서 참조로 사용됩니다.
주소록에서 연락처 가져오기

주소록에서 연락처를 반환합니다.
주소록에서 연락처 업데이트

지정된 주소록에서 단일 연락처를 업데이트합니다.
주소록에서 연락처 제거

주소록에서 하나 이상의 연락처를 제거합니다.

가상 사용자 도우미 데이터 가져오기

작업 ID:
GetVirtualUserAssistantData

선택한 서비스 세션에 대한 가상 사용자 도우미 데이터를 반환합니다.

매개 변수

Name 키 필수 형식 Description
서비스 세션 ID
 serviceSessionId True string

가상 사용자 도우미 데이터를 반환해야 하는 서비스 세션의 ID입니다.
사용자 세션 ID
 userSessionId string

가상 사용자 도우미 데이터를 반환해야 하는 사용자 세션의 ID입니다.
데이터 형식
 dataType True string

서비스 세션에 대해 반환해야 하는 데이터 형식입니다.

반환

이 작업의 출력은 동적입니다.

모든 스케줄러 항목 가져오기

작업 ID:
GetSchedulerEntries

지정된 서비스에 대한 모든 스케줄러 항목을 반환합니다.

매개 변수

Name 키 필수 형식 Description
서비스 UPN
 serviceUpn True string

스케줄러 항목을 반환해야 하는 서비스의 UPN입니다.

반환

지정된 서비스에 대해 예약된 모든 작업 목록

예약된 작업
array of SchedulerEntryEventData

새 아웃바운드 호출 예약

작업 ID:
CreateSchedulerEntry

새 아웃바운드 호출(스케줄러 항목)을 예약합니다.

매개 변수

Name 키 필수 형식 Description
참조 ID
 ReferenceId string

타사 시스템에서 전달한 참조의 ID입니다.
목적지
 destination True string

방향이 "아웃바운드"인 스케줄러 항목의 대상입니다.
배포 우선 순위
distributionPriority string

Nimbus에서 작업을 처리해야 하는 우선 순위입니다.
기한(UTC)
 dueDateTimeUtc True date-time

UTC의 기한 및 시간: 예: '2020-03-23T11:00:00Z'.
서비스 UPN
 serviceUpn True string

서비스의 UPN입니다.
최대 시도 수
 maxAttempts integer

대상에 도달하려는 최대 시도 수입니다.
시도 시간 제한(초)
 attemptTimeoutInSeconds integer

최대 시도 횟수에 도달할 때까지 연결 재시도 사이의 시간 제한(간격)입니다.
최대 큐 시간(초)
 maxQueueTimeInSeconds integer

작업이 제한에 도달한 것으로 간주될 때까지 Nimbus가 작업을 해결하려고 시도하는 기간을 정의합니다.
RONA 시간 제한(초)
 ronaTimeoutInSeconds integer

작업이 RONA로 간주되고 새 사용자가 선택될 때까지 Nimbus가 사용자에게 도달하는 기간을 정의합니다.
이름
 name True string

사용자 지정 컨텍스트 매개 변수의 이름입니다.
가치
 value string

사용자 지정 컨텍스트 매개 변수의 값입니다.
고객 이름
 firstName string

고객의 이름입니다.
고객 성
 lastName string

고객의 성입니다.
고객 표시 이름
 displayName string

고객의 표시 이름입니다.
고객 회사
 company string

고객의 회사입니다.
고객 직호
 jobTitle string

고객의 직호입니다.
고객 부서
 department string

고객 부서입니다.
고객 주소
 streetAddress string

고객의 주소입니다.
고객 우편 번호
 postCode string

고객의 우편 번호입니다.
고객 도시
 city string

고객의 도시입니다.
고객 상태
 state string

고객의 상태입니다.
고객 국가
 country string

고객의 국가입니다.
고객 기본 전화 번호
 primaryTelNumber string

고객의 기본 전화 번호입니다.
이름
 name True string

전화 번호의 지정입니다.
가치
 value string

전화 번호의 값입니다.
고객 UPN
 UPN string

고객의 UPN입니다.
고객 메신저 주소
 imAddress string

고객의 IM 주소입니다.
고객 이메일
 email string

고객의 전자 메일입니다.
이름
 name True string

사용자 지정 필드의 지정입니다.
가치
 value string

사용자 지정 필드의 값입니다.

반환

몸
SchedulerEntryEventData

새 외부 작업 추가

작업 ID:
AddExternalTask

새 외부 작업 추가

매개 변수

Name 키 필수 형식 Description
서비스 UPN
 serviceUpn True string

서비스의 UPN입니다.
고객 식별자
 customerIdentifier string

선택적 고유 보고 식별자입니다. 비어 있는 경우 익명입니다.
고객 이름
 firstName string

고객의 이름입니다.
고객 성
 lastName string

고객의 성입니다.
고객 표시 이름
 displayName string

고객의 표시 이름입니다.
고객 회사
 company string

고객의 회사입니다.
고객 직호
 jobTitle string

고객의 직호입니다.
고객 부서
 department string

고객 부서입니다.
고객 주소
 streetAddress string

고객의 주소입니다.
고객 우편 번호
 postCode string

고객의 우편 번호입니다.
고객 도시
 city string

고객의 도시입니다.
고객 상태
 state string

고객의 상태입니다.
고객 국가
 country string

고객의 국가입니다.
고객 기본 전화 번호
 primaryTelNumber string

고객의 기본 전화 번호입니다.
이름
 name True string

전화 번호의 지정입니다.
가치
 value string

전화 번호의 값입니다.
고객 UPN
 UPN string

고객의 UPN입니다.
고객 메신저 주소
 imAddress string

고객의 IM 주소입니다.
고객 이메일
 email string

고객의 전자 메일입니다.
이름
 name True string

사용자 지정 필드의 지정입니다.
가치
 value string

사용자 지정 필드의 값입니다.
이름
 name True string

사용자 지정 컨텍스트 매개 변수의 이름입니다.
가치
 value string

사용자 지정 컨텍스트 매개 변수의 값입니다.
배포 우선 순위
 distributionPriority string

작업이 기한이 되면 Nimbus에서 작업을 처리해야 하는 우선 순위입니다.
UPN
 upn True string

기본 설정 사용자의 UPN입니다.
Priority
 priority integer

우선 순위입니다. 1 높은 99 낮은.

반환

몸
ExternalTaskWriteResult

스케줄러 항목 업데이트

작업 ID:
UpdateSchedulerEntry

이미 만든 스케줄러 항목에 대한 설정을 변경합니다.

매개 변수

Name 키 필수 형식 Description
Scheduler 항목 ID
 SchedulerEntryID True string

업데이트할 스케줄러 항목의 ID입니다.
참조 ID
 ReferenceId string

타사 시스템에서 전달한 참조의 ID입니다.
목적지
 destination True string

방향이 "아웃바운드"인 스케줄러 항목의 대상입니다.
배포 우선 순위
distributionPriority string

Nimbus에서 작업을 처리해야 하는 우선 순위입니다.
기한(UTC)
 dueDateTimeUtc True date-time

UTC의 기한 및 시간: 예: '2020-03-23T11:00:00Z'.
서비스 UPN
 serviceUpn True string

서비스의 UPN입니다.
최대 시도 수
 maxAttempts integer

대상에 도달하려는 최대 시도 수입니다.
시도 시간 제한(초)
 attemptTimeoutInSeconds integer

최대 시도 횟수에 도달할 때까지 연결 재시도 사이의 시간 제한(간격)입니다.
최대 큐 시간(초)
 maxQueueTimeInSeconds integer

작업이 제한에 도달한 것으로 간주될 때까지 Nimbus가 작업을 해결하려고 시도하는 기간을 정의합니다.
RONA 시간 제한(초)
 ronaTimeoutInSeconds integer

작업이 RONA로 간주되고 새 사용자가 선택될 때까지 Nimbus가 사용자에게 도달하는 기간을 정의합니다.
이름
 name True string

사용자 지정 컨텍스트 매개 변수의 이름입니다.
가치
 value string

사용자 지정 컨텍스트 매개 변수의 값입니다.
고객 이름
 firstName string

고객의 이름입니다.
고객 성
 lastName string

고객의 성입니다.
고객 표시 이름
 displayName string

고객의 표시 이름입니다.
고객 회사
 company string

고객의 회사입니다.
고객 직호
 jobTitle string

고객의 직호입니다.
고객 부서
 department string

고객 부서입니다.
고객 주소
 streetAddress string

고객의 주소입니다.
고객 우편 번호
 postCode string

고객의 우편 번호입니다.
고객 도시
 city string

고객의 도시입니다.
고객 상태
 state string

고객의 상태입니다.
고객 국가
 country string

고객의 국가입니다.
고객 기본 전화 번호
 primaryTelNumber string

고객의 기본 전화 번호입니다.
이름
 name True string

전화 번호의 지정입니다.
가치
 value string

전화 번호의 값입니다.
고객 UPN
 UPN string

고객의 UPN입니다.
고객 메신저 주소
 imAddress string

고객의 IM 주소입니다.
고객 이메일
 email string

고객의 전자 메일입니다.
이름
 name True string

사용자 지정 필드의 지정입니다.
가치
 value string

사용자 지정 필드의 값입니다.

반환

몸
SchedulerEntryEventData

스케줄러 항목 제거

작업 ID:
DeleteSchedulerEntry

시스템에서 스케줄러 항목을 제거합니다. 스케줄러 항목이 아직 진행되지 않은 동안에만 가능합니다.

매개 변수

Name 키 필수 형식 Description
Scheduler 항목 ID
SchedulerEntryID True string

제거할 스케줄러 항목의 ID입니다.

영업 시간 가져오기

작업 ID:
GetOpeningHours

서비스 영업 시간 가져오기: 지정된 시간에 서비스의 상태(열기, 닫힘, 휴일 등)를 반환합니다.

매개 변수

Name 키 필수 형식 Description
서비스 UPN
 serviceUpn True string

상태를 확인할 서비스의 UPN입니다.
기한(UTC)
 time date-time

UTC의 기한 및 시간: 예: '2020-03-23T11:00:00Z'.

반환

서비스의 상태(열기, 닫힘 등)입니다.

response
CalendarStatus

외부 작업 제거

작업 ID:
RemoveExternalTask

외부 작업 제거

매개 변수

Name 키 필수 형식 Description
외부 작업 ID
 externalTaskId True string

제거되는 외부 작업의 ID

워크플로 스케줄러 항목을 사용하여 아웃바운드 호출 업데이트

작업 ID:
UpdateOutboundCallWithWorkflowSchedulerEntry

워크플로 스케줄러 항목을 사용하여 이미 만든 아웃바운드 호출에 대한 설정을 변경합니다.

매개 변수

Name 키 필수 형식 Description
Scheduler 항목 ID
 SchedulerEntryID True string

업데이트할 스케줄러 항목의 ID입니다.
참조 ID
 ReferenceId string

타사 시스템에서 전달한 참조의 ID입니다.
목적지
 destination True string

워크플로를 사용한 아웃바운드 호출의 대상입니다.
기한(UTC)
 dueDateTimeUtc True date-time

UTC의 기한 및 시간: 예: '2020-03-23T11:00:00Z'.
서비스 UPN
 serviceUpn True string

서비스의 UPN입니다.
최대 시도 수
 maxAttempts integer

대상에 도달하려는 최대 시도 수입니다.
시도 시간 제한(초)
 attemptTimeoutInSeconds integer

Nimbus가 시도를 중지하기 전에 대상에 도달하려고 시도하는 기간을 정의합니다.
이름
 name True string

사용자 지정 컨텍스트 매개 변수의 이름입니다.
가치
 value string

사용자 지정 컨텍스트 매개 변수의 값입니다.
고객 이름
 firstName string

고객의 이름입니다.
고객 성
 lastName string

고객의 성입니다.
고객 표시 이름
 displayName string

고객의 표시 이름입니다.
고객 회사
 company string

고객의 회사입니다.
고객 직호
 jobTitle string

고객의 직호입니다.
고객 부서
 department string

고객 부서입니다.
고객 주소
 streetAddress string

고객의 주소입니다.
고객 우편 번호
 postCode string

고객의 우편 번호입니다.
고객 도시
 city string

고객의 도시입니다.
고객 상태
 state string

고객의 상태입니다.
고객 국가
 country string

고객의 국가입니다.
고객 기본 전화 번호
 primaryTelNumber string

고객의 기본 전화 번호입니다.
이름
 name True string

전화 번호의 지정입니다.
가치
 value string

전화 번호의 값입니다.
고객 UPN
 UPN string

고객의 UPN입니다.
고객 메신저 주소
 imAddress string

고객의 IM 주소입니다.
고객 이메일
 email string

고객의 전자 메일입니다.
이름
 name True string

사용자 지정 필드의 지정입니다.
가치
 value string

사용자 지정 필드의 값입니다.

반환

몸
OutboundCallWithWorkflowSchedulerEntryEventData

워크플로를 사용하여 새 아웃바운드 호출 예약

작업 ID:
CreateOutboundCallWithWorkflowSchedulerEntry

워크플로(스케줄러 항목)를 사용하여 새 아웃바운드 호출을 예약합니다.

매개 변수

Name 키 필수 형식 Description
참조 ID
 ReferenceId string

타사 시스템에서 전달한 참조의 ID입니다.
목적지
 destination True string

워크플로를 사용한 아웃바운드 호출의 대상입니다.
기한(UTC)
 dueDateTimeUtc True date-time

UTC의 기한 및 시간: 예: '2020-03-23T11:00:00Z'.
서비스 UPN
 serviceUpn True string

서비스의 UPN입니다.
최대 시도 수
 maxAttempts integer

대상에 도달하려는 최대 시도 수입니다.
시도 시간 제한(초)
 attemptTimeoutInSeconds integer

Nimbus가 시도를 중지하기 전에 대상에 도달하려고 시도하는 기간을 정의합니다.
이름
 name True string

사용자 지정 컨텍스트 매개 변수의 이름입니다.
가치
 value string

사용자 지정 컨텍스트 매개 변수의 값입니다.
고객 이름
 firstName string

고객의 이름입니다.
고객 성
 lastName string

고객의 성입니다.
고객 표시 이름
 displayName string

고객의 표시 이름입니다.
고객 회사
 company string

고객의 회사입니다.
고객 직호
 jobTitle string

고객의 직호입니다.
고객 부서
 department string

고객 부서입니다.
고객 주소
 streetAddress string

고객의 주소입니다.
고객 우편 번호
 postCode string

고객의 우편 번호입니다.
고객 도시
 city string

고객의 도시입니다.
고객 상태
 state string

고객의 상태입니다.
고객 국가
 country string

고객의 국가입니다.
고객 기본 전화 번호
 primaryTelNumber string

고객의 기본 전화 번호입니다.
이름
 name True string

전화 번호의 지정입니다.
가치
 value string

전화 번호의 값입니다.
고객 UPN
 UPN string

고객의 UPN입니다.
고객 메신저 주소
 imAddress string

고객의 IM 주소입니다.
고객 이메일
 email string

고객의 전자 메일입니다.
이름
 name True string

사용자 지정 필드의 지정입니다.
가치
 value string

사용자 지정 필드의 값입니다.

반환

몸
OutboundCallWithWorkflowSchedulerEntryEventData

작업 업데이트

작업 ID:
UpdateTask

진행 중인 작업에 대한 고객 정보, 컨텍스트 매개 변수 및/또는 기본 설정 사용자 설정을 업데이트합니다.

매개 변수

Name 키 필수 형식 Description
작업 ID
 taskId True string

작업의 Nimbus 특정 ID입니다.
고객 이름
 firstName string

고객의 이름입니다.
고객 성
 lastName string

고객의 성입니다.
고객 표시 이름
 displayName string

고객의 표시 이름입니다.
고객 회사
 company string

고객의 회사입니다.
고객 직호
 jobTitle string

고객의 직호입니다.
고객 부서
 department string

고객 부서입니다.
고객 주소
 streetAddress string

고객의 주소입니다.
고객 우편 번호
 postCode string

고객의 우편 번호입니다.
고객 도시
 city string

고객의 도시입니다.
고객 상태
 state string

고객의 상태입니다.
고객 국가
 country string

고객의 국가입니다.
고객 기본 전화 번호
 primaryTelNumber string

고객의 기본 전화 번호입니다.
이름
 name True string

전화 번호의 지정입니다.
가치
 value string

전화 번호의 값입니다.
고객 UPN
 UPN string

고객의 UPN입니다.
고객 메신저 주소
 imAddress string

고객의 IM 주소입니다.
고객 이메일
 email string

고객의 전자 메일입니다.
이름
 name True string

사용자 지정 필드의 지정입니다.
가치
 value string

사용자 지정 필드의 값입니다.
이름
 name True string

사용자 지정 컨텍스트 매개 변수의 이름입니다.
가치
 value string

사용자 지정 컨텍스트 매개 변수의 값입니다.
UPN
 upn True string

기본 설정 사용자의 UPN입니다.
Priority
 priority integer

우선 순위입니다. 1 높은 99 낮은.
서비스 세션 ID
 serviceSessionId string

서비스 세션의 ID입니다.
사용자 세션 ID
 userSessionId string

사용자 세션의 ID입니다.

주소록 비우기

작업 ID:
ClearContacts

지정한 주소록의 모든 연락처를 제거합니다.

매개 변수

Name 키 필수 형식 Description
주소록
 AddressBook True string

비울 주소록

주소록에 연락처 추가

작업 ID:
AddContact

특정 주소록에 새 연락처를 추가합니다. ExternalId는 추가 요청에서 참조로 사용됩니다.

매개 변수

Name 키 필수 형식 Description
주소록
 AddressBook True string

연락처를 추가할 주소록입니다.
외부 ID에 문의
 externalId True string

외부 시스템에서 제공한 연락처의 ID입니다.
연락처 이름
 firstName string

연락처의 이름입니다.
연락처 성
 lastName string

연락처의 성입니다.
연락처 표시 이름
 displayName string

연락처의 표시 이름입니다.
연락처 이니셜
 initials string

연락처의 이니셜입니다.
회사 문의
 company string

연락처의 회사입니다.
부서에 문의
 department string

연락처의 부서입니다.
연락처 직호
 jobTitle string

연락처의 직호입니다.
사용자 계정 이름에 문의
 userPrincipalName string

연락처의 사용자 계정 이름입니다.
대화 상대 메신저 주소
 imAddresses array of string

IM 주소 목록입니다.
연락처 전자 메일 주소
 emailAddresses array of string

전자 메일 주소 목록입니다.
회사 전화 문의
 businessPhones array of string

회사 전화 목록입니다.
휴대폰에 문의
 mobilePhones array of string

휴대폰 목록입니다.
집 전화 문의
 homePhones array of string

집 전화 목록입니다.
주소 거리
 street string

주소의 거리 및 번호입니다.
주소 도시
 city string

주소의 구/군/시입니다.
주소 국가
 country string

주소의 국가입니다.
주소 상태
 state string

주소의 상태입니다.
주소 우편 번호
 postalCode string

주소의 우편 번호입니다.
이름
 name True string

사용자 지정 필드의 지정입니다.
가치
 value string

사용자 지정 필드의 값입니다.

반환

몸
ContactReadDto

주소록에서 연락처 가져오기

작업 ID:
GetContacts

주소록에서 연락처를 반환합니다.

매개 변수

Name 키 필수 형식 Description
주소록
 AddressBook True string

연락처를 가져올 주소록입니다.
ExternalId
 externalIds array

가져올 연락처의 외부 ID입니다. 선택 사항: 제공되지 않은 경우 모든 연락처가 반환됩니다.

반환

반환된 연락처입니다.

연락처
array of ContactReadDto

주소록에서 연락처 업데이트

작업 ID:
UpdateContact

지정된 주소록에서 단일 연락처를 업데이트합니다.

매개 변수

Name 키 필수 형식 Description
주소록
 AddressBook True string

연락처를 업데이트할 주소록입니다.
외부 ID에 문의
 externalId True string

외부 시스템에서 제공한 연락처의 ID입니다.
연락처 이름
 firstName string

연락처의 이름입니다.
연락처 성
 lastName string

연락처의 성입니다.
연락처 표시 이름
 displayName string

연락처의 표시 이름입니다.
연락처 이니셜
 initials string

연락처의 이니셜입니다.
회사 문의
 company string

연락처의 회사입니다.
부서에 문의
 department string

연락처의 부서입니다.
연락처 직호
 jobTitle string

연락처의 직호입니다.
사용자 계정 이름에 문의
 userPrincipalName string

연락처의 사용자 계정 이름입니다.
대화 상대 메신저 주소
 imAddresses array of string

IM 주소 목록입니다.
연락처 전자 메일 주소
 emailAddresses array of string

전자 메일 주소 목록입니다.
회사 전화 문의
 businessPhones array of string

회사 전화 목록입니다.
휴대폰에 문의
 mobilePhones array of string

휴대폰 목록입니다.
집 전화 문의
 homePhones array of string

집 전화 목록입니다.
주소 거리
 street string

주소의 거리 및 번호입니다.
주소 도시
 city string

주소의 구/군/시입니다.
주소 국가
 country string

주소의 국가입니다.
주소 상태
 state string

주소의 상태입니다.
주소 우편 번호
 postalCode string

주소의 우편 번호입니다.
이름
 name True string

사용자 지정 필드의 지정입니다.
가치
 value string

사용자 지정 필드의 값입니다.

반환

몸
ContactReadDto

주소록에서 연락처 제거

작업 ID:
RemoveContacts

주소록에서 하나 이상의 연락처를 제거합니다.

매개 변수

Name 키 필수 형식 Description
주소록
 AddressBook True string

연락처를 제거할 주소록입니다.
externalIds
 externalIds True array of string

트리거

가상 사용자 도우미에 업데이트가 있는 경우

이 이벤트는 가상 사용자 도우미에 새 업데이트가 있을 때 트리거됩니다.
스케줄러 항목이 상태를 변경하는 경우

필터 조건과 일치하는 스케줄러 항목이 상태를 변경할 때마다 발생합니다.
태스크가 상태를 변경하는 경우

필터 조건과 일치하는 작업이 상태를 변경할 때마다 발생합니다.

가상 사용자 도우미에 업데이트가 있는 경우

작업 ID:
RegisterVirtualUserAssistantTrigger

이 이벤트는 가상 사용자 도우미에 새 업데이트가 있을 때 트리거됩니다.

매개 변수

Name 키 필수 형식 Description
Services
 services True array of string

태스크에 대한 이벤트를 페치해야 하는 서비스의 UPN입니다.
가상 사용자 도우미 이벤트
 virtualUserAssistantEvents True array of string

이 트리거를 발생시켜야 하는 가상 사용자 도우미의 이벤트입니다.

반환

몸
VirtualUserAssistantEventData

스케줄러 항목이 상태를 변경하는 경우

작업 ID:
RegisterSchedulerEntryTrigger

필터 조건과 일치하는 스케줄러 항목이 상태를 변경할 때마다 발생합니다.

매개 변수

Name 키 필수 형식 Description
Services
 services True array of string

태스크에 대한 이벤트를 페치해야 하는 서비스의 UPN입니다.
Scheduler 항목 이벤트
 schedulerEntryEvents True array of string

이 트리거를 발생시켜야 하는 스케줄러 항목의 이벤트입니다.

반환

몸
SchedulerEntryEventData

태스크가 상태를 변경하는 경우

작업 ID:
RegisterTaskWebHook

필터 조건과 일치하는 작업이 상태를 변경할 때마다 발생합니다.

매개 변수

Name 키 필수 형식 Description
Services
 services True array of string

태스크에 대한 이벤트를 페치해야 하는 서비스의 UPN입니다.
작업 이벤트
 taskEvents True array of string

이 트리거를 발생시켜야 하는 태스크의 이벤트입니다.
방식
 modalities array of string

작업의 초기 형식을 지정합니다.
방향
 directions array of string

작업의 방향을 지정합니다.

반환

몸
TaskEventData

정의

TaskEventData

Name 경로 형식 Description
작업 ID
 taskId string

작업의 Nimbus 특정 ID입니다.
서비스 세션 ID
 serviceSessionId string

서비스 세션의 ID
사용자 세션 ID
 userSessionId string

사용자 세션의 ID
전송으로 시작된 사용자 세션
 userSessionStartedWithTransfer boolean

사용자 세션이 전송의 결과로 시작되었는지 여부를 나타냅니다.
통화 체인 ID
 callChainId string

작업의 Microsoft의 통화 체인 ID입니다.
Event
 event string

작업에 대한 Nimbus 내에서 발생한 이벤트입니다.
방향
 direction string

Nimbus에서 진행 중인 작업의 방향(인바운드/아웃바운드/없음)입니다.
Modality
 modality string

Nimbus에서 작업의 초기 형식입니다.
생성됨
 created string

타임스탬프( 작업이 만들어진 경우)
종료됨
 terminated string

태스크가 종료된 타임스탬프입니다.
이유
 reason string

종료 이유입니다.
마지막으로 연결된 사용자의 ID
 lastConnectedUserId string

태스크의 마지막으로 연결된 사용자의 AAD(개체 ID)입니다.
마지막으로 연결된 사용자의 UPN
 LastConnectedUserUPN string

작업의 마지막으로 연결된 사용자의 UPN입니다.
마지막으로 연결된 사용자의 전자 메일
 LastConnectedUserEmail string

작업의 마지막으로 연결된 사용자의 전자 메일입니다.
Microsoft 호출자 ID
 microsoftCallerId string

호출자의 AAD(개체 ID)입니다.
참조 ID
 referenceId string

타사 시스템에서 전달한 참조의 ID입니다.
발신자 ID
 callerId string

Nimbus의 호출자에 대한 내부 ID입니다. 호출자가 알려진 경우 AAD(개체 ID)입니다.
발신자 전화 번호
 callerTelNumber string

호출자의 전화 번호(E.164)입니다. 형식=오디오가 있는 작업에 대해서만 설정합니다.
호출자 UPN
 callerUPN string

고객의 UPN입니다.
Microsoft 대상 ID
 microsoftDestinationId string

아웃바운드 작업에서 호출 수신자의 AAD(개체 ID)입니다.
대상 ID
 destinationId string

Nimbus의 대상(아웃바운드)의 내부 ID입니다. 호출자가 알려진 경우 AAD(개체 ID)입니다.
대상 전화 번호
destinationTelNumber string

대상(아웃바운드)의 전화 번호(E.164)입니다.
대상 UPN
destinationUPN string

대상의 UPN(아웃바운드)입니다.
ACS ID
acsId string

호출자의 Azure 통신 ID입니다.
익명인 경우
 isAnonymous boolean

호출자가 익명인 경우 플래그가 true로 설정됩니다.
고객 식별자
 customerIdentifier string

모든 작업 유형에서 고객의 식별자입니다.
초기 메시지
initialMessage string

먼저 메신저 대화 고객에게 메시지를 표시합니다.
서비스 아이디
 serviceId string

Nimbus 서비스의 내부 ID입니다.
서비스 이름
 serviceName string

Nimbus 서비스의 이름입니다.
서비스 설명
serviceDescription string

Nimbus 서비스에 대한 설명입니다(Microsoft Teams에서 상속됨).
서비스 표시 이름
 serviceDisplayName string

Nimbus 서비스의 표시 이름입니다.
서비스 UPN
 serviceUPN string

Nimbus 서비스의 UPN입니다.
서비스 전화 번호
 serviceTelNumber string

Nimbus 서비스의 전화 번호(E.164)
전자 메일 제목
 emailSubject string

전자 메일의 제목입니다.
전자 메일 본문 고유 서식 있는 텍스트
 emailBodyUniqueRichText string

전자 메일의 본문, 서식 있는 텍스트입니다.
전자 메일 본문 고유 일반 텍스트
 emailBodyUniquePlainText string

전자 메일의 본문, 일반 텍스트입니다.
전자 메일 서비스 사서함 UPN
 emailServiceMailboxUPN string

서비스에 할당된 사서함의 UPN입니다.
아웃바운드 시도
outboundAttempt integer

아웃바운드 대상에 도달하려는 시도 횟수입니다.
업데이트된 매개 변수 이름
 updatedParameterName string

업데이트된 마지막 매개 변수의 이름입니다.
업데이트된 매개 변수 값
updatedParameterValue string

업데이트된 마지막 매개 변수의 값입니다.
작업 정보
taskInformation TaskInformation

고객, 사용자 지정 컨텍스트 매개 변수 및 기본 설정 사용자에 대한 정보를 포함합니다.

TaskInformation

고객, 사용자 지정 컨텍스트 매개 변수 및 기본 설정 사용자에 대한 정보를 포함합니다.

Name 경로 형식 Description
고객
 customer Customer

고객의 모든 정보를 포함하는 개체입니다.
사용자 지정 컨텍스트 매개 변수
 customContextParameters array of CustomContextParameter

사용자 지정 컨텍스트 매개 변수 목록(Key-Value).
기본 설정 사용자
 preferredUsers array of PreferredUser

작업에 대한 기본 설정 사용자 목록(UPN-Priority)입니다.

고객

고객의 모든 정보를 포함하는 개체입니다.

Name 경로 형식 Description
고객 이름
 firstName string

고객의 이름입니다.
고객 성
 lastName string

고객의 성입니다.
고객 표시 이름
 displayName string

고객의 표시 이름입니다.
고객 회사
 company string

고객의 회사입니다.
고객 직호
 jobTitle string

고객의 직호입니다.
고객 부서
 department string

고객 부서입니다.
고객 주소
 streetAddress string

고객의 주소입니다.
고객 우편 번호
 postCode string

고객의 우편 번호입니다.
고객 도시
 city string

고객의 도시입니다.
고객 상태
 state string

고객의 상태입니다.
고객 국가
 country string

고객의 국가입니다.
고객 기본 전화 번호
 primaryTelNumber string

고객의 기본 전화 번호입니다.
전화 번호
 telNumbers array of TelNumber

고객의 추가 전화 번호 목록입니다.
고객 UPN
 UPN string

고객의 UPN입니다.
고객 메신저 주소
 imAddress string

고객의 IM 주소입니다.
고객 이메일
 email string

고객의 전자 메일입니다.
사용자 지정 필드
 customFields array of CustomField

고객의 사용자 지정 필드 목록입니다.

TelNumber

Name 경로 형식 Description
이름
 name string

전화 번호의 지정입니다.
가치
 value string

전화 번호의 값입니다.

CustomField

Name 경로 형식 Description
이름
 name string

사용자 지정 필드의 지정입니다.
가치
 value string

사용자 지정 필드의 값입니다.

CustomContextParameter

Name 경로 형식 Description
이름
 name string

사용자 지정 컨텍스트 매개 변수의 이름입니다.
가치
 value string

사용자 지정 컨텍스트 매개 변수의 값입니다.

PreferredUser

Name 경로 형식 Description
UPN
 upn string

기본 설정 사용자의 UPN입니다.
Priority
 priority integer

우선 순위입니다. 1 높은 99 낮은.

ContactReadDto

Name 경로 형식 Description
외부 ID에 문의
externalId string

외부 시스템에서 제공한 연락처의 ID입니다.
연락처 이름
 firstName string

연락처의 이름입니다.
연락처 성
 lastName string

연락처의 성입니다.
연락처 표시 이름
 displayName string

연락처의 표시 이름입니다.
연락처 이니셜
 initials string

연락처의 이니셜입니다.
회사 문의
 company string

연락처의 회사입니다.
부서에 문의
 department string

연락처의 부서입니다.
연락처 직호
 jobTitle string

연락처의 직호입니다.
사용자 계정 이름에 문의
 userPrincipalName string

연락처의 사용자 계정 이름입니다.
대화 상대 메신저 주소
 imAddresses array of string

IM 주소 목록입니다.
연락처 전자 메일 주소
 emailAddresses array of string

전자 메일 주소 목록입니다.
회사 전화 문의
 businessPhones array of string

회사 전화 목록입니다.
휴대폰에 문의
 mobilePhones array of string

휴대폰 목록입니다.
집 전화 문의
 homePhones array of string

집 전화 목록입니다.
addresses
 addresses array of Address

주소 목록입니다.
customFields
 customFields array of CustomField

연락처의 사용자 지정 필드 목록입니다.

Address

Name 경로 형식 Description
주소 거리
 street string

주소의 거리 및 번호입니다.
주소 도시
 city string

주소의 구/군/시입니다.
주소 국가
 country string

주소의 국가입니다.
주소 상태
 state string

주소의 상태입니다.
주소 우편 번호
 postalCode string

주소의 우편 번호입니다.

SchedulerEntryEventData

Name 경로 형식 Description
Scheduler 항목 ID
 schedulerEntryId string

스케줄러 항목의 Nimbus 특정 ID입니다.
ConversationType
 conversationType string

스케줄러 항목의 대화 유형입니다.
Event
 event string

예약된 작업에 대해 Nimbus 내에서 발생한 이벤트입니다.
방향
 direction string

Nimbus에서 진행 중인 작업의 방향(인바운드/아웃바운드/없음)입니다.
Modality
 modality string

Nimbus에서 작업의 초기 형식입니다.
참조 ID
 ReferenceId string

타사 시스템에서 전달한 참조의 ID입니다.
통합 대화 ID
 unifiedConversationId string

통합 대화 ID입니다.
완료 이유
completionReason string

종료될 때 스케줄러 항목의 결과입니다.
목적지
 destination string

방향이 "아웃바운드"인 스케줄러 항목의 대상입니다.
배포 우선 순위
distributionPriority string

Nimbus에서 작업을 처리해야 하는 우선 순위입니다.
기한(UTC)
 dueDateTimeUtc date-time

UTC의 기한 및 시간: 예: '2020-03-23T11:00:00Z'.
서비스 UPN
 serviceUpn string

항목이 예약된 서비스의 UPN입니다.
최대 시도 수
 maxAttempts integer

대상에 도달하려는 최대 시도 수입니다.
시도 시간 제한(초)
 attemptTimeoutInSeconds integer

최대 시도 횟수에 도달할 때까지 연결 재시도 사이의 시간 제한(간격)입니다.
최대 큐 시간(초)
 maxQueueTimeInSeconds integer

작업이 제한에 도달한 것으로 간주될 때까지 Nimbus가 작업을 해결하려고 시도하는 기간을 정의합니다.
RONA 시간 제한(초)
 ronaTimeoutInSeconds integer

작업이 RONA로 간주되고 새 사용자가 선택될 때까지 Nimbus가 사용자에게 도달하는 기간을 정의합니다.
사용자 지정 컨텍스트 매개 변수
 customCallContextParameters array of CustomContextParameter

사용자 지정 컨텍스트 매개 변수(Key-Value)의 목록입니다.
고객
 customer Customer

고객의 모든 정보를 포함하는 개체입니다.

OutboundCallWithWorkflowSchedulerEntryEventData

Name 경로 형식 Description
Scheduler 항목 ID
 schedulerEntryId string

스케줄러 항목의 Nimbus 특정 ID입니다.
ConversationType
 conversationType string

스케줄러 항목의 대화 유형입니다.
Event
 event string

예약된 작업에 대해 Nimbus 내에서 발생한 이벤트입니다.
방향
 direction string

Nimbus에서 진행 중인 작업의 방향(인바운드/아웃바운드/없음)입니다.
Modality
 modality string

Nimbus에서 작업의 초기 형식입니다.
참조 ID
 ReferenceId string

타사 시스템에서 전달한 참조의 ID입니다.
통합 대화 ID
 unifiedConversationId string

통합 대화 ID입니다.
완료 이유
completionReason string

종료될 때 스케줄러 항목의 결과입니다.
목적지
 destination string

방향이 "아웃바운드"인 스케줄러 항목의 대상입니다.
배포 우선 순위
distributionPriority string

Nimbus에서 작업을 처리해야 하는 우선 순위입니다.
기한(UTC)
 dueDateTimeUtc date-time

UTC의 기한 및 시간: 예: '2020-03-23T11:00:00Z'.
서비스 UPN
 serviceUpn string

항목이 예약된 서비스의 UPN입니다.
최대 시도 수
 maxAttempts integer

대상에 도달하려는 최대 시도 수입니다.
시도 시간 제한(초)
 attemptTimeoutInSeconds integer

Nimbus가 시도를 중지하기 전에 대상에 도달하려고 시도하는 기간을 정의합니다.
사용자 지정 컨텍스트 매개 변수
 customCallContextParameters array of CustomContextParameter

사용자 지정 컨텍스트 매개 변수(Key-Value)의 목록입니다.
고객
 customer Customer

고객의 모든 정보를 포함하는 개체입니다.

VirtualUserAssistantEventData

Name 경로 형식 Description
통합 세션 ID
 unifiedSessionId string

관련된 Nimbus 통합 세션의 ID입니다.
서비스 세션 ID
 serviceSessionId string

관련된 Nimbus 서비스 세션의 ID입니다.
사용자 세션 ID
 userSessionId string

관련 Nimbus 사용자 세션의 ID입니다.
서비스 UPN
 serviceUpn string

이벤트가 발생한 서비스의 UPN입니다.
서비스 아이디
 serviceId string

이벤트가 발생한 서비스의 ID입니다.
서비스 이름
 serviceName string

이벤트가 발생한 서비스의 이름입니다.
Event
 event string

Nimbus 내에서 발생한 가상 사용자 도우미 이벤트입니다.
전송으로 시작된 사용자 세션
 userSessionStartedWithTransfer boolean

사용자 세션이 전송의 결과로 시작되었는지 여부를 나타냅니다.

ExternalTaskWriteResult

Name 경로 형식 Description
외부 작업 ID
 id string

추가된 외부 작업의 ID입니다.
Modality
 modality Modality

작업의 형식입니다.
생성됨
 created string

외부 작업이 만들어진 타임스탬프입니다.
유형
 type string

외부 작업의 형식입니다.
익명인 경우
 isAnonymous boolean

호출자가 익명인 경우 플래그가 true로 설정됩니다.
서비스 아이디
 serviceId string

Nimbus 서비스의 내부 ID입니다.
서비스 이름
 serviceName string

Nimbus 서비스의 이름입니다.
서비스 설명
serviceDescription string

Nimbus 서비스에 대한 설명입니다(Microsoft Teams에서 상속됨).
서비스 표시 이름
 serviceDisplayName string

서비스의 표시 이름입니다.
서비스 UPN
 serviceUPN string

서비스의 UPN입니다.
서비스 전화 번호
 serviceTelNumber string

서비스의 전화 번호입니다.
기본 설정 사용자
 preferredUsers array of PreferredUser

작업(UPN-Priority)에 대한 기본 설정 사용자 목록입니다.

Modality

작업의 형식입니다.

작업의 형식입니다.

Modality
string

CalendarStatus

서비스의 상태(열기, 닫힘 등)입니다.

서비스의 상태(열기, 닫힘 등)입니다.

영업 시간 상태
string