채팅 애셋 구성하기

개요

컨트롤 허브의 디지털 채널을 사용하여 웹 (실시간 채팅), 모바일 (인앱 메시지), 푸시 알림용 채팅 자산을 만들고 구성하세요. 구성에 사용할 수 있는 설정은 할당에서 선택한 서비스와 웹, 모바일 또는 둘 다 선택했는지에 따라 달라져요.

이 문서에서는 지원되는 기능, 메시징, 푸시 제공자 자격 증명, JSON 웹 토큰 (JWT) 인증, JSON 웹 키 (JWK), 전송 프로토콜, 다중 사용자 등록, 자산 생성 후 서비스별 구성을 포함한 전체 자산 구성 프로세스를 설명해요.

지원되는 기능들

테이블 1이에요.서비스별 지원 기능
능력	Webex Connect	웹엑스 컨택 센터	웹엑스 컨택 센터 엔터프라이즈
웹 라이브 채팅	지원돼요	지원돼요	지원돼요
모바일 인앱 메시징	지원돼요	지원돼요	지원돼요
웹과 모바일을 단일 자산으로	지원돼요	지원 안 돼요	지원 안 돼요
모바일 - 안드로이드 푸시 알림	지원돼요	지원돼요	지원돼요
모바일 - iOS 푸시 알림	지원돼요	지원돼요	지원돼요
웹 푸시 알림	지원돼요 (크롬하고 파이어폭스)	지원 안 돼요	지원 안 돼요
JWT - 모바일	지원돼요	지원되고 필수예요	지원되고 필수예요
JWT - 웹	지원돼요	지원 안 돼요	지원 안 돼요
다중 사용자 등록	지원돼요	지원돼요	지원돼요
서버 측 수신함	지원돼요	적용 안 돼요	적용 안 돼요
데이터 스트림	지원돼요	적용 안 돼요	적용 안 돼요

시작하기 전에

디지털 자산을 관리할 수 있는 전체 관리자 또는 컨택 센터 관리자로 컨트롤 허브에 로그인하세요.
조직에 Webex Connect 디지털 서비스, Webex 컨택 센터 또는 컨택 센터 엔터프라이즈가 제공되었는지 확인하십시오. 자격 없이는 디지털 자산을 사용할 수 없어요.
새 채팅 대화를 받을 컨택 센터 진입점과 흐름을 파악하세요.
배포에 모바일 푸시 알림을 사용하는 경우 선택한 플랫폼에 필요한 Firebase, Huawei 또는 Apple 자격 증명을 준비하세요.
JWT 인증을 사용할 계획이면 신뢰할 수 있는 백엔드에서 발행한 토큰을 확인하는 데 사용되는 공개 JWK를 준비하세요.

채팅 애셋 구성해요

채팅 애셋을 구성하려면:

1	컨트롤 허브에 로그인해요.
2	서비스 > 디지털 자산으로 가세요.
3	자산 생성을 선택해요.
4	자산 세부 정보 구성에 다음 값을 입력하세요. 이름 (필수): 자산 이름을 입력하세요. 설명: 선택적 사용 사례 설명을 입력하세요. 채널 (필수): 채팅을 선택하세요. 애셋이 만들어진 후에는 채널을 변경할 수 없어요. 할당 대상 (필수): 웹엑스 컨택 센터 또는 웹엑스 컨택 센터 엔터프라이즈를 선택하세요Webex Connect. 사용 가능한 옵션은 조직 자격에 따라 달라요.
5	메시징에서 플랫폼을 선택하고 라이브 채팅/인앱 메시징과 필요한 푸시 알림을 구성하세요. 표시되는 옵션은 선택한 플랫폼에 따라 달라요. 모바일을 선택하면 안드로이드와 iOS 알림 설정을 사용할 수 있어요. 웹 푸시는 할당된 자산으로 웹을 선택하면 사용할 수 있어요Webex Connect.

메시지 구성

메시징에서 플랫폼을 선택하고 자산의 메시징 기능을 구성하세요.

메시지 구성하려면:

1차 전송 프로토콜과 2차 전송 프로토콜이 달라야 해요. SDK가 주 프로토콜로 연결 못 하면 보조 프로토콜을 대체 프로토콜로 사용해요.

1	플랫폼: Webex Connect 필요하면 웹이나 모바일, 아니면 둘 다 선택해요. 모바일의 경우 안드로이드, iOS 또는 둘 다 선택하세요. 웹엑스 컨택 센터 또는 웹엑스 컨택 센터 엔터프라이즈의 경우, 웹 또는 모바일을 선택하세요.
2	실시간 채팅/인앱 메시지: 웹과 모바일에서 사용할 수 있어요. Webex Connect 웹엑스 컨택 센터 또는 웹엑스 컨택 센터 엔터프라이즈의 경우, 웹은 라이브 채팅을 제공하고 모바일은 인앱 메시지를 제공해요.
3	주 전송 프로토콜: MQTT나 웹 소켓을 선택하세요.
4	2차 전송 프로토콜: 기본 프로토콜로 선택되지 않은 프로토콜을 선택하세요.

푸시 알림 구성하세요

애플리케이션이 구성된 푸시 공급자를 통해 알림을 받아야 할 때 푸시 알림 허용을 활성화해. 표시되는 알림 섹션은 선택한 플랫폼에 따라 달라요.

다음과 같은 푸시 제공자 옵션을 사용할 수 있어요.

안드로이드: 파이어베이스 클라우드 메시징 (FCM), 화웨이, 아니면 둘 다예요. 웹엑스 컨택 센터 및 웹엑스 컨택 센터 엔터프라이즈에 적용돼요. Webex Connect
iOS: FCM, 애플 푸시 알림 서비스 (APNS) 또는 APNS용 토큰 기반 인증. 웹엑스 컨택 센터 및 웹엑스 컨택 센터 엔터프라이즈에 적용돼요. Webex Connect
웹: 파이어베이스 클라우드 메시징. Webex Connect에만 적용돼요.

플랫폼을 선택하고 해당 주제에서 해당 공급자를 구성하세요.

파이어베이스 서비스 계정 JSON 받기

웹엑스는 파이어베이스 서비스 계정 JSON 파일을 사용하여 파이어베이스 클라우드 메시징에 대한 서버 요청을 인증해요. 애플리케이션과 연결된 Firebase 프로젝트를 사용하세요.

파이어베이스 서비스 계정 JSON을 받아서 업로드하려면:

보안: Firebase 서비스 계정 JSON에는 민감한 자격 증명이 포함되어 있어요. 안전하게 보관하고 의도한 Firebase 프로젝트의 파일만 업로드하세요.

Firebase 클라우드 메시징 구성 지침은 FCM HTTP v1 API를 사용하여 메시지 보내기를 참조하세요.

1	Firebase 콘솔을 열고 애플리케이션에서 사용하는 Firebase 프로젝트를 선택하세요.
2	프로젝트 설정 > 서비스 계정 여세요.
3	새 개인 키 생성을 선택하고 다운로드를 확인해요.
4	다운로드한 JSON 파일을 안전하게 저장하세요. 파일에 개인 키 자격 증명이 들어 있어요.
5	컨트롤 허브에서 해당 안드로이드, iOS 또는 웹 알림 구성의 Firebase 서비스 계정 업로드 JSON 파일에 JSON 파일을 업로드하세요.

안드로이드 푸시 알림 구성하세요

안드로이드 알림 섹션은 모바일, 안드로이드, 푸시 알림 허용을 선택하면 표시돼요. 제공업체를 하나 이상 선택해 주세요. Firebase와 Huawei는 개별적으로 또는 함께 구성할 수 있어요. 이 구성은Webex Connect, Webex 컨택 센터 및 Webex 컨택 센터 엔터프라이즈 모바일 에셋에 사용할 수 있어요.

제공자 문서: 화웨이 - 푸시 키트 설정 및 테스트

1	모바일, 안드로이드, 푸시 알림 허용을 선택하세요. 안드로이드 알림 섹션이 표시돼요.
2	Firebase 클라우드 메시징을 선택하고 Firebase 프로젝트에서 필요한 Firebase 서비스 계정 JSON 파일을 업로드하세요.
3	앱이 화웨이 모바일 서비스를 사용하는 기기를 지원한다면, 화웨이를 선택하고 앱갤러리 커넥트의 인앱 ID와 인앱 시크릿을 입력하세요. Huawei 예외: 앱이 Google Play 서비스 없는 기기를 지원하지 않으면 Huawei 구성을 건너뛸 수 있어요. 현재 Webex Connect 지침은 EMUI 10.x 이상을 지원해요.

iOS 푸시 알림 구성하세요

iOS 알림 섹션은 모바일, iOS, 푸시 알림 허용을 선택하면 표시돼요. 푸시 제공업체 하나 선택해 주세요. 이 구성은Webex Connect, Webex 컨택 센터 및 Webex 컨택 센터 엔터프라이즈 모바일 에셋에 사용할 수 있어요.

인증서 기반 APN 구성 지침은 APN에 대한 인증서 기반 연결 설정을 참조하세요.

토큰 기반 APN 구성 지침은 APN에 토큰 기반 연결 설정을 참조하세요.

1	모바일, iOS, 푸시 알림 허용을 선택해요. iOS 알림 섹션이 표시돼요.
2	푸시 제공업체 하나 선택해 주세요.
3	Firebase 클라우드 메시징의 경우 Firebase 프로젝트에서 다운로드한 Firebase 서비스 계정 JSON 파일을 업로드하세요.
4	애플 푸시 알림 서비스 (APNS) 의 경우 인증서 암호를 입력하고 샌드박스 또는 프로덕션을 선택하고 APNS 인증서를 업로드하고 이름을 입력하고 구성을 검증하세요. .p12 인증서 형식만 지원돼요.
5	토큰 기반 APNS 인증의 경우 키 ID, 팀 ID, 앱 패키지 또는 번들 ID를 입력하고 샌드박스 또는 프로덕션을 선택하고 APNS 개인 키 파일을 업로드하세요. 게이트웨이 선택: 개발 앱에는 샌드박스를 사용하고 프로덕션용 앱에는 프로덕션을 사용하세요. APNS 개인 키를 안전하게 보관하세요. 애플은 다운로드한.p8 키 파일을 한 번만 검색할 수 있도록 허용해요.
6	푸시 딜리버리가 중단되지 않도록 Apple 제공업체 인증서가 만료되기 전에 교체하세요.

웹 푸시 알림 구성하세요

웹 푸시 알림은 웹을 선택하여 Webex Connect 할당된 자산에만 사용할 수 있어요. 크롬하고 파이어폭스 지원돼요. 사파리 웹 푸시는 현재 지원되지 않아요.

웹엑스 컨택 센터 또는 웹엑스 컨택 센터 엔터프라이즈에 할당된 에셋에는 웹 푸시 알림이 지원되지 않아요.

웹 푸시 알림 구성하려면:

1	에셋이 Webex Connect 할당되었고 웹이 선택되었는지 확인해요.
2	크롬이나 파이어폭스로 웹사이트에 접속하고 웹 푸시 알림을 받아요.
3	웹사이트 URL (필수): 웹 푸시 알림을 받을 웹사이트 URL을 입력하세요.
4	알림 아이콘 (필수): 알림 아이콘 경로를 입력하세요. 아이콘은 80 x 80픽셀이어야 해요.
5	Firebase 문서에 따라 웹 애플리케이션에 Firebase 클라우드 메시징 (FCM) 을 구성하세요.
6	파이어베이스 서비스 계정 JSON (필수): 파이어베이스 클라우드 메시징 HTTP v1 API를 사용하는 데 필요한 개인 키가 들어 있는 Firebase 서비스 계정 JSON 파일을 업로드하세요.

JSON 웹 토큰 인증 구성하세요

JWT 인증을 받으려면 유효한 JSON 웹 토큰을 사용하여 SDK 통신을 인증해야 해요. 새 자산의 경우 암호화 유형은 비대칭이에요.

JWT 지원은 다음과 같아요.

Webex Connect: 동일한 에셋에서 모바일과 웹에서 지원돼요.
웹엑스 컨택 센터 및 웹엑스 컨택 센터 엔터프라이즈 - 웹: 지원되지 않아요.
웹엑스 컨택 센터 및 웹엑스 컨택 센터 엔터프라이즈 - 모바일: 모바일 자산 구성을 위해 지원되고 필수예요.

다음 설정을 구성하세요.

암호화 유형: 새 자산의 경우 비대칭이에요.
토큰 만료 (필수): 새 사용자 ID 토큰이 필요하기 전에 JWT의 유효 기간을 입력하세요. 유효 범위: 5~360분이에요. 기본값: 60분이에요.
JSON 웹 키 (필수): 토큰 검증에 사용한 공개 JWK를 업로드하세요. 회전을 위한 두 번째 키를 추가할 수 있어요. 최대: 키 두 개예요.

하위 주제에 설명된 대로 공개 JSON 웹 키를 추가하고 준비하세요.

대중을 준비하세요 JWK

업로드한 파일은 공개 RSA 인증 키를 포함해야 해요. 웹엑스는 다음 JWK 속성을 검증해요.

JWK 속성은 RFC 7517, 섹션 4에 정의되어 있어요. 알고리즘별 속성은 RFC 7518에 정의되어 있어요.

테이블 2예요.JWK 퍼블릭 프로퍼티즈
부동산 이름	설명
알그	키에 사용된 암호화 알고리즘을 식별해요. 필수 값은 RS256, SHA-256 v1_5 사용 시 RSASSA-PKCS1- 지정해요.
e	Base64URL 인코딩 값으로 표시되는 RSA 공개 키의 지수예요.
key_ops	키 대상 작업을 지정해요. 지원되는 값은 검증인데, 이는 키가 디지털 서명을 확인하는 데 사용된다는 뜻이에요. RFC 7517, 섹션 4.3을 참조하세요.
키티	키에 사용된 암호화 알고리즘 제품군을 식별해요. 값은 RSA여야 해요. RFC 7517, 섹션 4.1 참조.
n	Base64URL 인코딩 값으로 표시되는 RSA 공개 키의 모듈러스예요.
사용해요	공개 키의 사용 용도를 지정해요. 값은 시그여야 해요. 시그여야 하는데, 이는 키가 서명 검증을 위한 것임을 나타냅니다. RFC 7517, 섹션 4.2 참조.
꼬마예요	키를 식별하고 특정 키를 매칭하는 데 사용돼요. 예를 들어 키 회전 중에 말이죠. RFC 7517, 섹션 4.5 참조.

공개 인증 키만 업로드하세요. JWT를 발행하는 신뢰할 수 있는 시스템에 해당 개인 서명 키를 보관하세요.

JSON 웹 키 추가해요

공개 JSON 웹 키를 추가하려면:

1	키 추가를 선택해요.
2	JSON 웹 키 이름을 입력하세요.
3	JSON 웹 키 발급자를 입력하세요. 이 값은 신뢰할 수 있는 백엔드가 JWT를 생성할 때 사용하는 발행자와 일치해야 해요.
4	공개 JWK 파일을 업로드하세요.
5	저장을 선택해요.

다중 사용자 등록 구성하세요

여러 사용자가 동일한 물리적 장치에 등록할 수 있을 때 동일한 장치에서 다중 사용자 등록 허용을 활성화하세요.

푸시 알림은 활성 등록 사용자와 비활성 등록 사용자 모두에게 전달돼요.
라이브 채팅 또는 인앱 메시지가 현재 활성 사용자에게 전달돼요. 비활성 사용자를 위한 메시지는 사용자가 다시 활성 상태가 될 때까지 대기열에 있어요.

추가 Webex Connect 설정 구성하세요

다음 고급 설정은 Webex Connect 에셋에만 적용되고 웹엑스 컨택 센터 또는 웹엑스 컨택 센터 엔터프라이즈 에셋에는 적용되지 않아요.

사용자당 기기 한 대: 사용자를 등록된 기기 한 대로 제한해요. 새 장치에 등록하면 이전 장치로의 푸시 전달이 중지돼요.
서버측 수신함: 나중에 검색할 수 있도록 받은 편지함 데이터의 서버 측 사본을 저장해요.
데이터 스트림: 메시징 API를 통해 보낸 메시지에 대해 해당 이벤트 데이터를 선택한 Webex Connect 통합에 보낸대요.

저장해서 애셋 만들어요.

해당 메시징, JWT 인증, 다중 사용자 등록 및 Webex Connect 설정을 구성한 후 구성을 저장하여 Chat 자산을 생성하세요.

저장을 선택해서 애셋을 만들어요.

애셋이 성공적으로 생성되었는지 확인될 때까지 기다리세요.

완벽한 서비스 통합

Chat 자산을 만든 후 배정에서 선택한 서비스의 통합을 완료하세요. 웹엑스 컨택 센터 또는 웹엑스 컨택 센터 엔터프라이즈에 해당하는 절차를 따르세요. Webex Connect

완전한 Webex Connect 통합

할당된 Webex Connect 자산의 경우 에서 서비스 매핑과 흐름 구성을 Webex Connect 완료하세요. 노드 인증은 필요 없어요.

시작 노드, 사용자 지정 이벤트, 사용자 지정 웹훅을 사용하여 들어오는 이벤트를 캡처하고 흐름을 트리거할 수 있어요. 자세한 내용은 시작 노드, 사용자 지정 이벤트, 사용자 지정 웹훅을 참조하세요.

1	에 Webex Connect 로그인하세요.
2	Chat 자산에 해당하는 서비스 매핑과 흐름 구성을 완료하세요.
3	생성된 앱 ID와 클라이언트 키를 기록하세요.
4	선택한 각 플랫폼의 SDK 구성 파일을 다운로드하세요.

완벽한 웹엑스 컨택 센터 통합

Webex 컨택 센터에 할당된 에셋의 경우, 자산을 컨택 센터 진입점에 매핑한 다음 Webex Contact Center 노드 인증을 완료하세요.

자산은 하나의 진입점에만 매핑될 수 있어요. 고객 경험을 게시하기 전에 진입점과 플로우 매핑을 완료하세요.

1	컨트롤 허브에서 컨택 센터 구성을 여세요.
2	채팅 대화 받는 진입점을 만들거나 여세요.
3	플로우 매핑에서 Chat 자산하고 필요한 고객 입력 흐름을 선택하세요.
4	진입점을 저장하고 자산과 플로우 매핑을 확인해요.
5	Webex 컨택 센터 노드 인증을 완료했어요. Webex Connect 지침은 Webex CC 작업 통합 노드 및 노드 인증을 참조하십시오.
6	웹 배포의 경우, 라이브 채팅 위젯을 구성하고 컨트롤 허브에서 웹사이트 임베드 코드를 얻으세요.

완벽한 웹엑스 컨택 센터 엔터프라이즈 통합

Webex 컨택 센터 엔터프라이즈에 할당된 자산의 경우, 라우팅 흐름을 Webex Connect 구성하기 전에 CCE 노드 인증을 완료하세요.

1	에 Webex Connect 로그인하세요.
2	완전한 CCE 노드 승인. 지침은 CCE 통합 노드 및 노드 승인을 참조하세요.
3	Chat 자산에 해당하는 CCE 통합 노드와 라우팅 흐름을 구성하세요. 흐름 예시는 흐름 구성을 참조하세요.
4	저장하고 흐름을 테스트해 보세요.

추가 구성 지침은 모범 사례 및 지침과 FAQ를 참조하십시오.

예외 및 제한

다음 예외 및 제한 사항을 염두에 두세요.

애셋을 만들기 전에 채널, 플랫폼, 배정, 라우팅 선택을 확인해요. 채널을 만든 후에는 변경할 수 없고 플랫폼 변경은 워크로드에 의해 제한돼요.
웹엑스 컨택 센터와 웹엑스 컨택 센터 엔터프라이즈의 경우, 단일 에셋으로는 웹과 모바일을 함께 사용할 수 없어요. 둘 다 필요하면 별도의 자산을 만드세요.
웹 푸시 알림은 에서만 사용할 수 있어요Webex Connect. 사파리 웹 푸시, 웹엑스 컨택 센터 웹 푸시, 웹엑스 컨택 센터 엔터프라이즈 웹 푸시는 지원되지 않아요.
웹엑스 컨택 센터 또는 웹엑스 컨택 센터 엔터프라이즈에 할당된 웹 자산에는 JWT 인증이 지원되지 않아요.
웹엑스 컨택 센터 및 웨벡스 컨택 센터 엔터프라이즈의 경우, 컨트롤 허브의 컨택 센터 섹션에서 진입점, 플로우, 위젯 및 임베드 코드 구성을 수행하세요.
필요한 Webex Connect 경우 에서 서비스와 흐름 구성을 Webex Connect 완료하세요.
Chat 자산이 서비스에 매핑된 후에는 다운스트림 매핑을 먼저 제거하거나 업데이트하지 않고는 삭제하지 마세요. 삭제한 자산은 복원할 수 없고 기존 매핑을 사용할 수 없게 둘 수 있어요.
만든 후에는 적절한 SDK를 초기화하는 데 필요한 생성된 앱 ID, 클라이언트 키, SDK 구성 파일을 보관해 두세요.

Cisco AI Assistant

피드백을 보내 주셔서 감사합니다.

개요