Conector a Salesforce

Con el conector Salesforce®, puedes utilizar comandos para interactuar con Salesforce como parte de una cadena. Por ejemplo, con este conector, puedes:

Sube, extrae y elimina datos en Salesforce mediante SOQL y operaciones masivas.
Crear y gestionar objetos de Salesforce
Actualiza y crea Registros en Salesforce

El conector interactúa con todas las versiones de Salesforce Sales Cloud:

Salesforce Essentials
Salesforce Net Zero Cloud
Lightning® Profesional
Lightning Enterprise
Rayo Ilimitado

Nota: Este conector ha sido creado por Workiva y conecta con un sistema de terceros. Aunque nuestro equipo de asistencia puede ayudarte a configurar este conector dentro de tu espacio de trabajo, no podemos solucionar ni ayudar de ningún otro modo con los problemas que se originen fuera de la plataforma Workiva.

Requisitos

Para que el conector esté disponible para utilizarlo en tu organización, primero debe habilitarlo un administrador de seguridad de la organización.

A continuación, puedes asegurar tu conexión a Salesforce utilizando uno de los métodos siguientes:

Autenticación OAuth de Salesforce, utilizando un Id de cliente, un secreto y un ámbito.
Autenticación básica, utilizando un nombre de usuario y una Contraseña
Credenciales de cliente, utilizando solo un identificador y un secreto de cliente.

Autenticación OAuth de Salesforce

Para conectarte a Workiva, necesitarás el ID de cliente y el secreto de Salesforce, así como el ámbito de OAuth de la aplicación conectada.

Autenticación OAuth Además, la autenticación requiere el uso de una aplicación conectada a Salesforce. Para crear este en Salesforce, establece la aplicación y configura los siguientes ajustes necesarios:

Para Callback URL, introduce una de las siguientes que coincida con tu AppSpot:
- PROD - https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
- EMEA - https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
- APAC - https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
Debajo de Ámbitos OAuth seleccionados, incluye Realizar solicitudes en tu nombre en cualquier hora (refresh_token, offline_access) y al menos otro ámbito.

autenticación básica|autenticación básica

Para conectarte a Workiva, necesitarás el nombre de usuario, la contraseña y el token de seguridad de Salesforce del usuario de integración.

La autenticación básica requiere un usuario de integración con permisos habilitados para API, además de permisos relacionados con cualquier tarea que vaya a realizar el conector.

Nota: Para establecer los permisos del usuario de integración en Salesforce, selecciona Administrar, Gestionar usuarios, Perfiles, y selecciona su perfil.

Debajo de Permisos administrativos, selecciona API activada.
Para que el conector pueda ejecutar un comando, el usuario necesita al menos Leer permisos para sus datos relacionados.
Para realizar actualizaciones masivas de objetos de Salesforce, el usuario necesita Editar permisos para el objeto.

Autenticación de credenciales de clientes

Para conectarte a Workiva, necesitarás el ID de cliente y el secreto de Salesforce.

La autenticación de credenciales de clientes requiere el uso de una aplicación conectada a Salesforce. Para crear este en Salesforce, establece la aplicación utilizando el flujo de credenciales de clientes.

Establecer el conector de Salesforce para la autenticación OAuth

La autenticación OAuth te permite acceder a Salesforce utilizando un ID de cliente y un secreto. A diferencia del método de inicio de sesión con credenciales de cliente, la autenticación OAuth incluye un testigo de actualización y requiere un ámbito.

Se recomienda este método para comandos de ejecución más larga que, de lo contrario, agotan el tiempo de espera utilizando el método de las credenciales de clientes.

En el Generador de cadenas, haz clic en Conexiones compare_arrows y, a continuación, en Crear en la parte superior derecha.
En Conector Conexión, selecciona Salesforce y el CloudRunner predeterminado.
En Información básica, introduce un nombre único y una descripción para ayudar a identificar el conector.

Debajo de Propiedades, introduce la instancia de Salesforce o el dominio personalizado al que conectarte:

Propiedad	Detalles
Instancia	Introduce la instancia de Salesforce a la que conectarte. Si tu organización utiliza un dominio personalizado de Salesforce, déjalo en blanco. Nota: En tu URL de Salesforce, los caracteres anteriores a `salesforce.com`-como `na73`-representan el caso.
Dominio personalizado	Introduce el dominio personalizado de Salesforce al que conectar, si se utiliza. Nota: Para ver tu dominio personalizado en Salesforce, selecciona Configuración de la empresa, Mi dominio. Un dominio a medida suele terminar en `.my.salesforce.com`.

Para Tipo de Autenticación, selecciona Salesforce OAuth.
Introduce el Id de cliente, el secreto y el ámbito en Autenticación, luego haz clic en Conecta.
Nota: Cuando la conexión con Salesforce se realiza correctamente, se rellenan automáticamente los campos del conector Actualizar Token y Access Token. Si la conexión falla, haz clic en Para y espera a conectarte de nuevo.

Nota: Todas las credenciales sensibles se cifran automáticamente y se almacenan con encriptación AES-256.
Selecciona los entornos que vas a utilizar con la conexión y haz clic en Guardar.
Para probar la conexión, crea y ejecuta una cadena con el comando Listar informes del conector, y comprueba que devuelve una salida válida.

Establece el conector de Salesforce para la autenticación básica

La autenticación básica te permite iniciar sesión en Salesforce utilizando el Nombre de usuario y la Contraseña de un usuario de la integración.

En el Generador de cadenas, haz clic en Conexiones compare_arrows y, a continuación, en Crear en la parte superior derecha.
En Conector Conexión, selecciona Salesforce y el CloudRunner predeterminado.
En Información básica, introduce un nombre único y una descripción para ayudar a identificar el conector.

Debajo de Propiedades, introduce la instancia de Salesforce o el dominio personalizado al que conectarte:

Propiedad	Detalles
Instancia	Introduce la instancia de Salesforce a la que conectarte. Si tu organización utiliza un dominio personalizado de Salesforce, déjalo en blanco. Nota: En tu URL de Salesforce, los caracteres anteriores a `salesforce.com`-como `na73`-representan el caso.
Dominio personalizado	Introduce el dominio personalizado de Salesforce al que conectar, si se utiliza. Nota: Para ver tu dominio personalizado en Salesforce, selecciona Configuración de la empresa, Mi dominio. Un dominio a medida suele terminar en `.my.salesforce.com`.

Para Tipo de Autenticación, selecciona Autenticación básica.
En Autenticación, introduce el Nombre de usuario, la Contraseña y el Token de seguridad del usuario de la integración.
Nota: Todas las credenciales sensibles se cifran automáticamente y se almacenan con un cifrado Advanced Cifrado Standard (AES)-256.
Selecciona los entornos que vas a utilizar con la conexión y haz clic en Guardar.
Para probar la conexión, crea y ejecuta una cadena con el comando Listar informes del conector , y comprueba que devuelve una salida válida.

Establece el conector de Salesforce para las credenciales de clientes.

La autenticación de credenciales de clientes te permite acceder a Salesforce utilizando un ID de cliente y un secreto. Esto difiere del método de inicio de sesión OAuth en que no requiere un ámbito y no necesitarás autenticarte en Salesforce a través del botón Conectar.

Advertencia: Este método de autenticación no incluye un testigo de actualización. Por ello, no es adecuado para comandos de larga ejecución y puede provocar tiempos de espera en determinadas cadenas.

En el Generador de cadenas, haz clic en Conexiones compare_arrows y, a continuación, en Crear en la parte superior derecha.
En Conector Conexión, selecciona Salesforce y el CloudRunner predeterminado.
En Información básica, introduce un nombre único y una descripción para ayudar a identificar el conector.

Debajo de Propiedades, introduce la instancia de Salesforce o el dominio personalizado al que conectarte:

Propiedad	Detalles
Instancia	Introduce la instancia de Salesforce a la que conectarte. Si tu organización utiliza un dominio personalizado de Salesforce, déjalo en blanco. Nota: En tu URL de Salesforce, los caracteres anteriores a `salesforce.com`-como `na73`-representan el caso.
Dominio personalizado	Introduce el dominio personalizado de Salesforce al que conectar, si se utiliza. Nota: Para ver tu dominio personalizado en Salesforce, selecciona Configuración de la empresa, Mi dominio. Un dominio a medida suele terminar en `.my.salesforce.com`.

Para Tipo de Autenticación, selecciona Credenciales de cliente.
Debajo de Autenticación, introduce el identificador y el secreto del cliente.
Nota: Todas las credenciales sensibles se cifran automáticamente y se almacenan con encriptación AES-256.
Selecciona los entornos que vas a utilizar con la conexión y haz clic en Guardar.
Para probar la conexión, crea y ejecuta una cadena con el comando Listar informe del conector, y comprueba que devuelve una salida válida.

Solución de problemas

Si falla la conexión con Salesforce, puedes comprobar varios ajustes de configuración, según el tipo de autenticación.

Autenticación OAuth2

Si la conexión con la aplicación conectada a Salesforce falla al hacer clic por primera vez en Conectar, haz clic en Detener y espera a conectarte de nuevo. Si la conexión sigue fallando al utilizar la autenticación OAuth2:

Verifica que se ha introducido la instancia de Salesforce o el dominio personalizado correctos para el conector.
Comprueba el Id de cliente y el secreto de la aplicación conectada a Salesforce que utiliza el conector.
En la aplicación conectada de Salesforce:
- Verifica que la URL de devolución de llamada es:
  - PROD - https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  - EMEA - https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  - APAC - https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
- Asegúrate de que sus ámbitos OAuth seleccionados incluyen Realizar solicitudes en tu nombre en cualquier hora (refresh_token, offline_access) y al menos otro ámbito.

Si el conector pierde la conexión con la aplicación Salesforce:

Desde Cadenas, haz clic en Conexiones comparar_flechas, selecciona el conector y haz clic en Editar.
Debajo de OAuth, haz clic en Restablecer.
Para permitir que el conector se conecte a Salesforce, haz clic en Permitir.

autenticación básica|autenticación básica

Si la conexión falla utilizando la autenticación básica:

Verifica las credenciales de inicio de sesión y el token de seguridad del usuario de la integración. Para solicitar un nuevo token de seguridad en Salesforce, inicia sesión como usuario de integración y selecciona Configuraciones, Mi información personal, y haz clic en Restablecer token de seguridad.
Verifica que se ha introducido la instancia de Salesforce o el dominio personalizado correctos para el conector.
Asegúrate de que el usuario de la integración tiene permisos para API Habilitada, además de los permisos relacionados con cualquier tarea que realice el conector.

Autenticación de credenciales de clientes

Si la conexión falla utilizando la autenticación de credenciales de clientes:

Verifica que se ha introducido la instancia de Salesforce o el dominio personalizado correctos para el conector.
Comprueba el Id de cliente y el secreto de la aplicación conectada a Salesforce que utiliza el conector.

Soporte

Comunidad

Centro de soporte de Workiva