Compartir a través de

Conector de Microsoft Graph de Salesforce CRM

  • 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 administradores de Microsoft 365 o a cualquier persona que configure, ejecute y supervise un conector de Microsoft Graph de Salesforce CRM.

Importante

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

Capacidades

  • Indexar contactos, oportunidades, clientes potenciales, casos y objetos de cuentas en la instancia de Salesforce
  • Filtrar la base de contenido que desea indexar
  • Acceso a los datos de Salesforce CRM mediante la eficacia de la búsqueda semántica
  • Conservar las ACL definidas por la organización
  • Personalización de la frecuencia de rastreo
  • Cree agentes y flujos de trabajo con esta conexión y complementos desde Microsoft Copilot Studio

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

Requisitos previos

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.

Introducción

Captura de pantalla que muestra la pantalla de creación de conexiones para Microsoft Graph Connector para Salesforce CRM.

1. Nombre para mostrar

Se usa un nombre para mostrar para identificar cada referencia en Copilot, lo que ayuda a los usuarios a reconocer fácilmente el archivo o elemento asociado. El nombre para mostrar también significa contenido de confianza. El nombre para mostrar también se usa como filtro de origen de contenido. Hay un valor predeterminado para este campo, pero puede personalizarlo para un nombre que los usuarios de su organización reconozcan.

2. Dirección URL de Salesforce CRM

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.

3. Tipo de autenticación

Para autenticar y sincronizar contenido desde Salesforce CRM, elija OAuth 2.0. Escriba el identificador de cliente y el secreto de cliente que obtuvo de la instancia de Salesforce y seleccione Autorizar.

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.
  • Asegúrese de que la cuenta de Salesforce que se usa para iniciar sesión en el conector de Graph es la misma que el usuario que ya ha iniciado sesión en Salesforce.
  • Asegúrese de que el usuario que inicia sesión tiene todos los permisos de objeto necesarios para la organización.

Compruebe que la conexión se realizó correctamente buscando una marca verde que muestre las credenciales correctas, como se muestra en la captura de pantalla siguiente.

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

4. Lanzamiento a audiencia limitada

Implemente esta conexión en una base de usuarios limitada si desea validarla en Copilot y en otras superficies de búsqueda antes de expandir el lanzamiento a una audiencia más amplia. Para obtener más información sobre el lanzamiento limitado, consulte Lanzamiento preconfigurado.

En este momento, está listo para crear la conexión para Salesforce CRM. Puede hacer clic en Crear para publicar el contenido de conexión e índice desde la instancia de Salesforce.

Para otras configuraciones, como permisos de acceso, reglas de inclusión de datos, esquema, frecuencia de rastreo, etc., tenemos valores predeterminados basados en lo que funciona mejor con los datos jira. Puede ver los valores predeterminados siguientes:

Usuarios Descripción
Permisos de acceso Solo las personas con acceso al contenido en el origen de datos.
Identidades de mapa Identidades de origen de datos asignadas mediante identificadores de Microsoft Entra.
Contenido Descripción
Objetos de Salesforce Todos los objetos se indizan.
Filtrar datos Todos los objetos se indizan. No se aplica ningún filtro de tiempo ni criterios SOQL .
Administrar propiedades Para comprobar las propiedades predeterminadas y su esquema, consulte el contenido.
Sincronizar Descripción
Rastreo incremental Frecuencia: Cada 15 minutos
Rastreo completo Frecuencia: todos los días

Si desea editar cualquiera de estos valores, debe elegir la opción "Configuración personalizada".

Configuración personalizada

La configuración personalizada es para aquellos administradores que quieren editar los valores predeterminados de la configuración enumerada en la tabla anterior. Una vez que haga clic en la opción "Configuración personalizada", verá tres pestañas más: Usuarios, Contenido y Sincronización.

Usuarios

Captura de pantalla que muestra la pestaña Usuarios donde puede configurar permisos de acceso y reglas de asignación de usuarios.

Permisos de acceso

El conector de Salesforce CRM admite permisos de búsqueda visibles para todos los usuarios o solo personas con acceso a este origen de datos. Si elige Todos, los datos indexados aparecerán en los resultados de búsqueda de todos los usuarios. Si elige Solo las personas con acceso a este origen de datos, los datos indexados aparecerán en los resultados de búsqueda de los usuarios que tengan acceso a ellos. Elija el que sea más adecuado para su organización.

Asignación de identidades

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-Microsoft Entra" como tipo de identidad.

Si eligió ingerir una ACL desde la instancia de Salesforce y seleccionó "non-ME ID" para el tipo de identidad, consulte Asignación de las identidades que no son de Microsoft Entra para obtener instrucciones sobre cómo asignar las identidades.

Si eligió ingerir una ACL desde la instancia de Salesforce y seleccionó "ME-ID" 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.

Nota:

Novedades a grupos que rigen los permisos de acceso solo se sincronizan en rastreos completos. Los rastreos incrementales no admiten el procesamiento de actualizaciones de permisos.

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.

Contenido

Elección de objetos de Salesforce y filtrado de datos

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.

Administrar propiedades

Aquí puede agregar o quitar las propiedades disponibles del origen de datos de Salesforce CRM, asignar un esquema a la propiedad (definir si una propiedad se puede buscar, consultar, recuperar o refinar), cambiar la etiqueta semántica y agregar un alias a la propiedad. Aunque este paso no es obligatorio, tener algunas etiquetas de propiedad mejora la relevancia y garantiza mejores resultados para los usuarios finales. De forma predeterminada, algunas de las etiquetas como "Title", "URL", "CreatedBy" y "LastModifiedBy" ya tienen asignadas propiedades de origen. Las propiedades seleccionadas de forma predeterminada se enumeran a continuación.

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.

Vista previa de datos

Use el botón vista previa de los resultados para comprobar los valores de ejemplo de las propiedades seleccionadas y el filtro de consulta.

Sincronizar

Captura de pantalla que muestra la pestaña Sincronizar donde puede configurar la frecuencia de rastreo.

El intervalo de actualización determina la frecuencia con la que se sincronizan los datos entre el origen de datos y el índice del conector de Graph. Hay dos tipos de intervalos de actualización: rastreo completo y rastreo incremental. Para obtener más información, vea Actualizar configuración.

Puede cambiar los valores predeterminados del intervalo de actualización desde aquí si lo desea.

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.

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.