Autenticación de Salesforce

Conecta UiPath a Salesforce utilizando OAuth 2.0, token de acceso personal o autenticación de contraseña OAuth 2.0 en Automation Suite.

Ediciones compatibles

Para autenticarte en Salesforce, debes tener una edición que incluya compatibilidad con API. El conector de Salesforce funciona con la siguiente edición (sin limitarse a):

• Salesforce Sales Cloud (Enterprise o Professional con soporte de API)

Para todas las demás ediciones no enumeradas, ponte en contacto con tu representante de UiPath para obtener ayuda.

Nota:

El conector utiliza la API REST de Salesforce. Confirma que tu edición de Salesforce incluye acceso a la API antes de continuar.

Requisitos previos

Para crear una conexión, necesita las siguientes credenciales:

• Traiga su propia aplicación OAuth 2.0: ID de cliente, Secreto de cliente.
• Token de acceso personal (PAT): clave API OAuth, secreto de API OAuth, clave codificada JWT en base64, audiencia, emisor, asunto.
• Contraseña OAuth 2.0: nombre de usuario, contraseña, token de seguridad.

Además, es posible que necesites una aplicación de autenticación instalada en tu teléfono móvil si tu organización de Salesforce aplica la autenticación multifactor (MFA).

Antes de crear una conexión, asegúrate también de lo siguiente:

1. Tienes una edición Enterprise de Salesforce Sales Cloud, una edición Professional con soporte de API u otra edición compatible mencionada anteriormente.
2. Tienes privilegios de administrador en Salesforce Sales Cloud para configurar aplicaciones. Póngase en contacto con el administrador del sistema si no tiene estos privilegios.
3. El permiso API habilitada se activa para tu perfil de usuario de Salesforce. Para verificar: abre Salesforce y ve a Configuración > Administración > Usuarios > Perfiles, selecciona el perfil relevante y confirma que la API habilitada está marcada.

Consejo:

• Cómo comprobar tu perfil asignado: haz clic en tu avatar de perfil en la esquina superior derecha de Salesforce y, a continuación, haz clic en Configuración > Detalles avanzados de usuario. Tu nombre de perfil aparece en el campo Perfil . Como alternativa, ve a Configuración > Administración > Usuarios > Usuarios y comprueba la columna Perfil para tu nombre de usuario.
• Recomendamos aprovisionar y asignar un usuario de integración de Salesforce dedicado para las conexiones de UiPath. Las conexiones heredan los permisos de la cuenta utilizada para la autenticación, incluido el acceso a campos y objetos. El uso de un usuario dedicado garantiza un acceso coherente y auditable.

Métodos de autenticación

El conector de UiPath Salesforce admite los siguientes métodos de autenticación. Las credenciales necesarias dependen del método que elijas:

Método de autenticación	Descripción	Credenciales necesarias
Contraseña OAuth 2.0 (obsoleto)	Autenticación heredada para cuentas/aplicaciones de Salesforce más antiguas. Bloqueado de forma predeterminada para las nuevas organizaciones según las notas de la versión de Salesforce y programado para su retirada con Salesforce Winter '27 (septiembre-octubre de 2026). Recomendamos utilizar uno de los otros métodos OAuth en su lugar. Utilízalo solo para escenarios especiales.	Nombre de usuario, contraseña, token de seguridad
Token de acceso personal (PAT)	Autenticación de servidor a servidor portador de JSON Web Token (JWT) utilizando un certificado digital. Ideal para automatizaciones unattended donde no es posible un inicio de sesión interactivo.	Entorno, clave API OAuth, secreto API OAuth, clave codificada JWT base64, audiencia, emisor (client_id), asunto (nombre de usuario)
Traiga su propia aplicación (BYOA)	Utiliza una aplicación privada que creas en Salesforce. Recomendado por UiPath, ya que te da control total sobre los ámbitos, las políticas y la marca.	ID de cliente, secreto de cliente (de tu aplicación cliente externa de Salesforce)

Para obtener más información sobre los diferentes tipos de autenticación disponibles para Salesforce, consulta la documentación oficial de Salesforce en Crear una aplicación cliente externa.

Contraseña de OAuth 2.0 (obsoleta)

ADVERTENCIA:

Este método de autenticación está obsoleto. Salesforce ha declarado obsoleto el flujo de nombre de usuario y contraseña de OAuth 2.0 para las aplicaciones conectadas y lo está retirando con la versión Winter '27 (implementación de septiembre a octubre de 2026, aplicada por organización). Consulta la Actualización de la versión de Salesforce. También está bloqueado de forma predeterminada para las nuevas organizaciones de Salesforce.

Recomendamos migrar a uno de los otros métodos OAuth disponibles: código de autorización OAuth 2.0, credenciales de cliente OAuth 2.0, portador de JWT (PAT) o Trae tu propia aplicación (BYOA). Utiliza la contraseña OAuth 2.0 solo si tu organización la requiere explícitamente para ser compatible con versiones anteriores.

Si necesitas utilizar este método, habilítalo primero siguiendo la documentación de Salesforce: OAuth 2.0 Flujo de nombre de usuario-contraseña para escenarios especiales. Entonces:

1. Selecciona Integration Service en la barra izquierda.
2. En la lista Conectores , selecciona Salesforce. Puedes utilizar la barra de búsqueda para encontrar el conector.
3. Selecciona Conectar a Salesforce.
4. Selecciona el entorno: Producción o Sandbox.
5. Selecciona Contraseña OAuth 2.0 como método de autenticación.
6. Introduce tu nombre de usuario, contraseña y token de seguridad de Salesforce.
7. Select Connect.

Obtener tu token de seguridad: en Salesforce, ve a la configuración de tu perfil > Restablecer mi token de seguridad. El token se envía a su correo electrónico. Añádela a tu contraseña al conectarte.

Autenticación de portador JWT (PAT)

La autenticación de portador JWT utiliza un certificado digital para firmar una solicitud JWT, lo que permite la integración de servidor a servidor sin inicio de sesión interactivo. Esto es ideal para automatizaciones unattended. Sigue estos pasos:

1. Crea una clave privada y un certificado digital autofirmado. Consulta la guía de Salesforce: Crear una clave privada y un certificado digital autofirmado.

2. Crea una aplicación de cliente externo en Salesforce. Ve a Configuración > Apps > Apps de cliente externo > Gestor de Apps de cliente externo y selecciona Nueva App de cliente externo. Carga tu certificado digital en la configuración de la aplicación. (Consulta la sección Trae tu propia aplicación (BYOA) (recomendado) a continuación para ver los pasos detallados).

3. Configura el flujo portador de JWT. En la configuración de la aplicación cliente externa, habilita el flujo portador JWT en Habilitación de flujo. Asigna los ámbitos OAuth necesarios.

4. Preautoriza la aplicación para tu usuario de integración. Ve a Configuración > Apps conectadas > Gestionar Apps conectadas, busca tu aplicación y, en Políticas, establece Usuarios permitidos en "Los usuarios aprobados por el administrador están preautorizados". A continuación, añade el perfil o conjunto de permisos correspondiente.

5. Recupera la clave de consumidor y el secreto de consumidor de tu aplicación de cliente externo, como se describe en Paso B: Recuperar el ID de cliente y el secreto de cliente. Necesitas ambos para los campos Clave de API OAuth y Secreto de API OAuth .

6. Selecciona Integration Service en la barra izquierda.

7. En la lista Conectores , selecciona Salesforce. Utiliza la barra de búsqueda para encontrar el conector si es necesario.

8. Selecciona Conectar a Salesforce.

9. Utiliza el menú desplegable Carpeta en la que se almacena la conexión para elegir la carpeta donde se guarda la conexión (por ejemplo, Mi espacio de trabajo).

10. Utiliza el menú desplegable Tipo de autenticación para seleccionar Token de acceso personal (PAT).

11. Completa los campos de conexión. Todos los campos marcados con un asterisco (*) son obligatorios.

    Campo	Obligatorio	Descripción
    Entorno	Sí	Selecciona Sandbox para entornos de prueba o Producción para operaciones en vivo.
    Clave API OAuth	Sí	Introduce la clave API que se encuentra en la sección Credenciales de la aplicación de tu aplicación: la clave de consumidor de tu aplicación cliente externa.
    Secreto de la API OAuth	Sí	Introduce el secreto de la API que se encuentra en la sección Credenciales de la aplicación de tu aplicación: el secreto del consumidor de tu aplicación de cliente externo.
    Clave codificada JWT en formato Base64	Sí	Pega tu clave privada JWT codificada en Base64: la clave privada que generaste en el paso 1, codificada en Base64.
    Audiencia	Sí	Introduce el valor de audiencia (aud) que identifica el servidor de autorización de destino: https://login.salesforce.com para Producción o https://test.salesforce.com para Sandbox.
    Emisor	Sí	Introduce el OAuth client_id (iss) de tu aplicación de cliente externo: la clave de consumidor, el mismo valor que la clave API OAuth.
    Asunto	Sí	Introduce el nombre de usuario (sub) de la cuenta que se está autorizando o suplantando. Este usuario debe estar preautorizado para la aplicación (paso 4).

12. Opcionalmente, expande Configuración avanzada para revisar o cambiar el Tipo de conexión. El valor predeterminado es Estándar, que utiliza las API del conector público.

13. Select Connect.

Para obtener más información sobre la habilitación de tokens JWT, consulta la documentación de Salesforce: Flujo de portador OAuth 2.0 JWT para la integración de servidor a servidor, Habilitar tokens de acceso basados en token web JSON (JWT) y Tokens de acceso basados en JWT.

Traiga su propia aplicación (BYOA) (recomendado)

Importante:

Salesforce ha declarado obsoleto el modelo de aplicación conectada heredado. Todas las aplicaciones nuevas deben crearse como External Client Apps. Las Apps conectadas existentes siguen funcionando, pero Salesforce recomienda migrar a aplicaciones cliente externas. Los siguientes pasos reflejan el nuevo flujo de trabajo de la aplicación cliente externa.

Este método utiliza una aplicación privada que creas y gestionas en Salesforce, lo que te da control total sobre los ámbitos OAuth y las políticas de seguridad. Sigue estos pasos:

Paso A: crear una aplicación cliente externa en Salesforce

1. Inicia sesión en tu cuenta de Salesforce y ve a Configuración.
2. Dirígete a Apps > Aplicaciones cliente externas > Gestor de aplicaciones cliente externas.
3. Selecciona Nueva aplicación cliente externa.
4. Rellene los campos obligatorios:
   • Nombre de la aplicación cliente externa: un nombre descriptivo (por ejemplo, "Integración de UiPath").
   • Nombre de API: debe contener solo guiones bajos y caracteres alfanuméricos, ser único, comenzar con una letra y no terminar con un guion bajo ni contener guiones bajos consecutivos.
   • Correo electrónico de contacto: la dirección de correo electrónico del propietario de la aplicación.
   • Estado de distribución: selecciona Local (para uso en una sola organización) o Empaquetado.
5. Expande la sección API (Habilitar configuración de OAuth) y marca Habilitar OAuth.
6. En el campo URL de devolución de llamada , introduce la URL de devolución de llamada OAuth de UiPath proporcionada en tu pantalla de configuración de conexión de Integration Service.
7. Selecciona los ámbitos OAuth necesarios y muévelos a Ámbitos OAuth seleccionados. Como mínimo, incluye: Acceder al servicio de URL de identidad, Gestionar datos de usuario a través de API y Realizar solicitudes en cualquier momento.
8. En Habilitación de flujo, selecciona Habilitar código de autorización y flujo de credenciales.
9. En Seguridad, marca tanto Requerir secreto para flujo de servidor web como Requerir secreto para flujo de token de actualización.
10. Selecciona Crear.

Paso A.1: Configurar políticas (obligatorio)

Después de crear la aplicación cliente externa, debes configurar sus políticas:

1. Ve a Configuración > Apps conectadas > Gestionar Apps conectadas.
2. Busca tu aplicación de cliente externo y selecciona Editar políticas.
3. Establece lo siguiente:
   • Usuarios permitidos: "Todos los usuarios pueden autoautorizarse"
   • Relajación de IP: "Relajar las restricciones de IP"
   • Política de token de actualización: "El token de actualización es válido hasta que se revoque"
4. Selecciona Guardar.

Paso B: recuperar el ID de cliente y el secreto de cliente

1. En la aplicación cliente externa, ve a la pestaña Configuración .
2. Expande Configuración de OAuth.
3. Selecciona Clave y secreto de consumidor.
4. Introduce tus credenciales (y OTP si se te solicita).
5. Copia la clave de consumidor (este es tu ID de cliente) y el secreto de consumidor (este es tu secreto de cliente). Guárdalos de forma segura.

Nota:

Después de crear o modificar una aplicación cliente externa, Salesforce puede tardar hasta 10 minutos en propagar los cambios. Espere antes de intentar conectarse.

Paso C: conectarse en Integration Service

1. Selecciona Integration Service en la barra izquierda.

2. En la lista Conectores , selecciona Salesforce. Puedes utilizar la barra de búsqueda para encontrar el conector.

3. Selecciona Conectar a Salesforce.

4. Selecciona el entorno: Producción o Sandbox.

   

5. Selecciona Trae tu propia aplicación OAuth 2.0 como método de autenticación.

6. Introduce el ID de cliente y el Secreto de cliente del paso B.

7. Select Connect.

8. Complete el inicio de sesión de Salesforce y autorice la aplicación.

Dominio personalizado: si tu organización de Salesforce utiliza un dominio personalizado, haz clic en Utilizar dominio personalizado en la pantalla de inicio de sesión de Salesforce, introduce la URL de tu dominio personalizado (por ejemplo, yourcompany.my.salesforce.com), luego haz clic en Continuar e introduce tus credenciales.

Para obtener más información, consulta la documentación de Salesforce: Configurar los ajustes de OAuth de la aplicación cliente externa y Habilitar los ajustes de OAuth para la integración de la API.

Caducidad y actualización del token

Los tokens OAuth pueden caducar tras un tiempo determinado en función de tu configuración de Salesforce. Para evitar desconexiones inesperadas en los flujos de trabajo de producción:

• Establece la Política de token de actualización en "El token de actualización es válido hasta que se revoque" en la configuración de tu aplicación conectada de Salesforce o aplicación cliente externa.
• Asegúrate de que se concede el ámbito "Realizar solicitudes en cualquier momento". Este ámbito permite la actualización sin conexión y no está incluido en el ámbito de "acceso completo": debe configurarse de forma independiente.

Consulta las guías de Salesforce: Gestionar políticas de acceso OAuth para una aplicación conectada y Tokens y ámbitos de OAuth para conocer los pasos de configuración detallados.

Configuración de Sandbox

Para configurar una cuenta de Sandbox, sigue los pasos descritos en la documentación oficial de Salesforce: Consideraciones de configuración de Sandbox.

Los sandbox de Salesforce están aislados de tu organización de producción. Las operaciones realizadas en un Sandbox no afectan a los datos de producción, y viceversa. Los Sandboxes son casi idénticos a los de producción, pero existen algunas diferencias. Consulta la documentación de Salesforce para obtener más detalles.

Consejo:

Al empezar a utilizar UiPath con Salesforce, recomendamos probar en una cuenta de Sandbox o con datos no esenciales. Esto evita cualquier pérdida de datos cruciales, especialmente porque las acciones realizadas a través de automatizaciones no se pueden deshacer fácilmente.

Permisos

Las conexiones de Salesforce en UiPath heredan los permisos de la cuenta utilizada para la autenticación. A continuación se muestra una guía completa de los permisos necesarios.

Ámbitos OAuth necesarios (aplicación pública de UiPath)

Al crear una conexión a través de la aplicación pública de UiPath, el conector solicita los siguientes permisos:

Permiso/Ámbito	Propósito
Acceder al servicio de URL de identidad	Recuperar información de identidad del usuario
Gestionar datos de usuario a través de API	Leer y escribir registros de Salesforce a través de la API
Gestionar datos de usuario a través de navegadores web	Acceso a datos basado en navegador
Acceder a los recursos de la API REST de Connect	Acceso a la API de Chatter y Connect
Acceder a las aplicaciones de Visualforce	Interactuar con páginas de Visualforce
Acceder a identificadores únicos de usuario	Acceso de ID de usuario único para la asignación
Acceder a permisos personalizados	Leer asignaciones de permisos personalizados
Acceder a los recursos de la API REST de análisis	Informes y paneles a través de API
Acceder a los recursos de geodatos de gráficos de la API de REST de análisis	Datos geográficos en análisis
Administrar conexiones de hub	Gestión de conexiones de hub
Administrar los servicios de Pardot	Acceso a la automatización de marketing de Pardot
Acceder a aplicaciones Lightning	Acceso a Lightning Experience
Acceder a recursos de contenido	Acceso a la biblioteca de contenido
Gestionar los datos de la API de ingestión de Salesforce CDP	Ingestión de datos CDP
Gestionar los datos del perfil de Salesforce CDP	Gestión de perfiles CDP
Realizar consultas ANSI SQL en datos de Salesforce CDP	Consulta de datos CDP
Acceder a los servicios de chatbot	Servicios de Bot de Einstein
Realizar solicitudes en cualquier momento	Acceso al token de actualización sin conexión
Realizar la segmentación de los datos de Salesforce CDP	Segmentación de CDP

Permiso de API habilitada

Debes tener el permiso API habilitada en Salesforce. Para configurar: ve a Configuración > Administración > Usuarios > Perfiles, selecciona el perfil relevante y asegúrate de que API habilitada esté marcada en Permisos administrativos.

Permisos de objetos estándar y personalizados

Recomendamos que la cuenta del usuario conectado tenga permisos para leer, escribir, editar, eliminar, ver todo y modificar todo para los objetos estándar o personalizados con los que interactúan tus automatizaciones. Para configurar:

• Ve a Configuración > Administración > Usuarios > Perfiles (o Conjuntos de permisos).
• Localiza los objetos estándar o personalizados relevantes y asigna los permisos necesarios.
• La seguridad a nivel de objeto es la forma más amplia de controlar el acceso a los datos. Configura la capacidad de un usuario para ver, crear, editar o eliminar registros de un tipo de objeto específico (por ejemplo, clientes potenciales, oportunidades). Si un objeto está oculto para el usuario de integración, no aparecerá en UiPath.

Nota:

Si los objetos de Salesforce esperados no aparecen en UiPath, consulta con tu administrador de Salesforce para confirmar que el usuario de integración tiene acceso a todos los objetos necesarios.

Seguridad a nivel de campo

La seguridad a nivel de campo controla la visibilidad de los campos individuales dentro de los objetos, incluso en listas relacionadas, vistas de lista, informes y resultados de búsqueda. También determina si los usuarios pueden ver o editar valores de campo. Esto te permite proteger los datos confidenciales sin ocultar objetos completos.

Configura la seguridad a nivel de campo a través de perfiles o conjuntos de permisos en Salesforce. Si los campos esperados no aparecen en UiPath, consulta con tu administrador de Salesforce para confirmar que el usuario de integración tiene acceso a los campos necesarios.

Perfiles y conjuntos de permisos

Los permisos de usuario y la configuración de acceso controlan lo que los usuarios pueden hacer en tu organización de Salesforce:

• Perfiles: define los permisos de referencia para un grupo de usuarios. A cada usuario se le asigna un perfil. Utiliza perfiles para asignar los permisos mínimos necesarios.
• Conjuntos de permisos: añade permisos adicionales sobre un perfil. Un usuario puede tener varios conjuntos de permisos. Utilízalos para añadir capas de acceso adicional según sea necesario para las integraciones.

Solución de problemas

Error/síntoma	Resolución
invalid_client_id / "identificador de cliente no válido"	No se reconoce la clave del consumidor (ID de cliente). Causas comunes: Retraso de propagación: después de crear o modificar una aplicación cliente externa, espera hasta 10 minutos para que Salesforce propague los cambios. Clave de consumidor incorrecta: vuelve a copiarla desde la pestaña Configuración de la aplicación de cliente externo > Configuración OAuth > Clave y secreto del consumidor. Falta de coincidencia entre Sandbox y producción: asegúrate de que el entorno seleccionado en UiPath coincide con el lugar donde se creó la aplicación (Sandbox usa test.salesforce.com, Production usa login.salesforce.com).
falta el desafío del código requerido	Se aplica PKCE (Clave de prueba para el intercambio de códigos). Desactívela en dos lugares: Nivel de organización: Configuración > Identidad > Configuración de OAuth y OpenID Connect : desactiva "Requerir clave de prueba para la extensión de intercambio de código (PKCE) para los flujos de autorización compatibles". Nivel de aplicación: en la configuración de OAuth de la aplicación cliente externa, desmarca el requisito PKCE. La configuración a nivel de organización anula la configuración a nivel de aplicación; ambas deben estar desactivadas. Después de deshabilitar, espere unos minutos y borre la caché del navegador antes de volver a intentarlo.
Error al intercambiar el código OAuth por el token	Se emitió el código de autorización, pero el intercambio de tokens falló. Causas comunes: Falta de coincidencia de la URL de devolución de llamada: verifique que la URL de su aplicación cliente externa coincida exactamente con lo que envía UiPath (compruebe http frente a https, barras finales, mayúsculas y minúsculas). Secreto de cliente incorrecto: vuelve a copiar desde Configuración > Configuración OAuth > Clave y secreto del consumidor. Políticas no configuradas: ve a Configuración > Apps conectadas > Gestionar aplicaciones conectadas, busca la aplicación, haz clic en Editar políticas y establece Usuarios permitidos en "Todos los usuarios pueden autoautorizarse", Relajación de IP en "Relajar restricciones de IP" y Política de token de actualización a "El token de actualización es válido hasta que se revoque". Límite de tokens: Salesforce permite un máximo de 5 tokens simultáneos por usuario y aplicación; revocar tokens antiguos a través de Configuración > Seguridad > Gestión de sesiones.
La conexión se desconecta inesperadamente	Es posible que el token de actualización haya caducado. Establece la Política de token de actualización en "El token de actualización es válido hasta que se revoque" y asegúrate de que se concede el ámbito "Realizar solicitudes en cualquier momento". Consulta la sección Caducidad y actualización del token .
Faltan objetos o campos en UiPath	La configuración de seguridad a nivel de objeto o de campo impide la visibilidad. Consulta con tu administrador de Salesforce para confirmar que el perfil del usuario de integración tiene acceso de lectura/escritura a los objetos y campos necesarios.
Error de API habilitada/privilegios insuficientes	El perfil del usuario conectado no tiene el permiso API habilitada. Ve a Configuración > Perfiles, selecciona el perfil y habilítalo en Permisos administrativos.
Solicitud de MFA durante la conexión	Su organización requiere autenticación multifactor. Utiliza una aplicación de autenticación para completar el paso de verificación. Para escenarios automatizados (desatendidos), considera utilizar la autenticación de portador JWT, que no requiere MFA interactivo.
Dominio personalizado no reconocido	Haz clic en Utilizar dominio personalizado en la pantalla de inicio de sesión de Salesforce, introduce la URL del dominio personalizado completo (por ejemplo, yourcompany.my.salesforce.com) y haz clic en Continuar antes de introducir las credenciales.

Mejores prácticas

• Utiliza un usuario de integración dedicado. Crea un usuario de Salesforce dedicado para las integraciones de UiPath en lugar de utilizar cuentas personales. Esto garantiza permisos coherentes, simplifica la auditoría y evita interrupciones cuando los usuarios individuales cambian de rol.
• Prueba primero en un Sandbox. Pruebe siempre las nuevas conexiones y automatizaciones en un entorno de pruebas de Salesforce antes de implementarlas en producción. Las acciones realizadas a través de UiPath no siempre se pueden deshacer.
• Aplicar permisos de privilegios mínimos. Otorgue solo el acceso al objeto y al campo que sus automatizaciones realmente necesitan. Utiliza perfiles para el acceso de referencia y conjuntos de permisos para ámbitos adicionales.
• Configura las políticas de actualización de tokens. Establezca la política de token de actualización en "válida hasta que se revoque" y otorgue el ámbito "Realizar solicitudes en cualquier momento" para evitar desconexiones inesperadas.
• Utiliza nombres de conexión significativos. Al crear conexiones en Integration Service, utiliza nombres descriptivos que indiquen el entorno y el propósito (por ejemplo, "Salesforce-Production-OrderSync") para facilitar la gestión.
• Plan para la migración de la aplicación cliente externa de Salesforce. Salesforce ha declarado obsoleto el modelo de aplicación conectada heredado. Todas las nuevas Apps deben crearse como aplicaciones cliente externas. Planifique la migración de las Connected Apps existentes según las instrucciones de Salesforce.