設定Microsoft Dynamics連接器

若要將Microsoft Dynamics連接至知識庫,您必須向NiCE專業服務提供Knowledge Hub所需的配置參數,或在Knowledge Hub中自行Enter。本頁說明如何將Microsoft Dynamics整合與Knowledge Hub配置。設定Microsoft Dynamics需要兩個步驟:

Knowledge Hub 會為您產生並更新 OAuth 權杖。您不需要 Python 或程式碼。您需要從 Microsoft 取得五個值:客戶 ID、租戶 ID、用戶端密碼、執行個體 URL,以及 物件名稱。

按照給定的順序完成每一個任務。

開始之前

請確保您已具備以下項目:

  • 對託管Microsoft Dynamics的租戶的Microsoft Entra管理中心的管理存取權。

  • 您要連接的 Microsoft Dynamics 執行個體的存取權。

  • 存取 NiCE CXone 中的 Knowledge Hub 應用程式。

  • 對應用程式註冊和 OAuth 如何在 Microsoft Entra ID 中運作有基本了解。

在 Microsoft Entra ID 中註冊應用程式

Microsoft 方面的所有內容均由此開始。保留現有的具名錯點註冊。

  1. 登入Microsoft Entra admin center。如果您被重新導向至Azure入口網站,步驟相同。

  2. 瀏覽至 Entra ID > App registrations,然後選取New registration。

  3. Enter 名稱。

  4. 在支援的帳戶類型下,指定可以使用此應用程式的使用者。選取 僅此組織目录中的帳戶(單一租戶) 選項。

  5. 點擊註冊。

  6. 在應用程式的概覽頁面上,複製應用程式(客戶)ID和目录(租戶)ID。您需在Knowledge Hub中的客戶 ID和租戶 ID欄位中輸入這些資料。

設定應用程式的平台設定

新增 Knowledge Hub 重新導向 URL,以便 Microsoft 可以將授權碼傳回至 Knowledge Hub。保留現有的具名錨點 Configure。

  1. 在仍然位於Microsoft Entra admin center時,選取管理 > 驗證(預覽)。

  2. 在Redirect URI 配置標籤頁上,按一下Add Redirect URI。

  3. 在Web 應用程式下,選取Web。

  4. 在Redirect URI欄位中,Enter您所在區域的重新導向URL。請在各區域的重新導向URL中找出您的URL。

  5. 按一下配置。

依區域重新導向URL

重新導向 URL 是 Microsoft 核准 Knowledge Hub 後傳送權杖的位置。它必須與您的 NiCE CXone 系統所執行的區域相符。請在表格中找到您的區域,並確實輸入該 URL。

逐字複製該 URL。多一個空格、少一個斜線,或使用了錯誤地區的 URL,都會在您稍後進行驗證時導致重新導向 uri 不符錯誤。

地區

重新導向 URI
NA1 https://api-na1.niceincontact.com/eai-kh-public-services/config/v1/knowledgehub/oauth/callback
NA2 https://api-na2.niceincontact.com/eai-kh-public-services/config/v1/knowledgehub/oauth/callback
CA1 https://api-ca1.niceincontact.com/eai-kh-public-services/config/v1/knowledgehub/oauth/callback
AU1 https://api-au1.niceincontact.com/eai-kh-public-services/config/v1/knowledgehub/oauth/callback
AU2 https://api-au2.nicecxone-sov1.au/eai-kh-public-services/config/v1/knowledgehub/oauth/callback
DE 和 EU1 https://api-eu1.niceincontact.com/eai-kh-public-services/config/v1/knowledgehub/oauth/callback
UK1 https://api-uk1.niceincontact.com/eai-kh-public-services/config/v1/knowledgehub/oauth/callback
UK2 hhttps://api-uk2.nicecxone-sov1.uk/eai-kh-public-services/config/v1/knowledgehub/oauth/callback
JP1 https://api-jp1.niceincontact.com/eai-kh-public-services/config/v1/knowledgehub/oauth/callback

建立用戶端密碼

  1. 在仍然位於 Microsoft Entra admin center 的情況下,選取 Certificates & secrets > Client secrets > New client secret。

  2. 為您的用戶端密碼新增描述。

  3. 為機密選取到期時間,或指定自訂的有效期限。

    • 有效期最長可達 24 個月。

    • Microsoft 建議有效期小於12月。

  4. 選擇新增。

  5. 複製機密值,並妥善保存以便隨時取用。您在 Knowledge Hub 的 用戶端密碼 欄位中輸入該密碼。您不需要 機密 ID。

Microsoft 僅顯示一次機密值。。如果您遺失該值,或該值過期時,請建立新的用戶端密碼,並在Knowledge Hub中重新驗證。請記下到期日,以便及時更新。

新增 API 權限

然後,將 API 權限新增至應用程式註冊。

  1. 在仍然位於Microsoft Entra 管理中心時,選取 管理 > API 權限。

  2. 按一下新增權限。

  3. 您需要以下權限:

    • Dynamics CRM 權限,並具有搜尋 user _impersonation。

    • Microsoft Graph 權限,委派權限。

取得您Microsoft Dynamics應用程式的執行個體值

  1. 登入 Microsoft Dynamics 365 帶箭頭的框指示導覽至外部網站。。請使用您在註冊應用程式時所使用的憑證。

  2. 按一下Dynamics 365 客戶服務。

  3. 從瀏覽器網址列複製完整的 URL,例如 https://org25634.crm4.dynamics.com。您可在 Knowledge Hub 的 實例 URL 欄位中輸入該網址。Knowledge Hub 僅接受有效的實例 URL。

Microsoft的設定現已完成。rest的工作將在Knowledge Hub中進行。

連接 Microsoft Dynamics 至 Knowledge Hub

驗證完成後,您將無法更改配置。只有在來源建立或同步失敗時,您才可以編輯它們。

  1. 在NiCE CXone中,按一下應用程式選取器Icon of three-by-three grid of white squares on a blue background,然後選取 一般 > AI Studio > Knowledge Hub.

  2. 從知識來源下拉式選單中選擇MS Dynamics365。
  3. 在相應的欄位中輸入您的Microsoft Dynamics參數。
  4. 按一下頁面右下方的驗證。
  5. 在開放的視窗中登入 Microsoft。如果出現提示,請選擇您用來註冊應用程式的帳戶。

  6. 在請求的權限頁,按一下接受以向Knowledge Hub授予存取權
  7. 請等待Microsoft視窗關閉,並等待驗證已完成訊息出現。
  8. 點擊儲存。
  9. The Source creation started successfully message appears, and the connector status changes to Pending. After five to seven minutes, refresh the page. Manual Sync becomes available.
    • 按一下手動同步Two arrows forming a circle.。
    • 等待同步完成。
    • 一個大知識庫可能需要數小時才能完成同步。您不需要留在該頁等候同步完成。請稍後再回來並重新整理,以查看狀態。

  10. 當同步完成後,狀態會變更為啟用。您的Microsoft Dynamics文章現已於Knowledge Hub中可用。

疑難排解

使用以下表格解決常見的 Microsoft Dynamics 連接器問題。

問題

可能原因 解決方案
無效的用戶端 客戶 ID或用戶端密碼錯誤,或該機密已過期。 請核對應用程式註冊的值。如果機密已過期,請建立新的機密並重新進行驗證。
按一下驗證後出現AADSTS錯誤 租戶 ID或執行個體 URL錯誤。 使用應用程式概覽頁中的目錄 (租戶) ID以及完整的instance URL。
URI 不匹配 Microsoft Entra ID 中的重新導向 URL 與您的區域不符。 請將Microsoft Dynamics中的URL與按地區劃分的重新導向URL進行比較,兩者必須逐字元完全相符。
Knowledge Hub 不接受執行個體URL 該URL不是有效的instance URL。 請輸入完整的URL,例如:https://org25634.crm4.dynamics.com。