Salesforce의 임베디드 환경 설정

Salesforce Service 콘솔을 열고 오른쪽 상단에 있는 설정(기어) 아이콘을 선택합니다.

검색 필드에 콜센터를 입력한 후 검색 결과에서 콜센터를 선택합니다.

이 위젯을 처음 설정하는 경우 Salesforce 콜 센터에 인사하기라는 메시지가 있는 페이지가 표시될 수 있습니다.

계속을 선택합니다.

텍스트 편집기를 열고 다음 XML 코드를 복사하여 로컬에 CopilotForServiceConfig.xml로 저장합니다.

  <callCenter>
  <section sortOrder="0" name="reqGeneralInfo" label="General Information">
  <item sortOrder="0" name="reqInternalName" label="InternalName">CopilotForService</item>
  <item sortOrder="1" name="reqDisplayName" label="Display Name">Copilot For Service</item>
  <item sortOrder="2" name="reqAdapterUrl" label="CTI Adapter URL">https://TobeUpdated.ms</item>
  <item sortOrder="3" name="reqUseApi" label="Use CTI API">true</item>
  <item sortOrder="4" name="reqSoftphoneHeight" label="Softphone Height">600</item>
  <item sortOrder="5" name="reqSoftphoneWidth" label="Softphone Width">450</item>
  <item sortOrder="6" name="reqSalesforceCompatibilityMode" label="Salesforce Compatibility Mode">Classic_and_Lightning</item>
  </section>
 </callCenter>

가져오기>파일 선택을 선택한 다음 4단계에서 저장한 CopilotForServiceConfig.xml 파일을 찾아 선택합니다.

가져오기를 선택합니다.

편집을 선택한 후, CTI 어댑터 URL 필드에서 1단계에서 저장한 서비스 위젯 URL을 붙여넣으세요.

저장을 선택합니다.

Salesforce 사용자를 추가하려면 다음 단계를 수행합니다.

1. Salesforce Service 콘솔에서 콜센터 사용자 관리>사용자 추가를 선택합니다.
2. Microsoft 365 Copilot 위젯에서 서비스에 접근하고 싶은 세일즈포스 사용자를 모두 추가하세요.

다음 단계를 수행하여 소프트폰 유틸리티를 추가합니다.

1. 설정을 선택한 후, 앱 관리자를 검색하여 선택하세요.
2. 서비스 콘솔 앱을 찾아 같은 행에 있는 역삼각형을 선택한 후 편집을 선택합니다.
3. 유틸리티 항목>유틸리티 항목 추가를 선택하세요.
4. CTI 소프트폰 열기를 검색하여 선택합니다.
5. 위젯 이름을 "Service in Microsoft 365 Copilot"과 같이 입력하세요.
6. 너비를 450으로 설정하고 높이를 600으로 설정합니다.
7. 저장을 선택합니다.

팝업을 활성화하려면 다음 단계를 수행합니다.

1. Salesforce의 앱 페이지에서 서비스 콘솔로 이동합니다.
2. <URL>에서 항상 팝업 및 리디렉션 허용을 선택하여 팝업을 활성화합니다.
3. 완료를 선택합니다.
4. 브라우저를 새로 고칩니다. Microsoft 365 Copilot의 서비스 애드온은 이제 에이전트 콘솔의 툴바에서 이용할 수 있을 것입니다.

1. Salesforce Service Console을 열고 톱니바퀴 아이콘을 선택합니다.

2. 드롭다운에서 개발자 콘솔을 선택합니다. 로드되지 않으면 팝업 창에서 URL을 복사하여 새 탭에서 엽니다.

3. 개발자 콘솔에서 파일>새로 만들기>Apex 클래스를 선택합니다. 이름을 ObjectService로 지정하고 만들기를 선택한 후 다음 코드를 편집기에 붙여넣습니다.

   public class ObjectService {
     @AuraEnabled
     public static String getObjectType(String objectId) {
       Id conId = objectId;
       return String.valueOf(conId.getSobjectType());
     }
   }
   

4. 라이트닝 구성 요소를 만들려면 다음 단계를 수행합니다.

   1. 파일>새로 만들기>라이트닝 구성 요소를 선택합니다.
   2. 구성 요소의 이름을 지정합니다. CopilotForService를 예로 들 수 있습니다.
   3. 구성 요소가 생성될 때 표시되는 번들 패널에서 컨트롤러를 선택하고 다음 코드를 붙여넣습니다.

   ({
     onTabFocused : function(component, event, helper) {
       var currentTabId = event.getParam('currentTabId');
       var previousTabId = event.getParam('previousTabId');
       var workspaceAPI = component.find("workspace");
       if(currentTabId) {       
         workspaceAPI.getTabInfo({
           tabId : currentTabId
         }).then(function(response) {
           var action = component.get("c.getObjectType");
           var recordId = response.recordId;
           action.setParams({"objectId": recordId});
           action.setCallback(this, function(response) {
             var state = response.getState();
             if(state === "SUCCESS") {
               component.set("v.objectType",response.getReturnValue());
               var type = response.getReturnValue();          
               console.log("Object details:", recordId, type);
               var objectType = 0;
               if (type == 'Case') {
                 objectType = 1;
               } else if (type == 'EmailMessage') {
                 objectType = 2;
               } else if (type == "LiveChatTranscript") {
                 objectType = 8;
               }
   
               console.log("iframe: ", document.querySelector('iframe.CFSLightning'));
               // Invoke adapter to navigate based on objectid and objecttype
               document.querySelector('iframe.CFSLightning').contentWindow.postMessage({
                 messageType: "onPageNavigateFromSFLightningComponent",
                 messageData: JSON.stringify({
                   value: JSON.stringify({
                     objectId: recordId,
                     objectType: objectType,
                     sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850"
                   })
                 })
               }, "*");
             } else {
               console.log('Problem updating the case, response state: ' + state);
             }
           });
           $A.enqueueAction(action);
         });
       } else {
         // When user navigates to the entity list page, switch to global session
         console.log("global!");
         document.querySelector('iframe.CFSLightning').contentWindow.postMessage({
           messageType: "onPageNavigateFromSFLightningComponent",
           messageData: JSON.stringify({
             value: JSON.stringify({
               objectId: "",
               objectType: 0,
               sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850"
             })
           })
         }, "*");
       }
     }
   })
   

   1. 저장을 선택합니다.
   2. 구성 요소를 선택하고, 다음 코드를 복사합니다.

   <aura:component controller="ObjectService" implements="force:lightningQuickAction,force:hasRecordId,flexipage:availableForAllPageTypes" access="global">
     <aura:attribute name="recordId" type="Id" />
     <aura:attribute name="objectType" type="String" />
     <lightning:workspaceAPI aura:id="workspace" />        
     <aura:handler event="lightning:tabFocused" action="{! c.onTabFocused }"/>
     <iframe class="CFSLightning" src="{! '{CFS_WIDGET_URL}'}" width="100%" height="100%" />   
   </aura:component>
   

   1. 이전 단계에서 저장한 Microsoft 365 Copilot 위젯 서비스의 URL로 업데이트 {CFS_WIDGET_URL} 하세요.

1. 설정을 선택한 후, 앱 관리자를 검색하여 선택하세요.
2. 서비스 콘솔 앱을 검색한 후 선택합니다. 편집을 선택합니다.
3. 유틸리티 항목>유틸리티 항목 추가를 선택하세요.
4. 이 예에서는 사용자 지정, CopilotForService를 검색하고 선택합니다.
5. 위젯의 이름을 지정합니다. 예를 들어, Microsoft 365 Copilot의 서비스 같은 경우입니다.
6. 너비를 450으로 설정하고 높이를 600으로 설정합니다.
7. 저장을 선택합니다.

1. Salesforce의 앱 페이지에서 서비스 콘솔로 이동합니다.
2. <URL>에서 항상 팝업 및 리디렉션 허용을 선택하여 팝업을 활성화합니다.
3. 완료를 선택합니다.
4. 브라우저를 새로 고칩니다. Microsoft 365 Copilot의 서비스 애드온은 이제 에이전트 콘솔의 툴바에서 이용할 수 있을 것입니다.

1. 설정의 검색창에서 신뢰할 수 있는 URL을 검색한 후, 신뢰할 수 있는 URL을 선택합니다.
2. 새로운 신뢰할 수 있는 URL을 선택하여 새로운 신뢰할 수 있는 URL을 추가합니다.
   • CopilotforService를 API 이름으로 지정하고 URL을 "*.azureedge.net"으로 지정
3. CSP 지시문의 모든 확인란을 선택한 다음 저장을 선택합니다.