Настройка встроенного интерфейса в 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>

Выберите Импорт>Выберите файл, а затем выберите файл CopilotForServiceConfig.xml, сохраненный на шаге 4.

Выберите Импорт.

Выберите Изменить, затем в поле URL-адрес адаптера CTI вставьте URL-адрес мини-приложения Copilot для обслуживания клиентов, сохраненный на шаге 1.

Выберите Сохранить.

Чтобы добавить пользователей Salesforce, выполните следующие действия:

1. В консоли Salesforce Service выберите Управление пользователями колл-центра>Добавить дополнительных пользователей.
2. Добавьте каждого пользователя Salesforce, которому требуется доступ к мини-приложению Copilot для обслуживания клиентов.

Чтобы добавить утилиту программного телефона, выполните следующие действия:

1. Выберите Настройка, а затем найдите и выберите Диспетчер приложений.
2. Найдите приложение Service Console, выберите перевернутый треугольник в той же строке, а затем выберите Редактировать.
3. Выберите Элементы служебной программы>Добавить элемент служебной программы.
4. Найдите и выберите Открыть программный телефон CTI.
5. Введите имя мини-приложения, например «Microsoft Copilot для обслуживания клиентов».
6. Установите для ширины значение 450, а для высоты — 600.
7. Выберите Сохранить.

Выполните следующие шаги, чтобы включить всплывающие окна:

1. В Salesforce перейдите в консоль службы со страницы Приложения.
2. Включите всплывающие окна, выбрав Всегда разрешать всплывающие окна и перенаправления с <URL>.
3. Нажмите кнопку Готово.
4. Обновите свой браузер. Надстройка Copilot для обслуживания клиентов теперь должна быть доступна на панели инструментов консоли вашего агента.

1. Откройте консоль Salesforce Service и выберите значок шестеренки.

2. Выберите Консоль разработчика из раскрывающегося списка. Если он не загружается, скопируйте URL-адрес из всплывающего окна и откройте его в новой вкладке.

3. В Консоли разработчика выберите Файл>Создать>Класс вершины. Укажите имя 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. Обновите {CFS_WIDGET_URL} на URL-адрес для виджета Copilot для обслуживания клиентов, который вы сохранили на предыдущем шаге.

1. Выберите Настройка, а затем найдите и выберите Диспетчер приложений.
2. Найдите и выберите приложение Консоль обслуживания. Выберите Изменить.
3. Выберите Элементы служебной программы>Добавить элемент служебной программы.
4. Найдите и выберите пользовательский компонент молнии в Пользовательский, CopilotForService в нашем примере.
5. Укажите имя для мини-приложения. Например, Microsoft Copilot для обслуживания.
6. Установите для ширины значение 450, а для высоты — 600.
7. Выберите Сохранить.

1. В Salesforce перейдите в консоль службы со страницы Приложения.
2. Включите всплывающие окна, выбрав Всегда разрешать всплывающие окна и перенаправления с <URL>.
3. Нажмите кнопку Готово.
4. Обновите свой браузер. Надстройка Copilot для обслуживания клиентов теперь должна быть доступна на панели инструментов консоли вашего агента.

1. Выполните поиск Доверенные URL-адреса в поле поиска в разделе Настройка, затем выберите Доверенные URL-адреса.
2. Выберите Новый доверенный URL-адрес, чтобы добавить новый доверенный URL-адрес.
   • Укажите CopilotforService в качестве имени API и URL-адрес в виде "*.azureedge.net"
3. Установите все флажки в разделе Директивы CSP, затем выберите Сохранить.