Plug-in CX Companion Salesforce

O plug-in SF do UiPath CX Companion permite a integração pré-configurada do CX Companion com o Salesforce ao usar eventos externos. Leia as seções a seguir para saber como instalar e configurar o plug-in.

Pré-requisitos

Antes de começar, certifique-se de que:

• Você tem acesso ao perfil de Administrador do Sistema .
  Observação: você pode usar sua organização do Salesforce atual ou testar em uma organização de desenvolvimento.

• Sua edição do Salesforce é Enterprise, Ilimitada ou Desenvolvedor.

Instalando o pacote gerenciado

1. Acesse a listagem do AppExchange.

   Siga estas etapas para instalar o pacote gerenciado UiPath-CX-Companion-SF-Plugin :

   1. Abra um navegador da web e acesse o Salesforce AgentExchange.
   2. Na barra de pesquisa, digite: Plug-in do UiPath CX Companion SF.
   3. Clique na listagem de aplicativos e selecione Obter agora.
   4. Faça logon usando suas credenciais do Salesforce.
   Importante:

   O Plug-in SF do CX Companion está atualmente em visualização, aguardando aprovação do Salesforce. Você pode obter a versão de visualização de uma das seguintes maneiras:

   • Baixe usando o URL do pacote gerenciado: https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPa000002FWpeIAG
   • Fazer download de https://<yourSalesforceDomain>.lightning.force.com/packaging/installPackage.apexp?p0 p0=04tPa000002FWpeIAG
     onde <yourSalesforceDomain> é o domínio real da sua organização do Salesforce.
2. Escolha onde instalar e para quem.
   1. Selecione em qual ambiente você deseja instalar:
      • Produção - Escolha isso se você estiver pronto para usar o aplicativo em seu ambiente do Salesforce ao vivo.
      • Área restrita - Escolha essa opção se você quiser testar o aplicativo antes de usá-lo em Produção.

      Observação:

      Essa etapa não estará disponível se você estiver usando a versão de visualização do plug-in.

   2. Selecione Instalar para usuários específicos.
      Você pode optar por disponibilizar esse pacote gerenciado para alguns ou todos os usuários.
   3. Selecione "Reconheço que estou instalando um aplicativo que não é da Salesforce e que não está autorizado para distribuição como parte do Programa de Parceiros AppExchange da Salesforce.".
   4. Clique em Instalar.
   5. Aprovar o acesso de terceiros para https://*.uipath.com, que habilitará o acesso confiável ao aplicativo CX Companion hospedado em uipath.com.
   6. Após a conclusão da instalação, clique em Concluído.

      Após a instalação, o pacote gerenciado recém-instalado UiPath CX Companion SF Plug-in é exibido na lista Pacotes instalados.

      

Atribuição de permissões e cache da plataforma

1. Atribuir Conjuntos de Permissões
   Siga estas etapas para garantir que as permissões necessárias estejam disponíveis para os usuários para os quais você instalou o pacote gerenciado.
   1. Navegue até Configuração > Usuários > Conjunto de permissões e localize o UiPath CX Companion.
   2. Selecione Gerenciar atribuições > Adicionar atribuições.
   3. Selecione os usuários necessários.
   4. Clique em Avançar e depois em Atribuir.
2. Atribuir Cache de Plataforma
   Precisamos configurar o Cache da plataforma como memória reutilizável para que esse aplicativo armazene os dados do ID de registro do Salesforce ativo. Certifique-se de que o Cache da plataforma esteja alocado da seguinte forma:
   1. Navegue até Configuração > Cache da plataforma.
   2. Localize o CxCompanionCache e clique em Editar.
   3. Especifique a seguinte capacidade (MB)
      • Alocação de cache de sessão - Organização ou Avaliação (o que estiver disponível): 2
      • Alocação de cache de organização - Organização ou Avaliação (o que estiver disponível): 1

      Observação: para a Salesforce Developer Edition (DE), se a capacidade de Avaliação não estiver disponível, você pode solicitar a mesma clicando em Solicitar capacidade de avaliação.
   4. Clique em Salvar e
      

Como conectar o aplicativo CX Companion ao plug-in

1. Identifique a URL onde o CX Companion está hospedado. Para obter informações sobre como obter a URL do aplicativo, consulte Configuração do aplicativo CX Companion > Incorporação do aplicativo.
2. Configure uma URL confiável.

   Para permitir que o iframe do CX Companion seja renderizado dentro do Lightning Web Component (LWC), a instância do Salesforce deve ser configurada para confiar no site onde o CX Companion está hospedado.

   1. Navegue até Configuração > URLs confiáveis.
   2. Encontre CXCompanion_Iframe na lista e clique em Editar.
   3. Selecione Contexto de CSP como Todos.
   4. Selecione as opções Connect-src e frame-src e clique em Salvar
3. Modificar tipos de metadados personalizados.

   O LWC requer que os metadados personalizados sejam configurados para o CX Companion para fornecer conteúdo ao aplicativo iframe do CX Companion.

   1. Navegue até Configuração > Tipos de metadados personalizados.
   2. Para a configuração do CX Companion, selecione Gerenciar registros. Este rótulo é criado automaticamente quando você instala o pacote gerenciado.
      
   3. Para o Rótulo padrão , clique em Editar.
   4. Cole o URL do aplicativo do seu CX Companion no campo URL do aplicativo .
   5. Mencione a origem de destino como o nome do host do URL do seu CX Companion, por exemplo https://cloud.uipath.com.
   6. Se o CX Companion for iniciado a partir de um botão de ação em uma página de registro SF, os seguintes campos definem as dimensões da janela invocada. Elas podem ser alteradas conforme necessário. Os valores padrão são:
      • Largura do componente de ação de registro: 1200
      • Altura do componente de ação do registro: 800

      Observação: essas dimensões e o título serão aplicáveis apenas quando o CX Companion estiver configurado como um botão de ação na Página de registro do objeto.
   7. Clique em Salvar e
      

Posicionamento do CX Companion

Há duas opções para posicionar o botão de inicialização do CX Companion na interface gráfica do Salesforce:

• Como um item da Barra de Utilitários que é visível em todos os objetos.
• Como um botão de ação na página de registro do objeto.

Posição como item da barra de ferramentas

Siga estas etapas para cada aplicativo em que você deseja habilitar o CX Companion (por exemplo Console de vendas). Isso garantirá que o CX Companion fique visível na bandeja do utilitário quando o usuário estiver nesse aplicativo.

Nas instruções a seguir, o CX Companion é adicionado como um item da Barra de Utilitários no Console de Serviços.

1. Navegue até Configuração > Gerenciador de aplicativos.
2. Selecione Editar para o Console de Serviço.
3. Em Itens de utilitário (Apenas para desktop) no painel esquerdo, clique em Adicionar item de utilitário.
   • Procure o Componente da Web do Lightning cxCompanion no pop-up e selecione-o.
   • Insira o Rótulo que aparecerá na Barra de Utilitários (por exemplo CX Companion) e selecione um ícone apropriado.
   • Especifique a Largura do painel (recomendado 1000px ) e a Altura do painel (recomendado 520px ).
   • Selecione Habilitar botão de atualização que aparece dentro do LWC e permite que o CX Companion seja atualizado com dados do objeto SF ativo.

   • Clique em Salvar.

     
4. Para Alinhamento da barra de ferramentas, selecione o alinhamento desejado e clique em Salvar.
   • Se você selecionar Padrão, a barra de ferramentas aparece no canto inferior esquerdo da tela.
   • Se você selecionar Espelhamento, a barra de ferramentas aparecerá no lado inferior direito da tela.

Posicionar como um botão de ação na Página de Registro do objeto

Siga estas etapas para cada objeto no qual você deseja criar o novo botão de ação para a página Registro de objeto. As instruções abaixo orientarão você a adicionar o CX Companion como um botão de ação na página Registro de caso.

1. Navegue até Configuração > Gerenciador de Objetos para criar uma nova ação para um objeto.
2. Pesquise um objeto para o qual você deseja adicionar uma ação rápida (por exemplo case) e abra-o.
3. Selecione Botões, Links e Ações no painel esquerdo e, em seguida, clique em Nova ação.
4. Para Tipo de ação, selecione Componente da web do Lightning.
5. Para Componente da Web do Lightning, selecione uipathsf:cxCompanionRecordAction.
6. Na caixa Rótulo , digite o rótulo que aparecerá no botão (por exemplo CX Companion) e selecione um ícone apropriado. O campo Nome será preenchido automaticamente.

7. Clique em Salvar.

   
8. Navegue até Configuração > Gerenciador de Objetos para adicionar esta ação a uma página de registro de raio.
9. Pesquise um objeto para o qual você deseja adicionar uma ação rápida (por exemplo case) e abra-o.
10. Clique em Páginas de registro do Lightning no painel à esquerda.
11. Vá para qualquer página de registro do Salesforce e clique em Editar.
12. Selecione o painel de realce na página de registro e, no painel direito, clique em Adicionar ação para adicionar uma ação dinâmica.
13. Procure por CX Companion e clique em Concluído.

14. Clique em Salvar.

    
15. Foi adicionado um botão à página de registro de caso que inicia o CX Companion em uma nova janela pop-up.
    Observação: as dimensões e o título da janela CX Companion serão determinados pelo que foi especificado na etapa anterior Modificar tipos de metadados personalizados.

Passando campos de objeto SF para CX Companion

Siga estas etapas para configurar os campos de objeto do aplicativo de configuração do CX Companion.

1. Clique em Inicializador de aplicativos, pesquise e selecione o aplicativo CX Companion Setup.
2. Selecione a guia Configuração de objetos do CX Companion .
3. No menu suspenso Objeto , selecione qualquer objeto que você habilitou anteriormente com o CX Companion (por exemplo Objeto da conta).
   Se o objeto que você deseja adicionar não estiver disponível na lista suspensa Objetos:
   1. Selecione a opção Outro.
   2. Especifique o ID de registro do Salesforce (15 ou 18 dígitos) do objeto na caixa de texto e, em seguida, clique em Recuperar metadados. Por exemplo, para adicionar o objeto Contact , insira o ID de registro SF de qualquer contato válido, por exemplo 003Ox00000eUIKSIA4 na caixa de texto.
   3. Os campos para o objeto agora são exibidos. Continue na etapa 4.
4. Na seção Campos , selecione os campos que devem ser enviados para o CX Companion. Certifique-se de que os usuários finais tenham permissões de acesso aos campos selecionados.
   
5. Selecione até dois campos na seção Cabeçalho que serão exibidos como o cabeçalho do CX Companion.
6. Clique em Salvar para salvar a configuração. Pode levar algum tempo para que os valores sejam salvos e para que as alterações sejam refletidas no CX Companion.