Configuración de Salesforce para el conector de Agentforce y flujos

Esta guía describe la configuración esencial de Salesforce necesaria para utilizar el conector de Integration Service Salesforce Agentforce & Flows.

Requisitos previos

Antes de comenzar, asegúrate de lo siguiente:

• Tiene acceso al perfil de administrador del sistema con la API habilitada.

• Tu edición de Salesforce es Enterprise, Unlimited o Developer Edition.

Puedes utilizar tu organización de Salesforce actual o configurar una nueva edición de Agentforce Developer siguiendo las instrucciones de instalación en la página de herramientas de desarrollador de Salesforce Agentforce .

Instalar y configurar el paquete gestionado Agentes de flujo de Salesforce

Nota: Este paso es necesario para la integración con Salesforce Flows. Para la integración con Salesforce Agentforce, omite este paso por completo y procede directamente a Configurar una aplicación conectada en Salesforce.

Acceder e instalar la lista de AppExchange

Sigue estos pasos para instalar el paquete gestionado UiPath-SF-Flow-Agents-Integration:

1. En un navegador web, accede a la siguiente página web: Salesforce AppExchange.
   Importante: Para la versión de vista previa actual del conector Salesforce Agentforce & Flows, utiliza la siguiente URL para acceder al paquete: https://<yourSalesforceDomain>.lightning.force.com/packaging/installPackage.apexp?p0=04tPa000000bkIPIAY, reemplazando <yourSalesforceDomain> con el dominio de tu organización.
2. En la barra de búsqueda, escribe: UiPath-SF-Flow-Agents-Integration.
3. Selecciona la lista de aplicaciones y, a continuación, selecciona Obtenerla ahora.
4. Inicia sesión con tus credenciales de Salesforce para continuar con la instalación.
5. Elija su entorno de instalación:
   1. Producción: para entornos activos de Salesforce.
   2. Sandbox: para pruebas antes del uso en producción.

      Nota: mientras el conector de UiPath está en vista previa, la selección de entorno no está disponible.

6. Selecciona Instalar solo para administradores.

   Esta selección otorga acceso al paquete solo a los administradores del sistema. Como alternativa, puedes optar por hacer que el paquete gestionado esté disponible para un usuario específico con los permisos adecuados.

7. Marca la casilla que reconoce la instalación de una aplicación que no es de Salesforce.
8. Selecciona Instalar.
9. Después de una instalación correcta, selecciona Listo.
10. Verifica la instalación consultando la lista de paquetes instalados para "UiPath-SF-flow-agents-integration".
    Figura 1. La ventana Paquetes instalados en Salesforce
    

    

    
    

Asignar conjuntos de permisos

Para conceder los permisos necesarios a los usuarios con acceso al paquete gestionado:

1. Ve a Configuración > Usuarios > Conjunto de permisos.
2. Localiza Administrador predeterminado de Agentforce.
3. Selecciona Gestionar asignaciones.
4. Selecciona Añadir asignaciones.
5. Selecciona los usuarios necesarios.
6. Selecciona Siguiente y, a continuación, Asignar.

Configurar una aplicación conectada en Salesforce

Crear una aplicación conectada

1. Abre App Manager, selecciona el icono de engranaje en la esquina superior derecha de la ventana y selecciona Configuración.
2. En el cuadro Búsqueda rápida situado en la barra lateral izquierda, escribe y selecciona App Manager.

   Se muestra la lista de aplicaciones ya disponibles en tu organización de Salesforce.

3. Selecciona el botón Nueva aplicación conectada en la esquina superior derecha de la ventana.
   Figura 2. Crear una nueva aplicación conectada
   

   

   
   
4. Selecciona Crear una aplicación conectada y luego Continuar.
   Figura 3. La ventana Crear una aplicación conectada
   

   

   
   
5. Rellena la sección Información básica para la nueva aplicación conectada:
   1. Proporcione un nombre. Por ejemplo, UiPath Salesforce Agentforce Flows Connector.
   2. Nombre de la API: este campo se rellena automáticamente en función del nombre de la aplicación proporcionado.
   3. Proporcione un correo electrónico de contacto: introduzca su correo electrónico para cualquier comunicación de soporte.
6. Para habilitar la configuración de OAuth para la nueva aplicación, desplázate hasta la sección API (Habilitar configuración de OAuth) .
   1. Selecciona la casilla de verificación Habilitar configuración de OAuth .
   2. Especifique la URL de devolución de llamada proporcionando la URL de devolución de llamada del conector: https://cloud.uipath.com/provisioning_/callback.
   3. Añade los ámbitos OAuth necesarios:
      • Para flujos de Salesforce:
        • Acceso completo (full)
        • Realizar solicitudes en cualquier momento (refresh_token, offline_access)
      • Para Salesforce Agentforce:
        • Acceder a los servicios de chatbot (chatbot_api)
        • Acceder a la plataforma API de Salesforce (sfap_api)
        • Acceso completo (full)
        • Gestionar datos de usuario a través de API (api)
        • Realizar solicitudes en cualquier momento (refresh_token, offline_access)
7. Gestiona la configuración de seguridad de la aplicación conectada:
   1. Habilita las siguientes casillas de verificación:
      1. Flujo de credenciales de cliente: una vez habilitado, selecciona Aceptar en la siguiente ventana emergente para confirmar que cualquier persona con la clave de consumidor y el secreto de consumidor puede acceder a tu organización en nombre del usuario seleccionado.
      2. Emitir tokens de acceso basados en JSON Web Token (JWT) para usuarios designados : si pretendes utilizar el código de autorización OAuth 2.0 para la autenticación con el conector de Integration Service, no habilites esta casilla de verificación.
   2. Deshabilita las siguientes casillas de verificación:
      1. Requerir extensión de clave de prueba para intercambio de código (PKCE) para flujos de autorización compatibles
      2. Requerir secreto para el flujo del servidor web
      3. Requerir secreto para el flujo de token de actualización
         Figura 4. Configuración de la API de la aplicación conectada
         

         

         
         
8. Selecciona Guardar para guardar la aplicación. Se muestra el siguiente mensaje: "Los cambios pueden tardar hasta 10 minutos en surtir efecto. Al eliminar una organización principal también se eliminan todas las aplicaciones conectadas con la configuración de OAuth habilitada".

Recuperar el ID de cliente y el secreto de cliente

1. Vuelve a App Manager.
2. Busca tu aplicación (UiPath Salesforce Agentforce Flows Connector), selecciona la flecha desplegable a la derecha y selecciona Ver.
   Figura 5. Ver los detalles de la aplicación
   

   

   
   
3. Selecciona Gestionar detalles del consumidor.
4. Si se te solicita, completa los pasos de verificación de seguridad. Salesforce puede solicitar un código de verificación enviado a su dirección de correo electrónico registrada. Introduzca el código cuando se le solicite continuar.
5. Se muestran las siguientes credenciales:
   • Clave de consumidor : representa el ID de cliente.
   • Secreto de consumidor : representa el secreto de cliente.
   Importante: Copia y almacena de forma segura ambos valores. Estas credenciales son necesarias para configurar el conector de Integration Service.

Configurar la aplicación conectada para JWT y el flujo de credenciales de cliente

1. Ve a Configuración > Gestionar aplicaciones conectadas.
2. Busca y selecciona tu aplicación conectada (UiPath Salesforce Agentforce Flows Connector).
3. Selecciona Editar políticas:
   1. En Flujo de credenciales de cliente, configura el campo Ejecutar como usuario. El conector suplanta a este usuario para invocar las API para flujos y agentes.
      Nota: Esta es la cuenta de servicio para el conector. Asegúrate de elegir un usuario que tenga los permisos necesarios (acceso solo a API o API habilitada).
   2. En Configuración de token de acceso basado en JWT para usuarios designados:
      • Activa la casilla Emitir tokens de acceso basados en JSON Web Token (JWT) .
      • Establece el Tiempo de espera del token en un valor de 30 minutos.
        Figura 6. Configuración del token de acceso basado en JWT para usuarios designados
        

        

        
        
4. Selecciona Guardar.

Habilitar el acceso del conector de UiPath a sus agentes de Agentforce personalizados

Nota: este paso no es necesario para el agente AgentForce (predeterminado).

Para cada agente personalizado, sigue estos pasos:

1. Ve a Configuración y busca "agente".
2. Selecciona Agentes de Agentforce.
3. En la sección Dar acceso a los usuarios al agente de Agentforce (predeterminado) , selecciona el nombre de tu agente personalizado (por ejemplo, Mi agente de servicio de Agentforce).
   Figura 7. Dar acceso a los usuarios al agente de Agentforce
   

   

   
   
4. Selecciona la pestaña Conexiones y, a continuación, selecciona Añadir.
   Figura 8. Configurar conexiones para tu agente de Agentforce personalizado
   

   

   
   
5. En la ventana Añadir conexión :
   1. Establece el campo Conexión en API.
   2. Proporcione un nombre de integración, como UiPath Connector.
   3. En Aplicación conectada, selecciona la aplicación conectada que creaste previamente (UiPath Salesforce AgentForce Flows Connector).
      Figura 9. Conector de flujos de UiPath Salesforce AgentForce
      

      

      
      
   4. Guarda la conexión.

Configurar los ajustes del sitio remoto

1. Desde App Manager, selecciona el icono de engranaje en la esquina superior derecha de la ventana y selecciona Configuración.
2. En el cuadro Búsqueda rápida situado en la barra lateral izquierda, introduce Configuración del sitio remoto.
3. En Seguridad, selecciona Configuración del sitio remoto.
4. Selecciona Nuevo sitio remoto para crear un nuevo sitio.
5. Configura el nuevo sitio proporcionando la siguiente información:
   • Nombre del sitio remoto: introduce una cadena alfanumérica, sin espacios, como UiPathRemoteSite.
   • URL del sitio remoto: introduce la URL base, por ejemplo: https://cloud.uipath.com.
   • Descripción: introduce una descripción, por ejemplo: "URL base de integración de UiPath para invocación de flujo". Este campo es opcional.
   • Activo: asegúrate de que la casilla de verificación esté seleccionada.
6. Selecciona Guardar para confirmar y activar esta configuración.

Su conector de UiPath ahora puede acceder a su agente de Salesforce personalizado. Asegúrate de que el agente que quieres invocar esté activado.

A continuación, configura el conector Salesforce AgentForce & Flows en Integration Service. Ve a Autenticación de Salesforce Agentforce y flujos para crear una conexión.

Problemas comunes y solución de problemas

La siguiente sección enumera los problemas comunes que puedes encontrar al configurar el paquete gestionado Agentes de flujo de Salesforce o una aplicación conectada, y cómo solucionarlos.

Problema: la instalación del paquete gestionado falla debido a la falta de dependencias

1. Asegúrese de que todas las características de Salesforce necesarias (como el acceso a la API y la IA de Einstein) estén habilitadas.
2. Comprueba las dependencias de los paquetes en los registros de instalación.

Problema: los usuarios no pueden acceder a ciertas características

• Comprueba que se han asignado los perfiles y conjuntos de permisos correctos al usuario de la cuenta de servicio y a los usuarios finales del agente.
• Asegúrate de haber activado el agente.

Problema: el sistema externo no se puede conectar a Salesforce

• Comprueba la configuración de la API y asegúrate de que la autenticación OAuth esté configurada para la aplicación conectada.

Supervisar y verificar el estado de ejecución de los flujos iniciados automáticamente desencadenados a través de UiPath Connector

Sigue estos pasos para acceder al objeto de registro de ejecución de flujo personalizado en Salesforce:

1. Ve al Iniciador de aplicación (el icono de cuadrícula en la esquina superior izquierda).
2. Busca Ejecución de flujo en la barra de búsqueda.
3. Selecciona la pestaña Ejecución de flujo o el nombre del objeto que aparece en los resultados de la búsqueda. Esta acción abre la vista de lista de registros de ejecución de flujo. Se crea un nuevo registro para cada flujo que se desencadena a través de UiPath Connector.
   Figura 10. Registros de ejecución de flujo
   

   

   
   
4. Selecciona un nombre de ejecución de flujo en particular para ver los detalles de esa ejecución.
   Figura 11. Detalles de ejecución de flujo