Mobile SDK
모바일 SDK 구현을 시작하려면 NICE에서 기본 구현 패키지를 구입해야 합니다. NICE의 파트너가 구현 과정을 안내해 드립니다.
Mobile SDK를 사용하여 CXone Mpower 디지털 채팅을 엔터프라이즈 휴대폰 앱에 통합할 수 있습니다. 이를 통해 앱 사용자는 디지털 Digital Experience에 연결된 모든 채널, 컨택 또는 스킬입니다. 채팅 채널을 통해 컨택 센터 상담원 및 봇과 채팅할 수 있습니다. SDK는 디지털 채팅 구현 프로세스를 단순화합니다. 개발자는 비즈니스 로직 구현을 처리할 필요가 없습니다. 개발자의 주요 작업은 푸시 알림이나 서식 있는 메시지와 같이 CXone Mpower에서 설정한 기능을 시각적으로 표시하고 관리하는 것입니다. SDK는 iOS 및 Android 앱 모두 지원합니다. iOS 앱은 Swift
로 작성되어야 하고 Android 앱은 Kotlin
으로 작성되어야 합니다.
Mobile SDK을(를) 사용하여,
- LiveChat과 Chat Messaging 채팅 채널을 모두 구현할 수 있습니다.
- LiveChat은 실시간 메시징입니다.
- Chat Messaging은 DM(다이렉트 메시지)과 같은 비동기 메시징입니다.
- 컨택은 다중 스레드
다중 스레드 앱에서 컨택은 새 주제를 의논하기 위해 원하는 만큼 많은 스레드를 생성할 수 있습니다. 이러한 스레드는 동시에 활성화될 수 있습니다. 메시징을 통해 동시에 컨택 센터와 여러 상호작용을 할 수 있습니다. 단일 스레드
단일 스레드 앱에서 각 컨택은 단 하나의 채팅 스레드를 가질 수 있습니다. 조직과 진행하는 모든 인터랙션은 이러한 하나의 채팅 스레드에서 발생합니다. 구성을 설정할 수도 있습니다.
- 리치 미디어를 사용하여 인앱 채팅에 빠른 답장, 목록, 링크와 같은 상호작용 메시지를 추가할 수 있습니다.
- 컨택과 상담원은 동영상, 문서 등 첨부 파일을 서로 공유할 수 있습니다.
- 컨택과 상담원은 상대방이 입력할 때를 확인하여 계속해서 참여할 수 있습니다.
- 새 메시지 도착과 같은 이벤트를 기반으로 인앱 및 푸시 알림을 트리거할 수 있습니다.
- 이벤트나 조건에 따라 앱에서 콘텐츠를 표시하는 선제적 규칙을 만들 수 있습니다.
- 환영 메시지와 채팅 전 양식을 통해 상호작용을 시작하여 컨택으로부터 초기 정보를 수집할 수 있습니다.
SDK의 이점을 한눈에 살펴보기 위해 Mobile SDK 데이터 시트 를 확인할 수 있습니다. 또한 짧은 데모 비디오
를 시청할 수도 있습니다.

소프트웨어 개발 키트(SDK)는 개발자를 위한 도구 상자와 같습니다. 이는 소프트웨어 애플리케이션를 더 쉽게 구축할 수 있는 도구 및 리소스 세트를 제공합니다. 미리 만들어진 빌딩 블록 모음이라고 생각할 수 있습니다. 이러한 빌딩 블록에는 기존의 기능을 가지고 있습니다. 개발자는 처음부터 자체적으로 기능을 구축하는 대신 이러한 기존의 블록을 사용할 수 있습니다. SDK를 사용하면 다음과 같은 네 가지 일반적인 이점을 얻을 수 있습니다.
-
효율성: SDK는 개발자의 시간을 절약해 주는 기성 도구와 사전 구축된 구성 요소를 제공합니다. 노력을 낭비하는 대신 앱의 독특한 측면에 집중할 수 있습니다.
-
일관성: SDK는 다양한 앱에 걸쳐 일관성을 보장합니다. 개발자는 동일한 도구 및 라이브러리 세트를 사용하여 사용자에게 통합된 경험을 제공합니다.
-
플랫폼 호환성: iOS 및 Android SDK는 해당 플랫폼에 맞게 조정되었습니다. 플랫폼 특정 복잡성을 처리하여 크로스 플랫폼 앱을 더 쉽게 만들 수 있습니다.
-
품질 보증: 로거를 사용하면 개발자는 코드를 확인하고, 버그를 조기에 포착하고, 보다 안정적인 소프트웨어를 제공할 수 있습니다.
요약하자면, SDK는 개발을 단순화하고, 품질을 보장하며, 협업을 촉진하므로 효율적인 앱 만들기를 위한 필수 도구입니다.
SDK 리소스
공개 GitHub 리포지토리(Android iOS
)에서 SDK 패키지를 다운로드합니다. 두 리포지토리 모두 개발을 시작하는 데 도움이 되는 README 파일을 포함하고 있습니다. 또한 /docs에서 코드 샘플이 포함된 사용 사례도 제공합니다. 채팅을 개발할 때 이러한 정보를 영감으로 활용하십시오. 두 리포지토리 모두 변경 로그도 포함합니다.
브라우저에서 API 참조에 액세스할 수 있습니다(Android iOS
).
개발자는 Android 와 iOS
플랫폼에 대한 샘플 애플리케이션를 볼 수도 있습니다. 이는 개발자가 구현된 기능의 예시를 보는 데 도움이 됩니다.
모바일 SDK 버전 관리
SDK 버전은 일반적으로 25.2, 25.3 등의 CXone Mpower 주요 마케팅 릴리스와 함께 업데이트됩니다. GitHub에서 각 릴리스 버전은 아래 설명된 의미 버전에 따라 태그가 지정됩니다.
NICE은 현재 SDK와 이전 주요 버전 하나를 지원합니다. 예를 들어, 현재 버전이 2.2이면 NICE는 v2.2와 1.3(최신 1.xx 버전)을 지원합니다.
SDK도 업데이트되므로 앱을 최신 상태로 유지하는 것은 사용자의 책임입니다. 위의 SDK 리소스 섹션에서는 최신 리소스에 대한 링크를 제공합니다. SDK 리포지토리에서 태그를 사용하여 이전 버전의 SDK를 찾을 수 있습니다. 또한, SDK는 마지막 두 주요 버전과도 이전 버전과 호환됩니다.
버전 변경
SDK 버전이 릴리스될 때마다 변경되는 경우, 버전 번호는 변경 유형을 나타냅니다. 다음은 외연을 설명합니다.
-
2.0.0: 첫 번째 숫자는 주요 API 변경 사항을 나타냅니다.
-
2.1.0: 두 번째 숫자는 중단되지 않는 변경을 나타냅니다. 종종 새로운 기능은 중대한 변경 사항이 아닌 형태로 추가됩니다.
-
2.0.1: 세 번째 숫자는 버그 수정을 나타냅니다. 이러한 기능은 항상 이전 버전과 호환됩니다.
버그 수정
NICE 전문 서비스에서는 버그 수정을 위해 고객과 협력합니다. 여러분은 이를 통해(또는 구현 파트너를 통해) 버그를 제출할 수 있으며, 이들은 SDK 변경 로그 외에도 여러분에게 수정 사항을 전달합니다.
또한, 현재 지원되는 버전에서는 모든 버그가 수정되었습니다. 예를 들어, 현재 버전이 3.0이면 지원되는 두 가지 버전은 3.0과 2.3(2.x의 최신 버전)입니다. v2.1에서 버그를 발견한 경우 NICE는 2.3 및 3.0에서는 버그를 수정하지만 2.1이나 2.2에서는 수정하지 않습니다.
모바일 SDK를 Digital Experience에 적용하는 방법
모바일 SDK는 Digital Experience을 확장하고 디지털 모바일에서 채팅을 제공하는 방법입니다. 앱 Digital Experience는 디지털 상호작용을 지원하는 CXone Mpower의 일부분입니다. 디지털 채널의 예로는 WhatsApp, Facebook의 게시물 또는 디지털 채팅이 있습니다. CXone Mpower에 앱디지털 채팅을 추가하려면 인터페이스의 섹션에서 특정 Digital Experience기능CXone Mpower을 구성해야 합니다. 그런 다음 SDK를 사용하면 CXone Mpower에서 설정한 기능에 액세스하고 사용할 수 있습니다.
예를 들어 시작 프로세스의 일부는 CXone Mpower에서 디지털 채팅 채널을 설정하는 것입니다. 그런 다음, 앱는 귀하가 만든 디지털 채팅 채널과 WebSocket 연결을 생성해야 합니다. 환영 메시지나 채팅 전 설문조사와 같은 고급 기능을 설정할 수도 있습니다. 이는 앱 사용자의 경험을 간소화할 수 있는 다양한 옵션을 제공합니다. 사용자는 자신의 문제나 요청에 대한 초기 정보를 제공하고 기본 개인 데이터를 입력하는 등의 작업을 할 수 있습니다. 이러한 기능은 처음에 CXone Mpower에 설정되어 있으며 이후 SDK와 함께 사용할 수 있습니다.
채팅 UI 구축
통합자로서 사용자는 채팅 UI 구축을 담당합니다. 이는 파일 표시 및 작업, 음성 메시지 녹음과 같은 특정 기능을 활용하는 데 필요합니다. 예를 들어 메시지를 녹음하려면 컨택이 장치의 마이크에 액세스하기 위해 누르는 버튼을 추가해야 합니다. UI 구현 방법의 예시는 샘플 애플리케이션(Android iOS
)를 참조할 수 있습니다.
MessageKit과 같은 타사 UI 개발 키트를 사용할 수 있습니다. 그러나 이는 사용 사례에 따라 제한될 수 있습니다. 또한 CXone Mpower은 타사 UI 패키지를 소유하거나 지원하지 않습니다.
개발을 시작하기 전에
모바일 SDK로 빌드하기 전에 아래 사항을 고려하십시오:
- CXone Mpower에 관리자 계정과 상담원 계정이 모두 있습니까? 관리자가 CXone Mpower플랫폼에서 필요한 기능을 설정하는 데 도움을 줄 수 있습니까?
- 귀하의 모바일 앱을 iOS (Apple), Android 또는 둘 다에 사용할 수 있습니까? 개발자가 Swift 및 Kotlin 언어에 익숙합니까?
- 기존 채팅 메시징 채널이 있습니까, 아니면 새 채널을 만들고 싶습니까?
- OAuth를 사용하여 앱 사용자를 인증하시겠습니까? 그렇다면 어떤 OAuth 제공자를 사용하시겠습니까?
- 단일 스레드 또는 다중 스레드 대화를 제공하시겠습니까?
- 팝업이나 환영 메시지와 같은 선제적 조치를 사용하시겠습니까?
- 푸시 알림을 사용하시겠습니까? 기존 Firebase 또는 Apple Developer 계정이 있으십니까?
- 어떤 유형의 리치 메시지를 설정하고 싶으신가요? 이러한 상호작용 메시지를 활용할 수 있는 사용 사례는 무엇입니까?
- 사용자 데이터를 추적하시겠습니까? 방문자 이벤트를 사용하여 분석을 생성하려면 어떻게 해야 합니까?
핵심 용어
-
스레드: 채팅 앱 내 대화. 상담원이나 컨택
컨택 센터의 상담원, IVR 또는 Bot과 인터랙션하는 사람입니다.이 보낸 첫 번째 메시지가 스레드를 시작합니다. 대화의 각 연속 메시지가 스레드에 추가됩니다. 스레드는 각 메시지를 포함하는 개체입니다. 메시지는 메시지 작성자에 따라 구성됩니다. threadId는 전체 대화를 식별하며 대화 내의 모든 메시지에는 메시지 ID가 있습니다. 대화가 끝나면 스레드가 종료됩니다.
-
단일 스레드: 컨택이 한 번에 하나의 대화만 할 수 있는 앱 디자인.
-
다중 스레드: 컨택이 동시에 여러 대화를 나눌 수 있는 앱 디자인.
-
채널: Digital Experience의 맥락에서 채널은 메시징 유형 또는 통신에 사용되는 플랫폼을 가리킵니다. 예를 들어 WhatsApp 실시간 메시징 채널이 있을 수 있습니다. 모바일 SDK를 사용하면 모바일 앱에 채팅 메시징 채널을 추가할 수 있습니다. 채널은 CXone Mpower플랫폼에서 만들어집니다. 이는 채널 ID와 함께 채널 설정을 결정합니다. 앱 사용자는 채팅을 열 때 이 ID를 사용하여 채팅 채널을 시작합니다.
-
ChannelId: CXone Mpower의 Digital 섹션에 만들어진 디지털 채팅 채널의 ID. 이는 채팅 채널 설정 CXone Mpower (ACD > Digital > 디지털 컨택 포인트 > 채팅 > 초기화 및 테스트)에서 찾을 수 있습니다.
-
BrandId: 이는 Digital Experience의 테넌트
고급 조직 그룹화는 CXone Mpower 환경을 위해 기술 지원, 청구 및 글로벌 설정을 관리하는 데 사용됩니다. ID와 같습니다. 채팅을 초기화하는 데 사용됩니다. 이는 채팅 채널 설정 CXone Mpower (ACD > Digital > 디지털 컨택 포인트 > 채팅 > 초기화 및 테스트)에서 찾을 수 있습니다.
-
CustomerId: 채팅 최종 사용자의 고유 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의 섹션.