봇 빌더에서 사용자 정의 API 통합

API API는 CXone 시스템을 조직에서 사용하는 다른 소프트웨어와 연결하여 특정 기능을 자동화할 수 있습니다.를 사용하여사용자 정의 통합을 설정할 수 있습니다. 이렇게 하면 자신의 데이터베이스 또는 타사 애플리케이션을 봇과 함께 사용할 수 있습니다. 사용자 정의 통합을 설정하여 통합하려는 웹 서비스와 봇 빌더을(를) 연결할 수 있습니다.

통합이 설정된 후에는 하나 이상의 봇 작업을 생성해야 합니다. 이를 통해 통합 웹 서비스로 전송되는 요청을 정의할 수 있습니다. 대화 봇 빌더의 Bot 스토리 및 규칙.에서 이러한 봇 작업을 사용하여 대화의 특정 지점에서 봇이 웹 서비스에 요청을 보내도록 할 수 있습니다.

새 API 통합 생성

연결하는 웹 서비스당 통합을 하나만 생성하면 됩니다.

CXone에서 앱 선택기 를 클릭하고 선택합니다.봇 빌더.
작업할 봇을 클릭합니다.
왼쪽 아이콘 메뉴에서 통합 을 클릭합니다.
API 탭에서 새 통합을 클릭합니다.
기본 새 통합 제목을 클릭하여 통합의 이름을 바꾼 다음 Enter를 눌러 변경 사항을 저장합니다.

인증 아래에서 인증 방법을 선택합니다. 선택한 유형에 대해 필요한 정보를 입력합니다.

이 단계의 필드에 대해 자세히 알아보기

필드 상세 정보

공개

필드	상세 정보
공개	API 통합에는 인증이 필요하지 않습니다. 추가 단계를 밟을 필요가 없습니다. 생성하는 모든 작업을 위해 JSON에 인증 줄을 여전히 추가할 수 있습니다.
OAuth 2.0	인증 URL, 키 및 비밀 필드를 채웁니다. 범위 상세 정보는 선택 사항입니다. 범위를 사용하면 액세스 토큰에 부여되는 액세스 범위를 제한할 수 있습니다. 봇 빌더에서는 OAuth 2.0 클라이언트 자격 증명 부여 유형을 사용합니다. 이 정보는 통합하는 웹 서비스에 대한 계정에서 확인할 수 있습니다.
사용자 정의	JSON 요청 편집기의 헤더 섹션에 인증을 위한 줄을 추가한 다음 사용하고자 하는 인증 방법을 입력합니다. Basic Authentication, JSON Web Token, Simple Web Token 또는 Bearer Token을 사용할 수 있습니다. `{ "headers": { "Content-Type": "application/json", "Authorization": "[authentication_type] [token]" } }`

API 통합에는 인증이 필요하지 않습니다. 추가 단계를 밟을 필요가 없습니다.

생성하는 모든 작업을 위해 JSON에 인증 줄을 여전히 추가할 수 있습니다.

OAuth 2.0

인증 URL, 키 및 비밀 필드를 채웁니다. 범위 상세 정보는 선택 사항입니다. 범위를 사용하면 액세스 토큰에 부여되는 액세스 범위를 제한할 수 있습니다. 봇 빌더에서는 OAuth 2.0 클라이언트 자격 증명 부여 유형을 사용합니다.

이 정보는 통합하는 웹 서비스에 대한 계정에서 확인할 수 있습니다.

사용자 정의

JSON 요청 편집기의 헤더 섹션에 인증을 위한 줄을 추가한 다음 사용하고자 하는 인증 방법을 입력합니다. Basic Authentication, JSON Web Token, Simple Web Token 또는 Bearer Token을 사용할 수 있습니다.

{
  "headers": {
  "Content-Type": "application/json",
  "Authorization": "[authentication_type] [token]"
  }
}

통합에 하나 이상의 작업을 추가합니다.
변경을 마치면 훈련 및 준비를 클릭하여 봇 모델 훈련 및 준비된 Bot 버전을 업데이트합니다.
스토리 의도 및 컨텍스트를 기반으로 인터랙션 처리를 위해 Bot을 훈련하는 데 사용됩니다. , 규칙 컨텍스트에 따라 변경되지 않는 메시지에 대한 Bot의 응답을 정의하는 데 사용됩니다. 또는 폴백 대상이 리치 미디어를 지원하지 않을 때 전송되는 대체 일반 텍스트입니다. 에 액션을 추가합니다. 봇 작업 옵션의 API 섹션에는 구성하고 설정한 API 통합 작업이 모두 표시됩니다.

이미지 보기

통합에 대한 사용자 정의 봇 작업 생성

API 통합에서 최소 하나 이상의 사용자 정의 봇 작업이 필요합니다. 사용자 정의 봇 작업을 생성 및 활성화한 후 대화 상담원이 인터랙션을 종료한 후 작업 요구 사항을 완료할 수 있는 상태입니다를 작업할 때 봇 응답에서 이를 사용할 수 있습니다.

CXone에서 앱 선택기 를 클릭하고 선택합니다.봇 빌더.
작업할 봇을 클릭합니다.
왼쪽 아이콘 메뉴에서 통합 을 클릭합니다.
작업하려는 의도의 폴더를 선택합니다 또는 새로운 의도를 만듭니다.
작업에서 새 작업을 클릭합니다.
작업의 이름을 입력하고 Enter를 누릅니다.
작업을 클릭하여 구성합니다.
구성 아래에서, 요청 JSON 창에서 구성을 작성합니다. 슬롯 값은 {{slot_name}} 형식의 변수로 사용할 수 있습니다. 테스트 목적으로 mockSlots 매개변수를 사용할 수 있습니다.
응답 창을 채우려면 언제든지 테스트 요청을 클릭하십시오.
오류 처리 아래의 오류 메시지 필드를 사용하여 실패한 API 요청에 대한 응답으로 컨택에게 무엇을 표시할지 지정할 수 있습니다.
디버그 모드 확인란을 선택하여 오류 메시지에 접미사 응답을 추가할 수 있습니다.
봇과 함께 작업을 사용할 준비가 되면, 작업 구성 페이지의 상단에 있서 작업 토글 을 클릭합니다. 토글이 꺼져 있으면 작업을 사용할 수 없습니다.
변경을 마치면 훈련 및 준비를 클릭하여 봇 모델 훈련 및 준비된 Bot 버전을 업데이트합니다.

사용자 정의 API 통합을 봇 스킬에 추가

사용자 정의 API 통합을 하나 이상의 봇 스킬에 추가할 수 있습니다. 이렇게 하면 통합을 추가한 스킬과 함께 통합의 봇 작업을 사용할 수 있습니다.

CXone에서 앱 선택기 를 클릭하고 선택합니다.봇 빌더.
작업할 봇을 클릭합니다.
왼쪽 아이콘 메뉴에서 통합 을 클릭합니다.
API 탭에서, 작업하려는 통합 위에 커서를 올려놓습니다.
생략 기호 를 클릭하고 스킬에 추가를 선택합니다.
하나 이상의 스킬을 클릭하고 모두 선택을 클릭하여 가용한 모든 스킬에 통합을 추가합니다.
원하는 스킬을 사용할 수 없는 경우, 검색 창에 이름을 입력한 후 스킬 생성을 클릭합니다.