이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Salesforce 통합

Agent Assist UI 모듈을 Salesforce와 통합하여 고객 서비스 채팅 대화 중에 상담사에게 실시간 제안을 제공하세요.

Agent Assist Lightning 웹 구성요소 (LWC)를 사용하면 Agent Assist 기능을 Salesforce 상담사 데스크톱에 가져올 수 있습니다. Agent Assist는 고객 지원 담당자에게 실시간 지원을 제공하여 고객 문제를 더 빠르게 해결하고, 전송 준비가 완료된 응답을 표시하며, 중앙 집중식 기술 자료에서 고객 질문에 대한 답변을 제안합니다.

Salesforce에서 개발한 LWC는 구성요소 로직과 템플릿을 정의하기 위한 최신 JS 프레임워크입니다. Agent Assist LWC는 Salesforce 인스턴스에 배포되고 Salesforce 인스턴스에서 제공됩니다. 향상된 보안을 제공하며 Salesforce 데이터 및 API와 직접 통합됩니다.

시작하기 전에

Agent Assist UI 모듈을 Salesforce와 통합하려면 다음 리소스에 액세스할 수 있어야 합니다.

Node.js

Google에서는 Node.js 18.20.4를 테스트했으며 이를 권장합니다. Node.js 20.18.0과 관련하여 알려진 호환성 문제가 있습니다.
Salesforce CLI

(sudo) npm install -g @salesforce/cli 코드를 사용하여 설치합니다.
Gcloud CLI

안내에 따라 gcloud 명령어를 설치하고 gcloud auth login를 사용하여 인증합니다.
Salesforce UI
- 인스턴스 URL 또는 login.salesforce.com에서 로그인하고 다음 사항을 확인합니다.
  - Salesforce '내 도메인 URL' 메뉴 바 > 설정 메뉴로 이동한 다음 설정을 클릭합니다. 빠른 찾기에서 '내 도메인'을 검색합니다. 도메인 이름의 형식은 MY-DOMAIN-NAME.develop.my.salesforce.com입니다.
  - Salesforce 조직 ID입니다. 메뉴 바 > 설정 메뉴로 이동한 다음 설정을 클릭합니다. 빠른 찾기에서 '회사 정보'를 검색합니다.
Agent Assist 통합 백엔드
- 안내에 따라 통합을 설정합니다.
- 배포 스크립트를 실행하기 전에 deploy.sh 또는 프로젝트 루트의 .env 파일에서 다음 환경 변수를 구성합니다.
  - AUTH_OPTION: SalesforceLWC로 설정합니다.
  - SALESFORCE_DOMAIN: 다음과 유사한 도메인 이름(예: YOUR_SUBDOMAIN.develop.lightning.force.com) Salesforce UI 기본 요건에서 이 값을 확인했습니다. https://는 포함하지 마세요.
  - SALESFORCE_ORGANIZATION_ID: Salesforce UI 기본 요건에서 이 값을 확인했습니다.

1단계: 프로젝트 설정

Agent Assist UI 모듈 통합을 시작하려면 다음 단계를 따르세요.

다음 코드를 실행하여 Agent Assist 통합 저장소를 클론하고 프로젝트를 엽니다.
```
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
cd salesforce/aa-lwc
```
다음 명령어를 실행하여 나중에 정적 리소스로 배포되는 JS 파일을 다운로드합니다.
```
npm run generate-static-resources
npm install
```

2단계: 환경 설정

프로덕션 또는 개발과 같은 특정 환경에 Agent Assist UI 모듈을 통합할 수 있습니다. Salesforce에서는 이러한 환경을 조직이라고 합니다.

Salesforce 콘솔에서 조직 구성

Salesforce 콘솔에서 다음 단계에 따라 Agent Assist 통합을 위해 조직을 구성합니다.

메뉴 바 > 설정 메뉴로 이동한 다음 설정을 클릭합니다. 빠른 찾기에서 '옴니채널 설정'을 검색한 후 옴니채널 설정을 클릭합니다.
1. Enable Omni-Channel(옴니채널 사용 설정)을 선택합니다.
2. 새 창 또는 탭에서 상담사를 Omni-Channel에 자동으로 로그인을 선택합니다.
3. 저장을 클릭합니다.
메뉴 바 > 설정 메뉴로 이동한 다음 설정을 클릭합니다. 빠른 찾기에서 '커뮤니티'를 검색한 다음 디지털 환경 > 설정을 클릭합니다.
1. 경험 워크스페이스 사용 설정을 선택합니다.
2. 저장을 클릭합니다.

Salesforce CLI로 조직 구성

Salesforce CLI를 사용하여 Agent Assist 통합을 위해 조직을 구성하려면 다음 단계를 따르세요.

다음 코드를 실행하고 평소에 사용하는 Salesforce 로그인 세부정보를 사용하여 CLI를 인증합니다.
```
npm run login
```
다음 코드를 실행하여 LWC를 조직에 배포합니다.
```
npm run deploy
```

3단계: 연결된 앱 만들기

상담사 지원 LWC는 클라이언트 사용자 인증 정보 OAuth 2.0 흐름을 사용하여 사용자를 인증합니다. 연결된 애플리케이션 (앱)은 클라이언트 사용자 인증 정보 흐름을 사용 설정합니다. 앱의 소비자 키와 소비자 비밀을 사용하여 Agent Assist LWC를 구성하여 Salesforce로 사용자를 인증합니다.

메뉴 바 > 설정 메뉴로 이동한 다음 설정을 클릭합니다. 빠른 찾기에서 '앱 관리자'를 검색합니다.
1. 새 연결된 앱 > 연결된 앱 만들기 > 계속을 클릭한 다음 다음 정보를 입력합니다.
  - 연결된 앱 이름: lwc auth
  - API 이름: lwc_auth
  - 연락처 이메일: your_email@example.com
  - OAuth 설정 사용: 선택됨
  - 콜백 URL: https://login.salesforce.com/services/oauth2/callback
  - 선택한 OAuth 범위: ID URL 서비스에 액세스
  - 클라이언트 사용자 인증 정보 흐름 사용 설정: 선택됨
2. 저장을 클릭합니다.
메뉴 바 > 설정 메뉴로 이동한 다음 설정을 클릭합니다. 빠른 찾기에서 '연결된 앱 관리'를 검색합니다.
1. 연결된 앱 이름 > 정책 수정을 클릭합니다.
2. 클라이언트 사용자 인증 정보 흐름으로 이동합니다.
3. Run As(이름으로 실행)에서 돋보기를 클릭한 다음 사용자 이름을 선택합니다.
4. 저장을 클릭합니다.
메뉴 바 > 설정 메뉴로 이동한 다음 설정을 클릭합니다. 빠른 찾기에서 '앱 관리자'를 검색합니다.
1. lwc auth를 찾아 아이콘을 클릭합니다.
2. 보기 > 소비자 세부정보 관리를 클릭합니다.
3. 이메일로 전송된 인증 코드를 입력합니다.
4. 고객 키와 고객 보안 비밀을 안전한 장소에 복사합니다. 나중에 필요합니다.
메뉴 바 > 설정 메뉴로 이동한 다음 설정을 클릭합니다. 빠른 찾기에서 'CORS'를 검색한 다음 수정을 클릭합니다.
1. OAuth 엔드포인트에 CORS 사용 설정을 선택합니다.
2. 저장을 클릭합니다.

연결된 앱에 관한 자세한 내용은 다음 Salesforce 리소스를 참고하세요.

4단계: 채팅 클라이언트 구성

Salesforce에서 Agent Assist UI 모듈을 사용하려면 상담사 데스크톱에 채팅 클라이언트가 있어야 합니다.

인앱 및 웹용 메시지 구성

메신저를 구성하려면 다음 단계를 따르세요.

메뉴 바 > 설정 메뉴로 이동한 다음 설정을 클릭합니다. 빠른 찾기에서 '신뢰할 수 있는 URL'을 검색한 다음 신뢰할 수 있는 새 URL을 클릭합니다.
1. API 이름(ui_connector)을 입력합니다.
2. Agent Assist 통합 백엔드로 배포한 UI 커넥터 Cloud Run 서비스 엔드포인트의 URL을 입력합니다. 이 URL은 Cloud Run 콘솔에서 확인할 수 있습니다. 예를 들면 https://UI_CONNECTOR_SUBDOMAIN.gcp-region.run.app입니다.
3. CSP 지시어의 체크박스를 모두 선택합니다.
4. 저장 및 새 항목을 클릭합니다.
5. API 이름(salesforce_domain)을 입력합니다.
6. Salesforce 도메인의 URL을 https://YOUR_SUBDOMAIN.my.salesforce.com 형식으로 입력합니다.
7. CSP 지시어의 체크박스를 모두 선택합니다.
8. 저장을 클릭합니다.
메뉴 바 > 설정 메뉴로 이동한 다음 설정을 클릭합니다. 빠른 찾기에서 '대기열'을 검색한 다음 새로 만들기를 클릭합니다.
1. 다음 정보를 입력합니다.
  - 라벨: 메시지 대기열
  - 대기열 이름: Messaging_Queue
  - 라우팅 구성: Messaging_Routing_Configuration
2. 지원되는 객체를 클릭한 다음 'Messaging User, Messaging Session'(메시지 사용자, 메시지 세션)을 추가합니다.
3. 대기열 구성원을 클릭한 다음 '사용자: 로그인 사용자'를 추가합니다.
4. 저장을 클릭합니다.
메뉴 바 > 설정 메뉴로 이동한 다음 설정을 클릭합니다. 빠른 찾기에서 '권한 세트'를 검색합니다.
1. Messaging Agents Permission Set(메시지 상담사 권한 세트)을 클릭합니다.
2. Service Presence Statuses Access(서비스 상태 액세스) > Edit(수정)을 클릭합니다.
3. Busy(중) 및 Online - Messaging(대화 중) 상태를 선택합니다.
4. 추가 > 저장을 클릭합니다.
메뉴 바 > 설정 메뉴로 이동한 다음 설정을 클릭합니다. 빠른 찾기에서 '사용자'를 검색한 다음 사용자를 클릭합니다.
1. 사용자 이름을 클릭하고 Service Cloud 사용자가 사용 설정되어 있는지 확인합니다.
2. 페이지에서 권한 세트 라이선스 할당을 찾습니다.
3. 과제 수정을 클릭한 다음 인앱 및 웹 사용자를 위한 메시지를 선택합니다.
4. 저장을 클릭합니다.
5. 페이지에서 권한 세트 할당을 찾습니다.
6. 할당 수정을 클릭한 다음 메시지 상담사 권한 세트를 선택합니다.
7. 추가 > 저장을 클릭합니다.
메뉴 바 > 설정 메뉴로 이동한 다음 설정을 클릭합니다. 빠른 찾기에서 '메시지 설정'을 검색한 다음 새 채널을 클릭합니다.
1. 인앱 및 웹용 메시지를 선택합니다.
2. 이름: 메시지 채널을 입력합니다.
3. 저장을 클릭합니다.
4. 라우팅 유형을 'Omni-Queue'로, 대기열을 'Messaging Queue'로 설정합니다.
5. 저장을 클릭하고 메시지 설정으로 이동합니다.
6. 메시지 채널 이름을 클릭한 다음 활성화를 클릭합니다.
7. 이용약관을 읽은 후 이용약관에 동의합니다.
메뉴 바 > 설정 메뉴로 이동한 다음 설정을 클릭합니다. 빠른 찾기에서 'Embedded Service Deployments(삽입된 서비스 배포)'를 검색한 다음 New Deployment(새 배포)를 클릭합니다.
1. 인앱 및 웹용 메시지 > 다음 > 웹 > 다음을 클릭합니다.
2. 다음 세부정보를 입력합니다.
  - 이름: 메시지 삽입 서비스 배포
  - 개발자 이름: Messaging_Embedded_Service_Deployment
  - 도메인: example.com
  - 채널: 메시지 채널
3. 저장을 클릭합니다. 배포가 완료될 때까지 기다립니다.
4. 삽입된 서비스 배포 설정에서 게시를 클릭합니다.
5. 새로고침을 클릭한 다음 메시지 테스트를 클릭합니다.

인앱 및 웹용 메시지 테스트

메신저를 테스트하려면 다음 단계를 따르세요.

메시지 테스트를 클릭합니다.
새 탭이 로드되면 말풍선을 클릭하여 새 테스트 대화를 시작합니다.
"Test"와 같은 메시지를 보냅니다.
Salesforce 브라우저 탭으로 이동합니다.
설정 툴바에서 앱 실행 도구 메뉴를 클릭한 다음 Service Console을 선택합니다.
유틸리티 툴바에서 옴니채널을 클릭합니다.
상태를 Online - Messaging(대화 가능 - 메시지)로 설정합니다.

수신 대화가 표시됩니다. 수락합니다. 이렇게 하면 Service Console에서 대화용 새 탭이 열립니다. 채팅 스크립트를 볼 수 없습니다.
메뉴 바 > 설정 메뉴로 이동한 다음 페이지 수정을 클릭합니다.
구성요소 메뉴에서 향상된 대화를 대화 창으로 드래그합니다.
저장 > 활성화 > 조직 기본값으로 할당 > 데스크톱 > 를 클릭합니다.
페이지를 새로고침합니다.
유틸리티 툴바에서 옴니채널을 클릭합니다.
상태를 Online - Messaging(대화 가능 - 메시지)로 설정합니다.
'테스트' 메시지에 답장하여 메시지가 작동하는지 확인합니다.

문제가 발생하여 추가 정보가 필요한 경우 포괄적인 인앱 및 웹 설정을 위한 Salesforce 메시지 가이드를 참고하세요.

5단계: 상담사 지원 LWC 설치

Lightning Experience 편집기를 사용하여 메시지 세션 페이지에 Agent Assist LWC를 추가하려면 다음 단계를 따르세요. 4단계에서 테스트 대화를 계속 진행합니다.

메뉴 바 > 설정 메뉴로 이동한 다음 페이지 수정을 클릭합니다.
구성요소 사이드바에서 agentAssistContainerModule를 사이드바로 이동합니다.

참고: npm deploy 명령어에서 이 구성요소를 제공했습니다.
이전 단계에서 배치한 구성요소를 클릭합니다. 다음과 같이 양식 필드를 작성하여 구성 세부정보를 추가합니다.
- endpoint: Agent Integration Backend UI 커넥터의 URL입니다. 예를 들어 Cloud Run 콘솔의 URL(예: https://UI-CONNECTOR-ENDPOINT.GCP-REGION.run.app)입니다.
- features: 포함할 Agent Assist 기능입니다. 대화 프로필에서 사용 설정해야 합니다. 사용 가능한 기능에는 CONVERSATION_SUMMARIZATION,KNOWLEDGE_ASSIST_V2,SMART_REPLY,AGENT_COACHING 등이 있습니다.
- conversationProfile: Agent Assist 대화 프로필 리소스 이름입니다. 예를 들어 projects/GCP-PROJECT-ID/locations/GCP-REGION/conversationProfiles/CONVERSATION-PROFILE-ID와 같습니다.
- consumerKey: 3단계의 연결된 앱 고객 키입니다.
- consumerSecret: 3단계의 연결된 앱 고객 보안 비밀입니다.