비즈니스 데이터 API

비즈니스 데이터는 통화의 메타데이터와 연결할 수 있는 사용자 정의 필드입니다. 비즈니스 데이터 API를 사용하여 임의의 종료된 상호작용에 대한 기존 비즈니스 데이터 필드의 값을 업데이트할 수 있습니다. 이 API를 사용하여 새 비즈니스 데이터 필드를 추가할 수 없습니다. 이 API는 Studio의 MCR META DATA 작업과 함께 작동합니다. 이 작업을 통해 실시간 상호작용 중에 단일 컨택에 대한 상호작용 데이터를 보낼 수 있습니다.

Business Data API에 대한 문서는 개발자 커뮤니티 포털 에서 확인할 수 있습니다.

시작하기 전에

CXone Mpower개발자 포털 에서 API를 테스트할 수 있습니다. CXone Mpower 계정으로 로그인한 후 계정의 테넌트닫힘 고급 조직 그룹화는 CXone Mpower 시스템을 위해 기술 지원, 청구 및 글로벌 설정을 관리하는 데 사용됩니다.에게 요청을 할 수 있습니다.

API를 사용하려면 NiCE에 등록하여 인증에 사용되는 유효한 자격 증명을 받아야 합니다. 개발자 포털의 시작하기 페이지 에서 지침을 확인하세요.

이러한 API를 사용하려면 다음 권한이 필요합니다.

엔터티: 비즈니스 데이터 API를 업데이트하려면 검색 및 재생 > APIs > 비즈니스 데이터 업데이트 권한이 필요합니다.

비즈니스 데이터 업데이트

닫힌 상호작용의 경우, 주어진 ACD contactId에 대해 사용 가능한 모든 세그먼트에 대한 기존 비즈니스 데이터 필드 정보를 업데이트합니다.

메소드: PUT

엔드포인트: /business-data-manager/v1/business-data/contact/{ACD 연락처 ID}

매개변수:

연락처 ID*:

문자열

비즈니스 데이터 값을 업데이트할 ACD contactId의 고유 식별자입니다.

URL: https://na1.test.nice-incontact.com/business-data-manager/v1/business-data/contact/8675309

유형: PUT

[ { "business_data_name1": "string of text" }, { "business_data_name2": true, }, { "business_data_name3": 1234, } ]

응답

  • 204 상태 - 서버에서 성공적으로 요청을 처리했으며, 응답 페이로드 본문에 추가로 전송해야 할 콘텐츠가 없음.

  • 400 상태 - 요청에 잘못된 입력 매개변수가 포함되어 있음.

  • 401 상태 - 인증 실패. 올바르지 않은 자격 증명.

  • 403 상태 - 사용 권한 필수.

  • 404 상태 - 요청한 컨택을 찾을 수 없음

  • 상태 500 - 내부 서버 오류.

비즈니스 데이터 업데이트

닫힌 상호작용의 경우 지정된 ACD contactId의 지정된 세그먼트에 대한 기존 비즈니스 데이터 필드 정보를 업데이트합니다.

메소드: PUT

엔드포인트: /business-data-manager/v1/business-data/contact/{ACD 연락처 ID}/segment/{segmentId}

매개변수:

연락처 ID*:

문자열

업데이트할 비즈니스 데이터 값이 포함된 세그먼트를 포함하는 ACD contactId의 고유 식별자입니다.
세그먼트 ID*:

문자열

업데이트할 비즈니스 데이터 값이 포함된 ACD contactId 세그먼트의 고유 식별자입니다.

URL: https://na1.test.nice-incontact.com/business-data-manager/v1/business-data/contact/{ACD 연락처 ID}/segment/b2e28d4e-ef22-4597-a104-2e740f729686

유형: PUT

[ { "business_data_name1": "string of text" }, { "business_data_name2": true, }, { "business_data_name3": 8675309, } ]

응답

  • 204 상태 - 서버에서 성공적으로 요청을 처리했으며, 응답 페이로드 본문에 추가로 전송해야 할 콘텐츠가 없음.

  • 400 상태 - 요청에 잘못된 입력 매개변수가 포함되어 있음.

  • 401 상태 - 인증 실패. 올바르지 않은 자격 증명.

  • 403 상태 - 사용 권한 필수.

  • 상태 404 - 요청된 세그먼트를 찾을 수 없습니다.

  • 상태 500 - 내부 서버 오류.