Compartir a través de

Conector de Salesforce Microsoft Graph

  • Artículo

El conector de Salesforce Microsoft Graph permite a su organización indexar contactos, oportunidades, clientes potenciales, casos y objetos de cuentas en la instancia de Salesforce. Después de configurar el conector y el contenido de índice de Salesforce, los usuarios finales pueden buscar esos elementos desde cualquier cliente de Microsoft Search y Microsoft 365 Copilot.

Este artículo está destinado a cualquier persona que configure, ejecute y supervise un conector de Salesforce Microsoft Graph. Complementa el proceso de configuración general y muestra instrucciones que se aplican solo al conector de Salesforce Microsoft Graph. En este artículo también se incluye información sobre las limitaciones.

Importante

El conector de Salesforce Microsoft Graph admite actualmente Summer '19 o posterior.

Antes de empezar

Para conectarse a la instancia de Salesforce, necesita la dirección URL de la instancia de Salesforce, el identificador de cliente y el secreto de cliente para la autenticación de OAuth. En los pasos siguientes se explica cómo usted o su administrador de Salesforce pueden obtener esta información de su cuenta de Salesforce:

  • Inicie sesión en la instancia de Salesforce y vaya a Configuración.

  • Vaya a Aplicaciones:> Administrador de aplicaciones.

  • Seleccione Nueva aplicación conectada.

  • Complete la sección api de la siguiente manera:

    • Active la casilla Habilitar configuración de Oauth.

    • Especifique la dirección URL de devolución de llamada como: Para M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback, para M365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback

    • Seleccione estos ámbitos de OAuth necesarios.

      • Acceso y administración de los datos (API).

      • Realice solicitudes en su nombre en cualquier momento (refresh_token, offline_access).

    • Active la casilla Requerir secreto para el flujo de servidor web.

    • Guarde la aplicación.

      Sección api en la instancia de Salesforce después de que el administrador haya especificado todas las configuraciones necesarias enumeradas anteriormente.

  • Copie la clave de consumidor y el secreto de consumidor. Esta información se usa como el identificador de cliente y el secreto de cliente al configurar las opciones de conexión para el conector de Salesforce Microsoft Graph en el portal de administración de Microsoft 365.

    Resultados devueltos por la sección API en la instancia de Salesforce después de que el administrador haya enviado todas las configuraciones necesarias. La clave de consumidor está en la parte superior de la columna izquierda y el secreto de consumidor está en la parte superior de la columna derecha.

  • Antes de cerrar la instancia de Salesforce, siga estos pasos para asegurarse de que los tokens de actualización no expiren:

    • Vaya a Aplicaciones:> App Manager.
    • Busque la aplicación que creó y seleccione la lista desplegable de la derecha. Haga clic en Administrar.
    • Seleccione Editar directivas.
    • Para la directiva de token de actualización, seleccione Refresh token is valid until revoked (Actualizar token es válido hasta que se revoque).

    Seleccione la directiva de token de actualización denominada

Ahora puede usar el Centro de Administración de Microsoft 365 para completar el resto del proceso de instalación del conector de Microsoft Graph.

Paso 1: Agregar un conector en el Centro de administración de Microsoft 365

Incorporación del conector de Salesforce

Siga las instrucciones generales de configuración.

Paso 2: Asignar un nombre a la conexión

Siga las instrucciones generales de configuración.

Paso 3: Configurar las opciones de conexión

Para la dirección URL de instancia, use https://[dominio].my.salesforce.com donde el dominio sería el dominio de Salesforce para su organización.

Escriba el identificador de cliente y el secreto de cliente que obtuvo de la instancia de Salesforce y seleccione Iniciar sesión.

La primera vez que haya intentado iniciar sesión con esta configuración, obtendrá una ventana emergente que le pedirá que inicie sesión en Salesforce con su nombre de usuario y contraseña de administrador. En la captura de pantalla siguiente se muestra el elemento emergente. Escriba sus credenciales y seleccione "Iniciar sesión".

Inicio de sesión emergente que pide nombre de usuario y contraseña.

Nota:

Si el elemento emergente no aparece, es posible que se bloquee en el explorador, por lo que debe permitir elementos emergentes y redireccionamientos.

Compruebe que la conexión se realizó correctamente buscando un banner verde que diga "conexión correcta", como se muestra en la captura de pantalla siguiente.

Captura de pantalla del inicio de sesión correcto. El banner verde que indica

Paso 4: Seleccionar propiedades

Seleccione los objetos de Salesforce que desea que el conector rastree e incluya en los resultados de la búsqueda. Si se selecciona Contacto, cuenta también se selecciona automáticamente.

Nota:

Si un campo tiene la seguridad de nivel de campo (FLS) establecida para un perfil, el conector no ingerirá ese campo para ningún perfil de esa organización de Salesforce. Como resultado, los usuarios no podrán buscar valores para esos campos ni mostrarse en los resultados.

Filtrar datos

También puede elegir filtrar el contenido de Salesforce que se indexa de dos maneras:

  • Especifique el período de tiempo modificado del elemento. Esta opción solo indexará el contenido de Salesforce que se crea o modifica en el período de tiempo seleccionado de forma gradual en función del rastreo actual.
  • Escriba la consulta de Salesforce (SOQL) que especifica lo que quiere indexar mediante la cláusula WHERE .

Captura de pantalla de las opciones de filtrado en el conector de Salesforce

Sugerencia

Puede dejar la cláusula WHERE vacía si desea indexar todo el contenido de la entidad determinada.

Paso 5: Administrar permisos de búsqueda

Tendrá que elegir qué usuarios ven los resultados de búsqueda de este origen de datos. Si solo permite que determinados usuarios de Microsoft Entra ID o que no sean de Azure AD vean los resultados de la búsqueda, asegúrese de asignar las identidades.

Paso 5.a: Seleccionar permisos

Puede elegir ingerir Access Control Listas (ACL) desde la instancia de Salesforce o permitir que todos los usuarios de su organización vean los resultados de búsqueda de este origen de datos. Las ACL pueden incluir identidades de Microsoft Entra (usuarios federados de Microsoft Entra ID a Salesforce), identidades que no son de Azure AD (usuarios nativos de Salesforce que tienen identidades correspondientes en Microsoft Entra ID) o ambas.

Nota:

Si usa un proveedor de identidades de terceros, como Ping ID o secureAuth, debe seleccionar "non-AAD" como tipo de identidad.

Seleccione la pantalla de permisos que ha completado un administrador. El administrador ha seleccionado la opción

Si eligió ingerir una ACL desde la instancia de Salesforce y seleccionó "no AAD" para el tipo de identidad, consulte Asignación de identidades que no son de Azure AD para obtener instrucciones sobre cómo asignar las identidades.

Paso 5.b: Asignar identidades de Microsoft Entra

Si decide ingerir una ACL desde la instancia de Salesforce y selecciona "AAD" para el tipo de identidad, consulte Asignación de las identidades de Microsoft Entra para obtener instrucciones sobre cómo asignar las identidades. Para obtener información sobre cómo configurar Microsoft Entra SSO para Salesforce, consulte este tutorial.

Aplicación de la asignación de usuarios para sincronizar las identidades de Salesforce con identidades de Microsoft Entra

En este vídeo, puede ver el proceso para autenticarse en la instancia de Salesforce, sincronizar las identidades que no son de Microsoft Entra con las identidades de Microsoft Entra y aplicar los recortes de seguridad adecuados a los elementos de Salesforce.

Paso 6: Asignar etiquetas de propiedad

Puede asignar una propiedad de origen a cada etiqueta si elige en un menú de opciones. Aunque este paso no es obligatorio, tener algunas etiquetas de propiedad mejora la relevancia de la búsqueda y garantiza mejores resultados de búsqueda para los usuarios finales. De forma predeterminada, algunas de las etiquetas como "Title", "URL", "CreatedBy" y "LastModifiedBy" ya tienen asignadas propiedades de origen.

La lista de propiedades que seleccione aquí puede afectar a cómo puede filtrar, buscar y ver los resultados en Microsoft 365 Copilot.

Source (propiedad) Label Descripción
Autores authors Nombre de las personas que participaron o colaboraron en el elemento del origen de datos.
CreatedBy createdBy Nombre de la persona que creó el elemento en el origen de datos.
CreatedDate createdDateTime Fecha y hora en que se creó el elemento en el origen de datos.
Url url Dirección URL de destino del elemento en el origen de datos.
LastModifiedBy lastModifiedBy Nombre de la persona que más recientemente editó el elemento en el origen de datos.
LastModifiedDateTime lastModifiedDateTime Fecha y hora en que el elemento se modificó por última vez en el origen de datos.
Nombre title Título del elemento que desea mostrar en la búsqueda y otras experiencias.

Paso 7: Administrar esquema

Puede seleccionar qué propiedades de origen se deben indexar para que aparezcan en los resultados de la búsqueda. El Asistente para conexiones selecciona de forma predeterminada un esquema de búsqueda basado en un conjunto de propiedades de origen. Para modificarlo, active las casillas de cada propiedad y atributo de la página de esquema de búsqueda. Los atributos de esquema de búsqueda incluyen Search, Query, Retrieve y Refine. Refine permite definir las propiedades que se pueden usar más adelante como refinadores o filtros personalizados en la experiencia de búsqueda.

Seleccione el esquema para cada propiedad de origen. Las opciones son Consulta, Búsqueda, Recuperar y Refinar.

Paso 8: Establecer la programación de actualización

El conector de Salesforce solo admite programaciones de actualización para rastreos completos actualmente.

Importante

Un rastreo completo busca los objetos eliminados y los usuarios que se sincronizaron anteriormente con el índice de Búsqueda de Microsoft.

La programación recomendada es de una semana para un rastreo completo.

Paso 9: Revisión de la conexión

Siga las instrucciones generales de configuración.

Sugerencia

Tipo de resultado predeterminado

  • El conector de Salesforce registra automáticamente un tipo de resultado una vez publicado el conector. El tipo de resultado usa un diseño de resultados generado dinámicamente en función de los campos seleccionados en el paso 3.
  • Para administrar el tipo de resultado, vaya a Tipos de resultado en el Centro de administración de Microsoft 365. El tipo de resultado predeterminado se denomina "ConnectionIdDefault". Por ejemplo, si el identificador de conexión es Salesforce, el diseño del resultado se denomina: "SalesforceDefault".
  • Además, puede elegir crear su propio tipo de resultado si es necesario.

Limitaciones

  • El conector de Salesforce Microsoft Graph no admite actualmente el uso compartido y el uso compartido basados en apex y en territorios mediante grupos personales de Salesforce.
  • Hay un error conocido en la API de Salesforce que usa el conector, donde los valores predeterminados de toda la organización privada para clientes potenciales no se respetan actualmente.
  • Si un campo tiene la seguridad de nivel de campo (FLS) establecida para un perfil, el conector no ingerirá ese campo para ningún perfil de esa organización de Salesforce. Como resultado, los usuarios no podrán buscar valores para esos campos ni mostrarse en los resultados.
  • En la pantalla administrar esquema, estos nombres de propiedad estándar comunes aparecen una vez, las opciones son Consulta, Búsqueda, Recuperar y Refinar, y se aplican a todos o ninguno.
    • Nombre
    • Url
    • Descripción
    • Fax
    • Phone
    • MobilePhone
    • Correo electrónico
    • Tipo
    • Cargo
    • AccountId
    • AccountName
    • AccountUrl
    • AccountOwner
    • AccountOwnerUrl
    • Owner
    • OwnerUrl
    • CreatedBy
    • CreatedByUrl
    • LastModifiedBy
    • LastModifiedByUrl
    • LastModifiedDate
    • ObjectName

Solución de problemas

Después de publicar la conexión, puede revisar el estado en la pestaña Orígenes de datos del centro de administración. Para obtener información sobre cómo realizar actualizaciones y eliminaciones, consulte Administración del conector.

Puede encontrar pasos de solución de problemas para los problemas más vistos aquí.

Si tiene problemas o quiere proporcionar comentarios, póngase en contacto con Microsoft Graph | Soporte técnico.