共用方式為

Salesforce CRM Microsoft Graph 連接器

  • 發行項

Salesforce Microsoft Graph 連接器可讓您的組織為 Salesforce 實例中的聯繫人、商機、潛在客戶、案例和帳戶對象編製索引。 從 Salesforce 設定連接器和索引內容之後，使用者可以從任何Microsoft搜尋和 Microsoft 365 Copilot 用戶端搜尋這些專案。

本文適用於Microsoft 365 名系統管理員或設定、執行及監視 Salesforce CRM Microsoft Graph 連接器的任何人。

重要事項

Salesforce Microsoft Graph 連接器目前支援[19 年] 或更新版本。

功能

  • 索引 Salesforce 實例中的聯繫人、商機、潛在客戶、案例和帳戶物件
  • 篩選您想要編製索引的內容基礎
  • 使用語意搜尋的功能存取 Salesforce CRM 數據
  • 保留您組織定義的 ACL
  • 自訂您的編目頻率
  • 使用此連線和來自 Microsoft Copilot Studio 的外掛程式來建立代理程式和工作流程

限制

  • Salesforce Microsoft Graph 連接器目前不支援使用 Salesforce 中個人群組的 Apex 型、領域型共用和共用。
  • 連接器使用的 Salesforce API 中有一個已知的錯誤，其中目前不接受潛在客戶的全私人組織預設值。
  • 如果欄位已針對配置檔設定欄位層級安全性 (FLS) ，連接器將不會針對該 Salesforce 組織中的任何設定檔內嵌該欄位。因此，使用者將無法搜尋這些欄位的值或顯示在結果中。
  • 在 [管理架構] 畫面中，這些常見的標準屬性名稱會列出一次，選項為 [查詢]、[ 搜尋]、[擷 取] 和 [ 精簡]，並套用至全部或無。
    • 名稱
    • URL
    • 描述
    • 傳真
    • Phone
    • MobilePhone
    • 電子郵件
    • 類型
    • 標題
    • AccountId
    • AccountName
    • AccountUrl
    • AccountOwner
    • AccountOwnerUrl
    • 擁有者
    • OwnerUrl
    • CreatedBy
    • CreatedByUrl
    • LastModifiedBy
    • LastModifiedByUrl
    • LastModifiedDate
    • ObjectName

必要條件

若要連線到您的 Salesforce 實例，您需要您的 Salesforce 實例 URL、用戶端識別符，以及 OAuth 驗證的客戶端密碼。 下列步驟說明您或 Salesforce 系統管理員如何從您的 Salesforce 帳戶取得此資訊：

  • 登入您的 Salesforce 實例並移至安裝程式

  • 流覽至 [應用程式 -> 應用程式管理員]。

  • 選 取 [新增已連線的應用程式]。

  • 完成 API 區段，如下所示：

    • 選取 [ 啟用 Oauth 設定] 的複選框。

    • 針對 M365 Government，將回呼 URL 指定為：針對 M365 企業版：https://gcs.office.com/v1.0/admin/oauth/callback。https://gcsgcc.office.com/v1.0/admin/oauth/callback

    • 選取這些必要的 OAuth 範圍。

      • 存取和管理數據 (API) 。

      • (refresh_token、offline_access) ，隨時代表您執行要求。

    • 選取 [ 需要 Web 伺服器流程的秘密] 複選框。

    • 儲存應用程式。

      在系統管理員輸入上述所有必要設定之後，Salesforce 實例中的 API 區段。

  • 複製取用者金鑰和取用者秘密。 當您在 Microsoft 365 管理入口網站中設定 Salesforce Microsoft Graph 連接器的連線設定時，會使用此資訊作為用戶端識別碼和客戶端密碼。

    系統管理員提交所有必要設定之後，Salesforce 實例中 API 區段所傳回的結果。取用者金鑰位於左側資料行的頂端，而取用者密碼位於右側數據行的頂端。

  • 關閉 Salesforce 實例之前，請遵循下列步驟以確保重新整理令牌不會過期：

    • 移至 [應用程式 -> 應用程式管理員]。
    • 尋找您建立的應用程式，然後選取右側的下拉式清單。 選取 [管理]。
    • 選取 [編輯原則]。
    • 針對重新整理令牌原則，選取 [ 重新整理令牌有效，直到撤銷為止]。

    選取名為「重新整理令牌在撤銷之前有效」的重新整理令牌原則。

您現在可以使用 Microsoft 365 系統管理 中心來完成 Microsoft Graph 連接器的其餘安裝程式。

開始使用

顯示 Microsoft Graph Connector for Salesforce CRM 連線建立畫面的螢幕快照。

1.顯示名稱

顯示名稱可用來識別 Copilot 中的每個參考，協助使用者輕鬆辨識相關聯的檔案或專案。 顯示名稱也代表受信任的內容。 顯示名稱也會當做 內容來源篩選條件使用。 此欄位有預設值，但您可以將它自定義為組織中用戶可辨識的名稱。

2.Salesforce CRM URL

針對實例 URL，請使用 https://[domain].my.salesforce.com，其中網域會是貴組織的 Salesforce 網域。

3.驗證類型

若要從 Salesforce CRM 驗證和同步處理內容，請選擇 [OAuth 2.0]。 輸入您從 Salesforce 實例取得的用戶端識別碼和用戶端密碼，然後選取 [授權]。

第一次嘗試使用這些設定登入時，您會收到一個彈出視窗，要求您使用系統管理員使用者名稱和密碼登入 Salesforce。 下列螢幕快照顯示彈出視窗。 輸入您的認證，然後選取 [登入]。

登入彈出視窗，要求使用者名稱和密碼。

注意事項

  • 如果彈出視窗未出現，它可能會在瀏覽器中遭到封鎖，因此您必須允許彈出視窗和重新導向。
  • 確定用來登入 Graph 連接器的 Salesforce 帳戶與已登入 Salesforce 的使用者相同。
  • 請確定登入的使用者具有組織的所有必要物件許可權。

尋找顯示正確認證的綠色刻度，檢查連線是否成功，如下列螢幕快照所示。

成功登入的螢幕快照。顯示「連線成功」的綠色橫幅位於 Salesforce 實例 URL 的 欄位下

4.向有限的物件推出

如果您想要先在 Copilot 和其他搜尋介面中驗證此連線，再將推出擴充至更廣泛的物件，請將此連線部署至有限的使用者基底。 若要深入瞭解有限的推出，請參閱 分段推出。

此時，您已準備好建立 Salesforce CRM 的連線。 您可以按兩下 [建立] ，從 Salesforce 實例發佈連線和索引內容。

對於其他設定，例如 訪問許可權、 數據包含規則、 架構、 編目頻率等，我們會根據最適合 Jira 資料的設定來設定預設值。 您可以在下方看到預設值：

使用者 描述
訪問許可權 只有具有數據源中內容存取權的人員。
對應身分識別 使用 Microsoft Entra標識碼對應的數據源身分識別。
內容 描述
Salesforce 物件 所有物件都會編製索引。
篩選數據 所有物件都會編製索引。 未套用時間篩選或 SOQL 準則。
管理屬性 若要檢查預設屬性及其架構，請參閱 內容。
同步處理 描述
累加編目 頻率：每 15 分鐘
完整編目 頻率：每天

如果您想要編輯其中任何一個值，您必須選擇 [自訂安裝] 選項。

自訂安裝程式

自訂設定適用於想要編輯上表所列設定之預設值的系統管理員。 按兩下 [自定義安裝] 選項之後，您會看到另外三個索引標籤 - [使用者]、[內容] 和 [同步]。

使用者

顯示 [使用者] 索引標籤標的螢幕快照，您可以在其中設定訪問許可權和使用者對應規則。

訪問許可權

Salesforce CRM 連接器支援 所有人 或 只有具有此數據源存取權的人員可以看見的搜尋許可權。 如果您選擇 [ 所有人]，已編製索引的數據會出現在所有使用者的搜尋結果中。 如果您選擇 [僅限可存取此數據源的人員]，則已編製索引的數據會出現在可存取此數據源之使用者的搜尋結果中。 選擇最適合您組織的工具。

對應身分識別

您可以選擇從 Salesforce 實例擷取 存取控制 清單 (ACL) ，或允許組織中的每個人查看此數據源的搜尋結果。 ACL 可以包含 Microsoft Entra 身分識別， (從 Microsoft Entra ID 同盟到 Salesforce) 的使用者、非 Azure AD 身分識別 (在 Microsoft Entra ID) 中具有對應身分識別的原生 Salesforce 使用者，或兩者。

注意事項

如果您使用第三方識別提供者，例如 Ping 識別碼或 secureAuth，您應該選取 [非 Microsoft Entra] 作為身分識別類型。

如果您選擇從 Salesforce 實例擷取 ACL，並針對身分識別類型選取 [非 ME 標識符]，請參閱對應您的非 Microsoft Entra 身分識別以取得對應身分識別的指示。

如果您選擇從 Salesforce 實例擷取 ACL，並針對身分識別類型選取 [ME-ID]，請參閱對應您的 Microsoft Entra 身分識別以取得對應身分識別的指示。 若要瞭解如何設定 Microsoft Entra SSO for Salesforce，請參閱本教學課程。

注意事項

匯報 管理訪問許可權的群組只會以完整編目同步處理。 累加編目不支援處理許可權的更新。

在這段影片中，您可以看到向 Salesforce 實例進行驗證、將非 Microsoft Entra 身分識別同步至 Microsoft Entra 身分識別，以及將適當的安全性調整套用至 Salesforce 專案的程式。

內容

選擇 Salesforce 物件並篩選數據

選取您要連接器編目並包含在搜尋結果中的 Salesforce 物件。 如果選取 [聯繫人]，也會自動選取 [帳戶]。

注意事項

如果欄位已針對配置檔設定欄位層級安全性 (FLS) ，連接器將不會針對該 Salesforce 組織中的任何設定檔內嵌該欄位。因此，使用者將無法搜尋這些欄位的值或顯示在結果中。

篩選數據

您可以進一步選擇以兩種方式篩選編制索引的 Salesforce 內容：

  • 指定專案 修改的時間週期。 此選項只會根據目前的編目，在以 滾動為基礎 選取的期間內建立或修改的 Salesforce 內容編製索引。
  • 輸入 Salesforce 查詢 (SOQL) 使用 WHERE 子句指定要編制索引 的專案 。

Salesforce 連接器中篩選選項的螢幕快照

提示

如果您想要為特定實體的所有內容編製索引，您可以將 WHERE 子句保留空白

管理屬性

在這裡，您可以從 Salesforce CRM 數據源新增或移除可用的屬性、將架構指派給屬性， (定義屬性是否可搜尋、可查詢、可擷取或可精簡) 、變更語意標籤，並將別名新增至 屬性。 雖然此步驟並非必要，但擁有某些屬性標籤可改善相關性，並確保用戶獲得更好的結果。 根據預設，某些標籤如「標題」、「URL」、「CreatedBy」和「LastModifiedBy」已指派來源屬性。 以下列出預設選取的屬性。

您在此處選取的屬性清單，可能會影響您在 Microsoft 365 Copilot 中篩選、搜尋及檢視結果的方式。

Source 屬性 Label 描述
Authors authors 參與/共同作業數據源中項目的人員名稱。
CreatedBy createdBy 在數據源中建立項目的人員名稱。
CreatedDate createdDateTime 在數據源中建立專案的日期和時間。
URL url 數據源中項目的目標 URL。
LastModifiedBy lastModifiedBy 最近編輯數據源中專案之人員的名稱。
LastModifiedDateTime lastModifiedDateTime 上次在數據源中修改專案的日期和時間。
名稱 title 您想要在搜尋和其他體驗中顯示的項目標題。

預覽數據

使用 [預覽結果] 按鈕來驗證所選屬性和查詢篩選的範例值。

同步處理

顯示 [同步] 索引標籤的螢幕快照，您可以在其中設定編目頻率。

重新整理間隔會決定數據源與 Graph 連接器索引之間同步處理資料的頻率。 重新整理間隔有兩種類型 ： 完整編目和累加編目。 如需詳細資訊，請參閱 重新整理設定。

您可以視需要從這裏變更重新整理間隔的預設值。

提示

默認結果類型

  • 一旦發佈連接器，Salesforce 連接器就會自動註冊 結果類型 。 結果類型會根據步驟 3 中選取的欄位，使用動態產生 的結果配置 。
  • 您可以瀏覽至 Microsoft 365 系統管理中心 中的結果類型來管理結果類型。 默認結果類型命名為 「ConnectionIdDefault」。 例如，如果您的連線標識碼是 Salesforce，則結果配置會命名為：“SalesforceDefault”。
  • 此外，您可以視需要選擇建立自己的結果類型。

疑難排解

發佈連線之後，您可以在系統管理中心的 [數據源] 索引卷標下檢閱狀態。 若要瞭解如何進行更新和刪除，請參閱 管理您的連接器。

您可以 在這裡找到常見問題的疑難解答步驟。

如果您有問題或想要提供意見反應，請 連絡 Microsoft Graph |支援。