Соединитель Microsoft Graph Salesforce CRM

Соединитель Salesforce Microsoft Graph позволяет вашей организации индексировать контакты, возможности, потенциальные клиенты, дела и учетные записи в экземпляре Salesforce. После настройки соединителя и индекса содержимого из Salesforce конечные пользователи могут искать эти элементы в любом клиенте поиска (Майкрософт) и Microsoft 365 Copilot.

Эта статья предназначена для администраторов Microsoft 365 или тех, кто настраивает, запускает и отслеживает соединитель Microsoft Graph Salesforce CRM.

Важно!

Соединитель Salesforce Microsoft Graph в настоящее время поддерживает summer '19 или более поздней версии.

Возможности

• Индексирование контактов, возможностей, потенциальных клиентов, обращений и учетных записей в экземпляре Salesforce
• Фильтрация содержимого на основе того, что вы хотите индексировать
• Доступ к данным Salesforce CRM с помощью функции семантического поиска
• Сохранение списков ACL, определенных вашей организацией
• Настройка частоты обхода контента
• Создание агентов и рабочих процессов с помощью этого подключения и подключаемых модулей из Microsoft Copilot Studio

Ограничения

• Соединитель Salesforce Microsoft Graph в настоящее время не поддерживает общий доступ на основе Apex на основе территории и общий доступ с использованием личных групп из Salesforce.
• В API Salesforce, используемом соединителем, есть известная ошибка, из-за которой в настоящее время не учитываются значения по умолчанию для потенциальных клиентов на уровне частной организации.
• Если для профиля задана безопасность на уровне полей (FLS), соединитель не будет принимать это поле ни для каких профилей в этой организации Salesforce. В результате пользователи не смогут искать значения для этих полей или отображаться в результатах.
• На экране управления схемой эти стандартные имена стандартных свойств перечислены один раз, параметры : Запрос, Поиск, Получение и Уточнение, и применяются ко всем или ни к одному.
  • Имя
  • Url
  • Описание
  • Fax
  • Phone
  • MobilePhone
  • Электронная почта
  • Тип
  • Название
  • AccountId
  • AccountName
  • AccountUrl
  • AccountOwner
  • AccountOwnerUrl
  • Владелец
  • OwnerUrl
  • CreatedBy
  • CreatedByUrl
  • LastModifiedBy
  • LastModifiedByUrl
  • LastModifiedDate
  • ObjectName

Предварительные условия

Чтобы подключиться к экземпляру Salesforce, вам потребуется URL-адрес экземпляра Salesforce, идентификатор клиента и секрет клиента для проверки подлинности OAuth. Ниже описано, как вы или ваш администратор Salesforce можете получить эту информацию из учетной записи Salesforce.

• Войдите в экземпляр Salesforce и перейдите в раздел Настройка.

• Перейдите в раздел Приложения —> Диспетчер приложений.

• Выберите Новое подключенного приложения.

• Выполните действия в разделе API следующим образом:

  • Установите флажок Включить параметры Oauth.

  • Укажите URL-адрес обратного вызова: для M365 Корпоративный: https://gcs.office.com/v1.0/admin/oauth/callback, для M365 для государственных организаций: https://gcsgcc.office.com/v1.0/admin/oauth/callback

  • Выберите необходимые области OAuth.

    • Доступ к данным (API) и управление ими.

    • Выполняйте запросы от вашего имени в любое время (refresh_token, offline_access).

  • Установите флажок Требовать секрет для потока веб-сервера.

  • Сохраните приложение.

    

• Скопируйте ключ потребителя и секрет потребителя. Эти сведения используются в качестве идентификатора клиента и секрета клиента при настройке параметров подключения для соединителя Salesforce Microsoft Graph на портале администрирования Microsoft 365.

  

• Перед закрытием экземпляра Salesforce выполните следующие действия, чтобы убедиться, что срок действия маркеров обновления не истек:

  • Перейдите в раздел Приложения —> Диспетчер приложений.
  • Найдите созданное приложение и выберите раскрывающийся список справа. Выберите Управление.
  • Выберите Изменить политики.
  • Для политики маркеров обновления выберите Маркер обновления действителен до отзыва.

  

Теперь вы можете использовать центр Microsoft 365 Admin для завершения оставшейся части процесса настройки соединителя Microsoft Graph.

Начало работы

1. Отображаемое имя

Отображаемое имя используется для идентификации каждой ссылки в Copilot, помогая пользователям легко распознавать связанный файл или элемент. Отображаемое имя также означает доверенное содержимое. Отображаемое имя также используется в качестве фильтра источника содержимого. Для этого поля используется значение по умолчанию, но его можно настроить на имя, которое распознают пользователи в вашей организации.

2. URL-адрес Salesforce CRM

В качестве URL-адреса экземпляра используйте https://[домен].my.salesforce.com, где домен будет доменом Salesforce для вашей организации.

3. Тип проверки подлинности

Для проверки подлинности и синхронизации содержимого из Salesforce CRM выберите OAuth 2.0. Введите идентификатор клиента и секрет клиента, полученные из экземпляра Salesforce, и выберите Авторизовать.

При первой попытке входа с этими параметрами вы получите всплывающее окно с запросом на вход в Salesforce с именем пользователя и паролем администратора. На снимку экрана ниже показано всплывающее окно. Введите свои учетные данные и выберите "Войти".

Примечание.

• Если всплывающее окно не отображается, оно может быть заблокировано в браузере, поэтому необходимо разрешить всплывающие окна и перенаправления.
• Убедитесь, что учетная запись Salesforce, используемая для входа в соединитель Graph, совпадает с учетной записью пользователя, уже выполнившего вход в Salesforce.
• Убедитесь, что у пользователя, который входит в систему, есть все необходимые разрешения для объекта для организации.

Убедитесь, что подключение прошло успешно, найдите зеленую галочку с правильными учетными данными, как показано на снимке экрана ниже.

4. Развертывание для ограниченной аудитории

Разверните это подключение в ограниченной базе пользователей, если вы хотите проверить его в Copilot и других поверхностях поиска, прежде чем развернуть развертывание для более широкой аудитории. Дополнительные сведения об ограниченном выпуске см. в разделе Поэтапное развертывание.

На этом этапе вы готовы создать подключение для Salesforce CRM. Вы можете нажать кнопку Создать , чтобы опубликовать подключение и индексировать содержимое из экземпляра Salesforce.

Для других параметров, таких как разрешения доступа, правила включения данных, схема, частота обхода контента и т. д., мы имеем значения по умолчанию в зависимости от того, что лучше всего подходит для данных Jira. Ниже приведены значения по умолчанию:

Пользователи	Описание
Разрешения доступа	Только пользователи, имеющие доступ к содержимому в источнике данных.
Сопоставление удостоверений	Удостоверения источников данных, сопоставленные с помощью идентификаторов Microsoft Entra.

Содержимое	Описание
Объекты Salesforce	Все объекты индексируются.
Фильтрация данных	Все объекты индексируются. Фильтр времени или условия SOQL не применяются.
Управление свойствами	Сведения о проверка свойств по умолчанию и их схемы см. в разделе Содержимое.

Синхронизация	Описание
Добавочный обход контента	Частота: каждые 15 минут
Полный обход контента	Частота: каждый день

Если вы хотите изменить любое из этих значений, необходимо выбрать параметр "Настраиваемая настройка".

Настраиваемая настройка

Пользовательская настройка предназначена для администраторов, которые хотят изменить значения по умолчанию для параметров, перечисленных в таблице выше. Щелкнув параметр "Настраиваемая настройка", вы увидите еще три вкладки: Пользователи, Содержимое и Синхронизация.

Пользователи

Разрешения доступа

Соединитель Salesforce CRM поддерживает разрешения на поиск, видимые всем или только пользователям с доступом к этому источнику данных. Если выбрать все, индексированные данные будут отображаться в результатах поиска для всех пользователей. Если выбрать только людей с доступом к этому источнику данных, индексированные данные будут отображаться в результатах поиска для пользователей, имеющих к ним доступ. Выберите наиболее подходящий для вашей организации.

Сопоставление удостоверений

Вы можете принять контроль доступа Списки (ACL) из экземпляра Salesforce или разрешить всем пользователям в вашей организации просматривать результаты поиска из этого источника данных. Списки управления доступом могут включать Microsoft Entra удостоверения (пользователи, федеративные из Microsoft Entra ID в Salesforce), удостоверения без Azure AD (собственные пользователи Salesforce с соответствующими удостоверениями в Microsoft Entra ID) или и то, и другое.

Примечание.

При использовании стороннего поставщика удостоверений, например идентификатора связи или secureAuth, в качестве типа удостоверения следует выбрать "не Microsoft Entra".

Если вы решили принять список ACL из экземпляра Salesforce и выбрали "идентификатор, отличный от ME", для типа удостоверения, см. статью Сопоставление удостоверений, отличных от Microsoft Entra, инструкции по сопоставлению удостоверений.

Если вы решили принять список ACL из экземпляра Salesforce и выбрали "ME-ID" для типа удостоверения, см. статью Сопоставление удостоверений Microsoft Entra для получения инструкций по сопоставлению удостоверений. Сведения о настройке единого входа Microsoft Entra для Salesforce см. в этом руководстве.

Примечание.

Обновления с группами, управляющими разрешениями доступа, синхронизируются только при полном обходе контента. Добавочные обходы не поддерживают обработку обновлений разрешений.

В этом видео вы увидите процесс проверки подлинности в экземпляре Salesforce, синхронизации удостоверений, отличных от Microsoft Entra, с удостоверениями Microsoft Entra и применения соответствующих обрезок безопасности к элементам Salesforce.

Содержимое

Выбор объектов Salesforce и фильтрация данных

Выберите объекты Salesforce, которые соединитель должен сканировать и включать в результаты поиска. Если выбран параметр Контакт, также автоматически выбирается учетная запись.

Примечание.

Если для профиля задана безопасность на уровне полей (FLS), соединитель не будет принимать это поле ни для каких профилей в этой организации Salesforce. В результате пользователи не смогут искать значения для этих полей или отображаться в результатах.

Фильтрация данных

Кроме того, можно отфильтровать содержимое Salesforce, которое индексируется двумя способами:

• Укажите период времени изменения элемента. Этот параметр будет индексировать только содержимое Salesforce, созданное или измененное за период времени, выбранный на последовательной основе , на основе текущего обхода контента.
• Введите запрос Salesforce (SOQL), указав, что вы хотите индексировать с помощью предложения WHERE .

Совет

Предложение WHERE можно оставить пустым, если вы хотите проиндексировать все содержимое конкретной сущности.

Управление свойствами

Здесь можно добавить или удалить доступные свойства из источника данных Salesforce CRM, назначить схему свойству (определить, является ли свойство доступным для поиска, с возможностью запроса, с возможностью извлечения или уточнения), изменить семантическую метку и добавить псевдоним в свойство. Хотя этот шаг не является обязательным, наличие некоторых меток свойств повышает релевантность и обеспечивает лучшие результаты для конечных пользователей. По умолчанию некоторым меткам, таким как "Заголовок", "URL-адрес", "CreatedBy" и "LastModifiedBy", уже назначены свойства источника. Свойства, выбранные по умолчанию, перечислены ниже.

Список свойств, которые вы выбираете здесь, может повлиять на то, как можно фильтровать, искать и просматривать результаты в Microsoft 365 Copilot.

Свойство Source	Label	Описание
авторов	authors	Имя пользователей, которые участвовали в работе над элементом в источнике данных или совместно работали над элементом.
CreatedBy	createdBy	Имя пользователя, создавшего элемент в источнике данных.
CreatedDate	createdDateTime	Дата и время создания элемента в источнике данных.
Url	url	Целевой URL-адрес элемента в источнике данных.
LastModifiedBy	lastModifiedBy	Имя пользователя, который последним изменил элемент в источнике данных.
LastModifiedDateTime	lastModifiedDateTime	Дата и время последнего изменения элемента в источнике данных.
Имя	title	Заголовок элемента, который вы хотите отобразить в поиске и других интерфейсах.

Предварительный просмотр данных

Используйте кнопку предварительного просмотра результатов, чтобы проверить образцы значений выбранных свойств и фильтра запросов.

Синхронизация

Интервал обновления определяет частоту синхронизации данных между источником данных и индексом соединителя Graph. Существует два типа интервалов обновления: полный обход контента и добавочный обход контента. Дополнительные сведения см. в разделе Параметры обновления.

При необходимости можно изменить значения интервала обновления по умолчанию.

Совет

Тип результата по умолчанию

• Соединитель Salesforce автоматически регистрирует тип результата после публикации соединителя. Тип результата использует динамически создаваемый макет результата на основе полей, выбранных на шаге 3.
• Вы можете управлять типом результата, перейдя к элементу Типы результатов в Центр администрирования Microsoft 365. Тип результата по умолчанию называется "ConnectionIdDefault". Например, если идентификатор подключения — Salesforce, макет результата будет называться SalesforceDefault.
• Кроме того, при необходимости можно создать собственный тип результата.

Устранение неполадок

После публикации подключения можно просмотреть состояние на вкладке Источники данных в Центре администрирования. Сведения об обновлении и удалении см. в статье Управление соединителем.

Инструкции по устранению распространенных проблем можно найти здесь.

Если у вас возникли проблемы или вы хотите отправить отзыв, обратитесь в Microsoft Graph | Поддержка.