Configurar a experiência incorporada no Salesforce

Abra o console do Salesforce Service e selecione o ícone Configuração (engrenagem) no canto superior direito.

No campo de pesquisa, digite call center e, nos resultados da pesquisa, selecione Call Centers.

Se você estiver configurando esse widget pela primeira vez, poderá ver uma página com uma mensagem que diz: Diga Olá ao Call Center do Salesforce.

Selecione Continuar.

Abra um editor de texto e, em seguida, copie o seguinte código XML para ele e salve-o localmente como 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>

Selecione Importar>Escolher arquivo e, em seguida, navegue até o arquivo CopilotForServiceConfig.xml salvo na etapa 4 e selecione-o.

Selecione Importar.

Selecione Editar e, depois, no campo URL do adaptador CTI, cole a URL do widget de serviço que guardou no Passo 1.

Selecione Guardar.

Execute as seguintes etapas para adicionar usuários do Salesforce:

1. No console do Salesforce Service, selecione Gerenciar usuários> do call centerAdicionar mais usuários.
2. Adicione cada utilizador do Salesforce que pretende aceder ao Serviço no widget Microsoft 365 Copilot.

Siga os seguintes passos para adicionar o utilitário de softphone:

1. Selecione Configuração e, em seguida, procure e selecione Gestor de aplicações.
2. Localize a aplicação Service Console , selecione o triângulo invertido na mesma linha e, em seguida, selecione Editar.
3. Selecione Itens de Utilitário>Adicionar Item de Utilitário.
4. Procure e selecione Abrir CTI Softphone.
5. Escreva um nome para o seu widget, como "Serviço no Microsoft 365 Copilot."
6. Defina a largura para 450 e a altura para 600.
7. Selecione Guardar.

Execute as seguintes etapas para ativar pop-ups:

1. No Salesforce, vá para o console de serviço na página Aplicativos .
2. Ative pop-ups selecionando Sempre permitir pop-ups e redirecionamentos do endereço <url>.
3. Selecione Concluído.
4. Atualize o navegador. O serviço no complemento Microsoft 365 Copilot deverá agora estar disponível na barra de ferramentas da sua consola do agente.

1. Abra o console do Salesforce Service e selecione o ícone de engrenagem.

2. Selecione a Consola do Programador na lista pendente. Se não carregar, copie o URL da janela pop-up e abra-o num novo separador.

3. No Developer Console, selecione Ficheiro>Novo>Classe Apex. Especifique o nome como ObjectService e selecione Criar e, em seguida, cole o seguinte código no editor:

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

4. Execute os seguintes cinco passos para criar um componente relâmpago:

   1. Selecione Arquivo>Novo>Componente Lightning.
   2. Especifique um nome para o componente. Por exemplo, CopilotForService.
   3. Selecione Controlador no painel de pacote que é exibido quando o componente é criado e, em seguida, cole o seguinte código:

   ({
     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. Selecione Guardar.
   2. Selecione componente e, em seguida, copie o seguinte código:

   <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. Atualize {CFS_WIDGET_URL} para a URL do Serviço no Microsoft Copilot widget URL que guardou no passo anterior.

1. Selecione Configuração e, em seguida, procure e selecione Gestor de aplicações.
2. Procure e selecione o aplicativo Console de Serviço . Selecione Editar.
3. Selecione Itens de Utilitário>Adicionar Item de Utilitário.
4. Procure e selecione o componente de clareamento personalizado em Custom, CopilotForService em nosso exemplo.
5. Especifique um nome para o widget. Por exemplo, Serviço no Microsoft 365 Copilot.
6. Defina a largura para 450 e a altura para 600.
7. Selecione Guardar.

1. No Salesforce, vá para o console de serviço na página Aplicativos .
2. Ative pop-ups selecionando Sempre permitir pop-ups e redirecionamentos do endereço <url>.
3. Selecione Concluído.
4. Atualize o navegador. O serviço no complemento Microsoft 365 Copilot deverá agora estar disponível na barra de ferramentas da sua consola do agente.

1. Procure URLs confiáveis na caixa de pesquisa em Configuração e selecione URLs confiáveis.
2. Selecione Novo URL confiável para adicionar um novo URL confiável.
   • Especifique CopilotforService como o nome da API e URL como "*.azureedge.net"
3. Marque todas as caixas de seleção em Diretivas CSP e selecione Salvar.