디지털 채팅 웹 SDK

SDK: GitHub

API 참조: GitHub 페이지

샘플 앱: GitHub

NPM 패키지: npmjs.com

채팅 웹 SDK를 사용하면 나만의 디지털 채팅 애플리케이션을 만들거나 기존 웹 디지털 채팅을 추가할 수 있습니다. 이를 통해 선택한 UI에서 CXone 디지털 인프라를 사용할 수 있습니다. 이는 LiveChatChat Messaging(동기 및 비동기 메시징 모두)을 모두 지원하는 JavaScript 기반 SDK입니다. 단일닫힘 단일 스레드 앱에서 각 컨택은 단 하나의 채팅 스레드를 가질 수 있습니다. 조직과 진행하는 모든 인터랙션은 이러한 하나의 채팅 스레드에서 발생합니다. 또는 다중 스레드닫힘 다중 스레드 앱에서 컨택은 새 주제를 의논하기 위해 원하는 만큼 많은 스레드를 생성할 수 있습니다. 이러한 스레드는 동시에 활성화될 수 있습니다. 메시징을 설정할 수도 있습니다. 이 SDK를 사용하면 웹사이트에서 CXone에 대해 더 많은 제어가 가능합니다. 이는 일부 웹 사이트에 있는 특정 기술적 제한 사항을 피하는 데 도움이 됩니다. 예를 들어 사이트에서 외부 코드를 허용하지 않아 기본 CXone 디지털 채팅이 실행되지 않을 수 있습니다.

SDK는 아래 기능을 지원합니다.

  • 디지털 채팅 메시징
  • OAuth인증용 2.0
  • 연락처 식별 및 사용자 정의 필드
  • 스레드 목록 및 스레드 복구
  • 첨부 파일
  • 리치 메시지
  • 입력, 본 메시지, 전달된 메시지용 표시기
  • 케이스 상태 이벤트 또는 할당 이벤트와 같은 시스템 메시지
  • 대기열 위치 이벤트

이 SDK는 TypeScript 4.9+로 작성되었습니다. 또한 사용자 정의 애플리케이션 bundler like webpack or Create React App을(를) 사용해야 합니다.

SDK 리소스

이 페이지 상단이나 아래 드롭다운에는 다양한 SDK 리소스에 대한 링크가 제공됩니다.

개발자는 GitHub에서 SDK를 다운로드할 수 있습니다. 저장소에는 개발자가 시작하는 데 도움이 되는 README가 있습니다. 또한 이벤트 및 API 참조에 대한 문서도 포함되어 있습니다. 보다 사용자 친화적인 API 참조는 github.io를 통해 별도로 호스팅됩니다.

샘플 애플리케이션를 볼 수도 있습니다. 이를 통해 채팅을 시도하고 관련 소스 코드를 살펴볼 수 있습니다.

개발자는 SDK를 NPM 패키지로 가져옵니다. npmjs.com의 패키지 항목에는 SDK를 사용하여 설정하고 빌드하기 위한 동일한 콘텐츠와 지침이 모두 포함되어 있습니다.

핵심 용어

  • 스레드: 채팅 내 대화. 상담원이나 컨택닫힘 컨택 센터의 상담원, IVR 또는 Bot과 인터랙션하는 사람입니다.이 보낸 첫 번째 메시지가 스레드를 시작합니다. 대화의 각 연속 메시지가 스레드에 추가됩니다. 스레드는 각 메시지를 포함하는 개체입니다. 메시지는 메시지 작성자에 따라 구성됩니다. threadId는 전체 대화를 식별하며 대화 내의 모든 메시지에는 메시지 ID가 있습니다. 대화가 끝나면 스레드가 종료됩니다.

  • 단일 스레드: 컨택이 한 번에 하나의 대화만 할 수 있는 디자인.

  • 다중 스레드: 컨택이 동시에 여러 대화를 나눌 수 있는 디자인.

  • 채널: Digital Experience의 맥락에서 채널은 메시징 유형 또는 통신에 사용되는 플랫폼을 가리킵니다. 예를 들어 WhatsApp 실시간 메시징 채널이 있을 수 있습니다. 모바일 SDK를 사용하면 모바일 에 채팅 메시징 채널을 추가할 수 있습니다. 채널은 CXone플랫폼에서 만들어집니다. 이는 채널 ID와 함께 채널 설정을 결정합니다. 사용자는 채팅을 열 때 이 ID를 사용하여 채팅 채널을 시작합니다.

  • ChannelId: CXone디지털 섹션에 만들어진 디지털 채팅 채널의 ID. 이는 채팅 채널 설정 CXone (ACD디지털디지털 컨택 포인트채팅초기화 및 테스트)에서 찾을 수 있습니다.

  • BrandId: 이는 Digital Experience테넌트닫힘 고급 조직 그룹화는 CXone 환경을 위해 기술 지원, 청구 및 글로벌 설정을 관리하는 데 사용됩니다. ID와 같습니다. 채팅을 초기화하는 데 사용됩니다. 이는 채팅 채널 설정 CXone (ACD디지털디지털 컨택 포인트채팅초기화 및 테스트)에서 찾을 수 있습니다.

  • CustomerId: 채팅 최종 사용자의 고유 ID. SDK는 채팅이 초기화될 때 이 ID를 만듭니다. OAuth가 설정된 경우 이 ID는 모든 장치에서 각 컨택에 대해 동일하게 유지됩니다. OAuth가 설정되어 있지 않은 경우 이 ID는 장치마다 다릅니다. ID가 게스트 로그인처럼 됩니다.

  • 지역 또는 환경: CXone 배포가 호스팅되는 세계의 위치. 이는 호주(AU1), 캐나다(CA1), 유럽(EU1), 일본(JP1), 북미(NA1) 또는 영국(UK1)일 수 있습니다. 개발자는 CXone 시스템이 호스팅되는 동일한 지역을 사용해야 합니다. 그렇지 않으면 채팅 연결이 거부됩니다.

  • 컨택, 고객 및 사용자: 이 용어는 모두 모바일 의 최종 사용자를 나타냅니다. 온라인 도움말에서는 일반적으로 컨택이라는 용어를 사용합니다. SDK 문서와 코드 주석에서 고객사용자를 볼 수 있습니다.

  • CXone: NICE CXone이 제공하는 모든 고객 경험 도구를 관리하고 액세스하는 핵심 플랫폼. 모바일 에서 제공하려는 채팅 기능에 따라 필요한 사용자 계정 권한을 가진 관리자가 CXone에서 여러 설정 작업을 완료해야 합니다.

  • Digital Experience: 디지털 채널에 대한 모든 것을 관리할 수 있는 CXone의 섹션.

개발을 시작하기 전에

모바일 SDK로 빌드하기 전에 아래 사항을 고려하십시오:

  • CXone에 관리자 계정과 상담원 계정이 모두 있습니까? 관리자가 CXone플랫폼에서 필요한 기능을 설정하는 데 도움을 줄 수 있습니까?
  • 기존 채팅 채널이 있습니까, 아니면 새 채널을 만들고 싶습니까?
  • 단일 스레드 또는 다중 스레드 대화를 제공하시겠습니까?
  • 어떤 유형의 리치 메시지를 설정하고 싶으신가요? 이러한 상호작용 메시지를 활용할 수 있는 사용 사례는 무엇입니까?
  • 팝업이나 환영 메시지와 같은 선제적 조치를 사용하시겠습니까?