Conexiones externas de Salesforce

Nota

A partir de Summer '27, la llamada login() de API de SOAP en las versiones de API de SOAP 31.0 a 64.0 ya no será compatible y ya no estará disponible. Para obtener más información, consulte Llamada de login() de la API de SOAP en versiones de API de SOAP 31.0 a 64.0.

La configuración de autenticación Nombre de usuario y Contraseña en conectores externos ya no será compatible a partir de Winter '27.

Los nuevos conectores externos requieren OAuth con Id. de cliente y Secreto de cliente para la autenticación. Los conectores existentes que utilizan Nombre de usuario y Contraseña pueden seguir funcionando si la API de SOAP login() está activada en los permisos de su organización. Sin embargo, si necesita actualizar las credenciales para un conector de nombre de usuario y contraseña existente, debe convertirlo para utilizar la configuración de OAuth.

El acceso de API restringido no es compatible con conectores externos y de salida de Salesforce. Active el permiso Usar cualquier cliente de API para el usuario que crea el conector. Para obtener más información, consulte Gestionar acceso API.

Para enviar datos desde CRM Analytics a una organización de Salesforce, utilice una Conexión de salida de Salesforce.

Configurar una aplicación cliente externa para OAuth

Las aplicaciones cliente externas (ECA) proporcionan inicio de sesión único (SSO) y utilizan protocolos de OAuth para autorizar conexiones externas.

Nota

Se recomienda crear una cuenta de usuario de Salesforce separada que no esté asignada a una persona para configurar una conexión. La cuenta de una persona puede desactivarse cuando el usuario abandona su organización, lo que impide que funcionen las conexiones creadas con la cuenta.

1. Para crear una ECA para su organización, desde la página Configuración de Salesforce, introduzca Externa en el cuadro Búsqueda rápida y, a continuación, seleccione Gestor de aplicación cliente externa.
2. Haga clic en Nueva aplicación cliente externa.
3. Introduzca la información básica.
   1. Introduzca el nombre para que la CEPA se muestre en el Gestor de aplicación cliente externa.
   2. Introduzca el nombre de API que se utilizará al hacer referencia a su aplicación desde un programa. Este campo toma como valor predeterminado una versión del nombre de la aplicación con guiones bajos en lugar de los espacios.
   3. Introduzca la dirección de correo electrónico de contacto para que Salesforce la utilice en caso de que queramos ponernos en contacto con usted o su equipo de atención al cliente.
   4. Seleccione Local para el Estado de distribución.
4. Haga clic en Activar OAuth para configurar la política de OAuth.
5. Introduzca los ajustes de la aplicación.
   1. Introduzca la URL de devolución de llamada. La URL de devolución de llamada es la URL de la aplicación donde está incrustando el código y la URL puede aceptar la autenticación devuelta desde Salesforce ECA. Un ejemplo de URL de devolución de llamada es https://<3p-domain>/callback.html.
   2. Para Ámbitos de OAUTH, seleccione Gestionar datos de usuario mediante APIS (api) y Acceder a recursos de API de REST de Analytics (wave_api). Si tiene otras necesidades de OAuth, seleccione otros ámbitos según sea necesario. Para obtener más información, consulte Tokens y ámbitos de OAuth
6. Para Activación de flujo, seleccione Activar flujo de credenciales de cliente. Este flujo permite interacciones de servidor a servidor. Para obtener más información, consulte Flujo de credenciales de cliente de OAuth 2.0 para integración de servidor a servidor
7. Por seguridad, desactive la extensión Requerir clave de prueba para intercambio de códigos (PKCE) para flujos de autorización admitidos.
8. Haga clic en Crear.
9. En la ficha Políticas, haga clic en Modificar. Para Flujos de OAuth y Mejoras de aplicación cliente externa, asegúrese de que Activar flujo de credenciales de cliente está activado. Introduzca un correo electrónico de usuario para Ejecutar como. Este usuario debe ser un usuario de ejecución válido.
10. En la ficha Configuración, haga clic en Clave y secreto de consumidor para copiar y guardar los valores. Necesita el valor de clave de consumidor para el Id. de cliente y el valor de secreto de consumidor para el Secreto de cliente.

Crear la conexión

1. En la ficha Conexiones del Gestor de datos, haga clic en Nueva conexión.
2. Seleccione Conector externo Salesforce y haga clic en Siguiente.
3. Introduzca los parámetros del conector.
4. Para verificar su configuración, haga clic en Guardar y probar. Si la conexión falla, CRM Analytics muestra posibles motivos.

Todas las configuraciones requieren un valor, a menos que se indique lo contrario.

https://mycompany.my.salesforce.com/services/Soap/u/54.0

Filtrar datos sincronizados con CRM Analytics

Utilice filtros para excluir datos confidenciales o innecesarios de la sincronización con filtros de CRM Analytics. Los filtros aceleran la sincronización de datos extrayendo solo los datos que necesita en CRM Analytics.

Nota Si espera excluir datos en el futuro, utilice un filtro de receta en vez de un filtro de sincronización de datos.

1. Desde el Gestor de datos, haga clic en la ficha Conexiones.
2. Seleccione la conexión asociada con el objeto para filtrar.
3. Haga clic en el nombre del objeto para filtrar.
4. Haga clic en Filtro de sincronización de datos.
5. Introduzca el filtro.
6. Haga clic en Guardar.

Para el conector Salesforce External, introduzca un filtro utilizando la expresión de cláusula WHERE de SOQL como se describe en la Referencia de SOQL y SOSL. Por ejemplo, "(FiscalQuarter = 2 OR FiscalQuarter = 3) AND Amount > 1000 AND Amount <= 20000".

Consideraciones del conector Salesforce External

Tenga en cuenta estos comportamientos cuando trabaje con el conector Salesforce External.

• Los nombres de objetos conectados deben comenzar por una letra e incluir solo letras, dígitos y guiones bajos. El nombre no puede terminar con un guión bajo.
• Un nombre de campo solo puede contener caracteres alfanuméricos, puntos, guiones bajos o guiones. Si un nombre de campo contiene otros caracteres, como espacios o corchetes, la sincronización falla.
• El conector puede sincronizar hasta 100 millones de filas o 50 GB por objeto de forma predeterminada, cualquiera que sea el límite que se alcance primero. Los límites se pueden aumentar a un máximo de 2000 millones de filas o 1000 GB con una solicitud de asistencia de Salesforce. Al utilizar el conector, los datos de la organización de Salesforce Government Cloud están protegidos en tránsito con cifrado avanzado y pueden sincronizar hasta 10 millones de filas o 5 GB para cada objeto conectado, cualquiera que sea el límite alcanzado primero.
• Para mejorar el tiempo de sincronización de datos, utilice la sincronización incremental (beta).
• La configuración de seguridad del usuario con el que utiliza la conexión determina los objetos y campos disponibles para sincronizar en la organización externa.
• Puede sincronizar objetos estándar disponibles en versiones de API 34.0 y posteriores.
• Puede utilizar el Tipo de API BULKV2 solo con la versión 50.0 y posterior de la API.
• Para solucionar problemas de conectividad entre organizaciones de Salesforce, revise las restricciones de dirección IP de su organización y considere desactivar el parámetro "Bloquear sesiones en la dirección IP de origen" en ambas organizaciones. También puede buscar artículos Knowledge y problemas conocidos para obtener más información.
• Al importar campos que contienen una divisa, el valor importado no se convierte. Tomemos el ejemplo de una organización que registra valores en libras esterlinas que está importando en una organización local que registra valores en dólares estadounidenses. Se importa un valor de 10 (GBP) en la organización local como un valor de 10.