Configuração da Salesforce para o conector do Agentforce e do Flows

Este guia descreve a configuração essencial do Salesforce necessária para usar o conector do Integration Service Salesforce Agentforce e Fluxos.

Pré-requisitos

Antes de começar, certifique-se do seguinte:

• Você tem um perfil de Administrador do Sistema de acesso com API habilitada.

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

Você pode usar sua organização do Salesforce atual ou configurar uma nova Agentforce Developer Edition seguindo as instruções de instalação na página ferramentas do Salesforce Agentforce para desenvolvedores .

Instalação e configuração do pacote gerenciado Agentes de fluxo do Salesforce

Observação: essa etapa é necessária para a integração com os Fluxos do Salesforce. Para integração com o Salesforce Agentforce, pule essa etapa completamente e prossiga diretamente para Configuração de um aplicativo conectado no Salesforce.

Acesso e instalação da listagem do AppExchange

Siga estas etapas para instalar o pacote gerenciado UiPath-SF-Flow-Agents-Integration:

1. Em um navegador web, acesse a seguinte página web: Salesforce AppExchange.
   Importante: para a versão de visualização atual do Salesforce Agentforce e conector de fluxos, use o seguinte URL para acessar o pacote: https://<yourSalesforceDomain>.lightning.force.com/packaging/installPackage.apexp?p0=04tPa000000bkIPIAY, substituindo <yourSalesforceDomain> pelo domínio de sua organização.
2. Na barra de pesquisa, digite: UiPath-SF-Flow-Agents-Integration.
3. Selecione a listagem de aplicativos e, em seguida, selecione Obtenha agora.
4. Faça login usando suas credenciais do Salesforce para continuar a instalação.
5. Escolha seu ambiente de instalação:
   1. Produção: para ambientes ao vivo do Salesforce.
   2. Sandbox: para testes antes do uso em produção.

      Observação: enquanto o conector da UiPath estiver em visualização, a seleção de ambiente não estará disponível.

6. Selecione Instalar somente para administradores.

   Essa seleção concede acesso ao pacote apenas para administradores de sistema. Como alternativa, você pode optar por disponibilizar o pacote gerenciado para um usuário específico com as permissões apropriadas.

7. Marque a caixa reconhecendo a instalação de um aplicativo que não seja da Salesforce.
8. Selecione Instalar.
9. Após uma instalação bem-sucedida, selecione Concluído.
10. Verifique a instalação verificando a lista de Pacotes instalados para "UiPath-SF-flow-agents-integration".
    Figura 1. A janela Pacotes instalados no Salesforce
    

    

    
    

Atribuição de conjuntos de permissões

Para conceder as permissões necessárias aos usuários com acesso ao pacote gerenciado:

1. Navegue até Configuração > Usuários > Conjunto de permissões.
2. Localize o Administrador Padrão do Agentforce.
3. Selecione Gerenciar atribuições.
4. Selecione Adicionar atribuições.
5. Selecione os usuários necessários.
6. Selecione Avançar e então Atribuir.

Configurando um aplicativo conectado no Salesforce

Criação de um aplicativo conectado

1. Abra o App Manager, selecione o ícone de engrenagem no canto superior direito da janela e selecione Configuração.
2. Na caixa Localização rápida localizada na barra lateral esquerda, digite e selecione Gerenciador de aplicativos.

   A lista de aplicativos já disponíveis em sua organização do Salesforce será exibida.

3. Selecione o botão Novo aplicativo conectado no canto superior direito da janela.
   Figura 2. Criação de um novo aplicativo conectado
   

   

   
   
4. Selecione Criar um Aplicativo Conectado e Continuar.
   Figura 3. A janela Criar um Aplicativo Conectado
   

   

   
   
5. Preencha a seção Informações Básicas para o novo aplicativo conectado:
   1. Forneça um nome. Por exemplo, UiPath Salesforce Agentforce Flows Connector.
   2. Nome da API: esse campo é preenchido automaticamente com base no nome do aplicativo fornecido.
   3. Forneça um e-mail de contato: insira seu e-mail para qualquer comunicação de suporte.
6. Para habilitar as configurações do OAuth para o novo aplicativo, role até a seção API (Habilitar configurações do OAuth) .
   1. Marque a caixa de seleção Habilitar configurações do OAuth .
   2. Especifique a URL de retorno de chamada fornecendo a URL de retorno de chamada do conector: https://cloud.uipath.com/provisioning_/callback.
   3. Adicione os Escopos OAuth necessários:
      • Para Fluxos do Salesforce:
        • Acesso total (full)
        • Realizar solicitações a qualquer momento (refresh_token, offline_access)
      • Para Salesforce Agentforce:
        • Acessar serviços do chatbot (chatbot_api)
        • Acesse a Plataforma da API da Salesforce (sfap_api)
        • Acesso total (full)
        • Gerenciar dados de usuários por meio de APIs (api)
        • Realizar solicitações a qualquer momento (refresh_token, offline_access)
7. Gerencie as configurações de segurança do aplicativo conectado:
   1. Habilite as seguintes caixas de seleção:
      1. Fluxo de credenciais do cliente: uma vez habilitado, selecione OK na janela pop-up a seguir para confirmar que qualquer pessoa com a chave do consumidor e o segredo do consumidor pode acessar sua organização em nome do usuário selecionado.
      2. Emitir tokens de acesso baseados no JSON Web Token (JWT) para usuários nomeados – Se você pretende usar o Código de Autorização OAuth 2.0 para autenticação com o conector do Integration Service, não habilite essa caixa de seleção.
   2. Desabilite as seguintes caixas de seleção:
      1. Exigir a extensão Proof Key for Code Exchange (PKCE) para fluxos de autorização compatíveis
      2. Exigir segredo para fluxo do servidor web
      3. Exigir senha para atualizar o fluxo do token
         Figura 4. Configurações de API do aplicativo conectado
         

         

         
         
8. Selecione Salvar para salvar o aplicativo. A seguinte mensagem é exibida: "As alterações podem levar até 10 minutos para entrar em vigor. Excluir uma organização pai também exclui todos os aplicativos conectados com as configurações do OAuth habilitadas."

Recuperação do ID e do segredo do cliente

1. Volte para o App Manager.
2. Encontre seu aplicativo (UiPath Salesforce Agentforce Flows Connector), selecione a seta suspensa à direita e selecione Exibir.
   Figura 5. Visualização dos detalhes do aplicativo
   

   

   
   
3. Selecione Gerenciar detalhes do consumidor.
4. Se solicitado, conclua as etapas de verificação de segurança. A Salesforce pode solicitar um código de verificação enviado para seu endereço de email registrado. Insira o código quando for solicitado para prosseguir.
5. As seguintes credenciais são exibidas:
   • Chave do Consumidor - Representa a ID do Cliente.
   • Segredo do Consumidor - Representa o Segredo do Cliente.
   Importante: copie e armazene com segurança ambos os valores. Essas credenciais são necessárias para configurar o conector do Integration Service.

Configuração do aplicativo conectado para o fluxo de credenciais do JWT e do cliente

1. Vá para Configuração > Gerenciar aplicativos conectados.
2. Encontre e selecione seu aplicativo conectado (UiPath Salesforce Agentforce Flows Connector).
3. Selecione Editar políticas:
   1. Em Fluxo de credenciais do cliente, configure o campo Executar como usuário. O conector representa esse usuário para invocar as APIs para Fluxos e Agentes.
      Observação: essa é a conta de serviço para o conector. Certifique-se de escolher um usuário que tenha as permissões necessárias (acesso apenas à API ou API habilitada).
   2. Em Configurações de token de acesso baseado em JWT para Named Users:
      • Habilite a caixa de seleção Emitir tokens de acesso baseados no JSON Web Token (JWT) .
      • Defina o Tempo limite do token para um valor de 30 minutos.
        Figura 6. Configurações de token de acesso baseadas em JWT para usuários nomeados
        

        

        
        
4. Selecione Salvar.

Habilitando o acesso do conector da UiPath a seus agentes personalizados do Agentforce

Observação: essa etapa não é necessária para o agente AgentForce (padrão).

Para cada agente personalizado, siga estas etapas:

1. Acesse Configuração e pesquise "agente".
2. Selecione Agentes do Agentforce.
3. Na seção Dar acesso aos usuários ao agente do Agentforce (padrão) , selecione o nome do seu agente personalizado (por exemplo, Meu agente de serviço do Agentforce).
   Figura 7. Dando acesso de usuários ao agente Agentforce
   

   

   
   
4. Selecione a guia Conexões e, em seguida, selecione Adicionar.
   Figura 8. Configuração de conexões para seu agente Agentforce personalizado
   

   

   
   
5. Na janela Adicionar conexão :
   1. Defina o campo Conexão como API.
   2. Forneça um nome da integração, como UiPath Connector.
   3. Em aplicativo conectado, selecione o aplicativo conectado que você criou anteriormente (Conector de fluxos do UiPath Salesforce AgentForce).
      Figura 9. Conector de fluxos do UiPath Salesforce AgentForce
      

      

      
      
   4. Salve a conexão.

Definição de configurações de site remoto

1. No App Manager, selecione o ícone de engrenagem no canto superior direito da janela e selecione Configuração.
2. Na caixa Localização rápida localizada na barra lateral esquerda, insira Configurações de site remoto.
3. Em Segurança, selecione Configurações de site remoto.
4. Selecione Novo site remoto para criar um novo site.
5. Configure o novo site fornecendo as seguintes informações:
   • Nome do site remoto: insira uma string alfanumérica, sem espaços, como UiPathRemoteSite.
   • URL do site remoto: insira a URL base, por exemplo: https://cloud.uipath.com.
   • Descrição: insira uma descrição, como por exemplo: "URL base de integração da UiPath para invocação de fluxo". Este campo é opcional.
   • Ativo: certifique-se de que a caixa de seleção esteja marcada.
6. Selecione Salvar para confirmar e ativar essas configurações.

Seu conector da UiPath agora pode acessar seu agente Salesforce personalizado. Certifique-se de que o agente que você deseja invocar esteja ativado.

Em seguida, configure o conector Salesforce AgentForce e Flows no Integration Service. Acesse Salesforce Agentforce e Autenticação de fluxos para criar uma conexão.

Problemas comuns e solução de problemas

A seção a seguir lista problemas comuns que você pode encontrar ao configurar o pacote gerenciado Agentes do Salesforce Flow ou um aplicativo conectado e como corrigi-los.

Problema: falha na instalação do pacote gerenciado devido a dependências ausentes

1. Certifique-se de que todas as funcionalidades do Salesforce necessárias (como o acesso à API e a IA do Ein usuário) estejam habilitadas.
2. Verifique as dependências do pacote nos logs de instalação.

Problema: os usuários não podem acessar certas funcionalidades

• Verifique se os perfis e conjuntos de permissões corretos foram atribuídos ao usuário da conta de serviço e aos usuários finais do agente.
• Certifique-se de que você ativou o agente.

Problema: o sistema externo falha ao se conectar ao Salesforce

• Verifique as configurações de API e se certifique de que a autenticação OAuth esteja configurada para o aplicativo conectado.

Monitoramento e verificação do status de execução de fluxos iniciados automaticamente acionados por meio do UiPath Connector

Siga estas etapas para acessar o objeto de log de execução de fluxo personalizado no Salesforce:

1. Navegue até o Inicializador de aplicativos (o ícone de grade no canto superior esquerdo).
2. Procure por Flow Execution na barra de pesquisa.
3. Selecione a guia Execução de fluxo ou o nome do objeto que aparece nos resultados da pesquisa. Essa ação abre a exibição de lista dos registros de execução de fluxo. Um novo registro é criado para cada fluxo que é acionado por meio do UiPath Connector.
   Figura 10. Registros de execução de fluxo
   

   

   
   
4. Selecione um nome de Execução de fluxo específico para visualizar os detalhes dessa execução.
   Figura 11. Detalhes da execução do fluxo