SDK: GitHub 
API 참조: GitHub 페이지
샘플 앱: GitHub
NPM 패키지: npmjs.com
채팅 웹 SDK를 사용하면 나만의 디지털 채팅 애플리케이션을 만들거나 기존 웹 앱에 디지털 채팅을 추가할 수 있습니다. 이를 통해 선택한 UI에서 CXone Mpower 디지털 인프라를 사용할 수 있습니다. 이는 동기식 및 비동기식 메시징을 모두 지원하는 JavaScriptLiveChat과 Chat Messaging을 모두 지원하는 기반 SDK입니다. 단일
단일 스레드 앱에서는, 각 컨택이 조직과 나누는 모든 인터랙션을 처리하는 하나의 채팅 스레드를 가집니다. 또는 다중 스레드 다중 스레드 앱에서 컨택은 새 주제를 의논하기 위해 원하는 만큼 많은 스레드를 생성할 수 있습니다. 이러한 스레드는 동시에 활성화될 수 있습니다. 메시징을 설정할 수도 있습니다. 이 SDK를 사용하면 웹사이트에서 CXone Mpower에 대해 더 많은 제어가 가능합니다. 이는 일부 웹 사이트에 있는 특정 기술적 제한 사항을 피하는 데 도움이 됩니다. 예를 들어 사이트에서 외부 코드를 허용하지 않아 기본 CXone Mpower 디지털 채팅이 실행되지 않을 수 있습니다.
SDK는 아래 기능을 지원합니다.
- 디지털 채팅 메시징
- OAuth인증용 2.0
- 연락처 식별 및 사용자 정의 필드
- 스레드 목록 및 스레드 복구
- 첨부 파일
- 리치 메시지
- 입력, 본 메시지, 전달된 메시지용 표시기
- 케이스 상태 이벤트 또는 할당 이벤트와 같은 시스템 메시지
- 대기열 위치 이벤트
이 SDK는 TypeScript 4.9+로 작성되었습니다. 또한 사용자 정의 애플리케이션
SDK 리소스
이 페이지 상단이나 아래 드롭다운에는 다양한 SDK 리소스에 대한 링크가 제공됩니다.
개발자는 GitHub에서 SDK를 다운로드할 수 있습니다. 저장소에는 개발자가 시작하는 데 도움이 되는 README가 있습니다. 또한 이벤트 및 API 참조에 대한 문서도 포함되어 있습니다. 보다 사용자 친화적인 API 참조는 github.io를 통해 별도로 호스팅됩니다.
샘플 애플리케이션를 볼 수도 있습니다. 이를 통해 채팅을 시도하고 관련 소스 코드를 살펴볼 수 있습니다.
개발자는 SDK를 NPM 패키지로 가져옵니다. npmjs.com의 패키지 항목에는 SDK를 사용하여 설정하고 빌드하기 위한 동일한 콘텐츠와 지침이 모두 포함되어 있습니다.
핵심 용어
| 용어 | 세부 정보 |
|---|---|
| 스레드 | 채팅 앱내의 대화입니다. 상담원이나 컨택 컨택 센터의 상담원, IVR 또는 Bot과 인터랙션하는 사람입니다.이 보낸 첫 번째 메시지가 스레드를 시작합니다. 대화의 각 연속 메시지가 스레드에 추가됩니다. 스레드는 각 메시지를 포함하는 개체입니다. 메시지는 메시지 작성자에 따라 구성됩니다. threadId는 전체 대화를 식별하며 대화 내의 모든 메시지에는 메시지 ID가 있습니다. 대화가 끝나면 스레드가 종료됩니다. |
| 단일 스레드 | 연락처가 한 번에 하나의 대화만 할 수 있는 앱 디자인입니다. |
| 멀티 스레드 | 연락처가 한 번에 여러 대화를 나눌 수 있는 앱 디자인입니다. |
| 채널 | Digital Experience의 맥락에서 채널은 통신에 사용되는 메시징 유형 또는 플랫폼을 나타냅니다. 예를 들어 WhatsApp 실시간 메시징 채널이 있을 수 있습니다. 모바일 SDK를 사용하면 모바일 앱에 채팅 메시징 채널을 추가할 수 있습니다. 채널은 CXone Mpower플랫폼에서 만들어집니다. 이는 채널 ID와 함께 채널 설정을 결정합니다. 앱 사용자는 채팅을 열 때 이 ID를 사용하여 채팅 채널을 시작합니다. |
| 채널 ID | Digital 섹션의 CXone Mpower에 생성된 디지털 채팅 채널의 ID입니다. 이는 채팅 채널 설정 CXone Mpower (ACD > Digital > 디지털 컨택 포인트 > 채팅 > 초기화 및 테스트)에서 찾을 수 있습니다. |
| 브랜드 ID | 이는 에 대한 고급 조직 그룹화는 CXone Mpower 시스템을 위해 기술 지원, 청구 및 글로벌 설정을 관리하는 데 사용됩니다.테넌트Digital ExperienceID와 같습니다. 채팅을 초기화하는 데 사용됩니다. 이는 채팅 채널 설정 CXone Mpower (ACD > Digital > 디지털 컨택 포인트 > 채팅 > 초기화 및 테스트)에서 찾을 수 있습니다. |
| 고객 ID | 채팅 최종 사용자의 고유 ID입니다. SDK는 채팅이 초기화될 때 이 ID를 만듭니다. OAuth가 설정된 경우 이 ID는 모든 장치에서 각 컨택에 대해 동일하게 유지됩니다. OAuth가 설정되어 있지 않은 경우 이 ID는 장치마다 다릅니다. ID가 게스트 로그인처럼 됩니다. |
| 지역 또는 환경 | CXone Mpower 배포가 호스팅되는 전 세계의 위치입니다. 이는 호주(AU1), 캐나다(CA1), 유럽(EU1), 일본(JP1), 북미(NA1) 또는 영국(UK1)일 수 있습니다. 개발자는 CXone Mpower 시스템이 호스팅되는 동일한 지역을 사용해야 합니다. 그렇지 않으면 채팅 연결이 거부됩니다. |
| 연락처, 고객 및 사용자 | 이러한 용어는 모두 모바일의 최종 사용자를 지칭합니다. 앱 온라인 도움말에서는 일반적으로 컨택이라는 용어를 사용합니다. SDK 문서와 코드 주석에서 고객과 사용자를 볼 수 있습니다. |
| CXone Mpower | 플랫폼이 제공하는 모든 고객 경험 도구를 관리하고 액세스할 수 있는 핵심 CXone Mpower입니다. 모바일 앱에서 제공하려는 채팅 기능에 따라 필요한 사용자 계정 권한을 가진 관리자가 CXone Mpower에서 여러 설정 작업을 완료해야 합니다. |
| Digital Experience | CXone Mpower에 대한 모든 것을 관리할 수 있는 디지털 채널섹션입니다. |
개발을 시작하기 전에
모바일 SDK로 빌드하기 전에 아래 사항을 고려하십시오:
- CXone Mpower에 관리자 계정과 상담원 계정이 모두 있습니까? 관리자가 CXone Mpower플랫폼에서 필요한 기능을 설정하는 데 도움을 줄 수 있습니까?
- 기존 채팅 채널이 있습니까, 아니면 새 채널을 만들고 싶습니까?
- 단일 스레드 또는 다중 스레드 대화를 제공하시겠습니까?
- 어떤 유형의 리치 메시지를 설정하고 싶으신가요? 이러한 상호작용 메시지를 활용할 수 있는 사용 사례는 무엇입니까?
- 팝업이나 환영 메시지와 같은 선제적 조치를 사용하시겠습니까?
채팅을 올바르게 초기화하세요
개발자는 앱을 CXone Mpower에 연결하여 양방향 통신을 시작해야 합니다. 이렇게 하면 WebSocket 연결이 생성됩니다. 개발자는 await sdk.connect()를 호출하여 이를 수행할 수 있습니다. 개발자에게 활성 채팅 대화에만 이를 적용하도록 지시하세요. 이렇게 하면 WebSocket이 필요할 때만 실행됩니다.