Plug-in CX Companion Salesforce

Instale e configure o Plug-in do Salesforce do UiPath CX Companion para integrar o CX Companion ao Salesforce usando eventos externos.

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. Selecione a listagem de aplicativos e, em seguida, selecione Obtenha agora.

4. Faça logon usando suas credenciais do Salesforce.

5. 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 "Reconhecimento que posso instalar um aplicativo que não seja da Salesforce que não está autorizado para distribuição como parte do Programa de Parceiro AppExchange da Salesforce". 4. Selecione Instalar. 5. Aprovar acesso de terceiros para https://*.uipath.com, o que permitirá o acesso confiável ao aplicativo CX Companion hospedado em uipath.com. 6. Após a instalação terminar, selecione 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. Selecione Avançar e, em seguida, selecione Atribuir.

2. Atribuir cache de plataforma Precisamos configurar o Cache de plataforma como uma memória reutilizável para esse aplicativo, a fim de armazenar 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 CxCompanionCache e selecione 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. Selecione Salvar.

   

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 selecione Editar.
   3. Selecione Contexto de CSP como Todos.
   4. Selecione as opções Connect-src e frame-src e selecione 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 , selecione Editar. 4. Cole a URL do aplicativo do seu CX Companion no campo URL do aplicativo . 5. Mencione a Origem do 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 campos a seguir definirão 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. Selecione Salvar,

   

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 Utilitários (Somente para Desktop) no painel esquerdo, selecione Adicionar Item 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.
   • Selecione Salvar.

   

4. Para Alinhamento da barra de utilitário, selecione o alinhamento desejado e, então, selecione 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, selecione 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. Selecione 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. Selecione Páginas de registro do Lightning no painel esquerdo.

11. Acesse qualquer página de registro do Salesforce e selecione Editar.

12. Selecione o painel de realce na página de registro e, no painel direito, selecione Adicionar ação para adicionar uma ação dinâmica.

13. Procure CX Companion e selecione Concluído.

14. Selecione 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 do 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. Selecione Inicializador de aplicativos, pesquise e selecione o aplicativo CX Companion Configuração.

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, selecione Recuperar metadados. Por exemplo, para adicionar o objeto Contato , 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. Selecione 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.