設定Microsoft Dynamics連接器
若要將Microsoft Dynamics連接至知識庫,您必須向NiCE專業服務提供Knowledge Hub所需的配置參數,或在Knowledge Hub中自行Enter。本頁說明如何將Microsoft Dynamics整合與Knowledge Hub配置。設定Microsoft Dynamics需要兩個步驟:
-
步驟 1:在 Microsoft Entra ID 中註冊應用程式:您註冊一個應用程式,新增 Knowledge Hub 重新導向網址,建立 用戶端密碼,並複製您需要的 客戶 ID 和 租戶 ID。
-
步驟 2:在 Knowledge Hub 中設定連接器:您在 Knowledge Hub 中輸入該等詳細資料,按一下 驗證,然後登入 Microsoft。
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 方面的所有內容均由此開始。保留現有的具名錯點註冊。
-
登入Microsoft Entra admin center。如果您被重新導向至Azure入口網站,步驟相同。
-
瀏覽至 Entra ID > App registrations,然後選取New registration。
-
Enter 名稱。
-
在支援的帳戶類型下,指定可以使用此應用程式的使用者。選取 僅此組織目录中的帳戶(單一租戶) 選項。
-
點擊註冊。
-
在應用程式的概覽頁面上,複製應用程式(客戶)ID和目录(租戶)ID。您需在Knowledge Hub中的客戶 ID和租戶 ID欄位中輸入這些資料。
設定應用程式的平台設定
新增 Knowledge Hub 重新導向 URL,以便 Microsoft 可以將授權碼傳回至 Knowledge Hub。保留現有的具名錨點 Configure。
-
在仍然位於Microsoft Entra admin center時,選取管理 > 驗證(預覽)。
-
在Redirect URI 配置標籤頁上,按一下Add Redirect URI。
-
在Web 應用程式下,選取Web。
-
在Redirect URI欄位中,Enter您所在區域的重新導向URL。請在各區域的重新導向URL中找出您的URL。
-
按一下配置。
依區域重新導向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 |
建立用戶端密碼
-
在仍然位於 Microsoft Entra admin center 的情況下,選取 Certificates & secrets > Client secrets > New client secret。
-
為您的用戶端密碼新增描述。
-
為機密選取到期時間,或指定自訂的有效期限。
-
有效期最長可達 24 個月。
-
Microsoft 建議有效期小於12月。
-
-
選擇新增。
-
複製機密值,並妥善保存以便隨時取用。您在 Knowledge Hub 的 用戶端密碼 欄位中輸入該密碼。您不需要 機密 ID。
Microsoft 僅顯示一次機密值。。如果您遺失該值,或該值過期時,請建立新的用戶端密碼,並在Knowledge Hub中重新驗證。請記下到期日,以便及時更新。
新增 API 權限
然後,將 API 權限新增至應用程式註冊。
-
在仍然位於Microsoft Entra 管理中心時,選取 管理 > API 權限。
-
按一下新增權限。
-
您需要以下權限:
-
Dynamics CRM 權限,並具有搜尋 user _impersonation。
-
Microsoft Graph 權限,委派權限。
-
取得您Microsoft Dynamics應用程式的執行個體值
-
登入 Microsoft Dynamics 365
。請使用您在註冊應用程式時所使用的憑證。 -
按一下Dynamics 365 客戶服務。
-
從瀏覽器網址列複製完整的 URL,例如 https://org25634.crm4.dynamics.com。您可在 Knowledge Hub 的 實例 URL 欄位中輸入該網址。Knowledge Hub 僅接受有效的實例 URL。
Microsoft的設定現已完成。rest的工作將在Knowledge Hub中進行。
連接 Microsoft Dynamics 至 Knowledge Hub
驗證完成後,您將無法更改配置。只有在來源建立或同步失敗時,您才可以編輯它們。
-
在NiCE CXone中,按一下應用程式選取器
,然後選取 一般 > AI Studio > Knowledge Hub. - 從知識來源下拉式選單中選擇MS Dynamics365。
- 在相應的欄位中輸入您的Microsoft Dynamics參數。
- 按一下頁面右下方的驗證。
-
在開放的視窗中登入 Microsoft。如果出現提示,請選擇您用來註冊應用程式的帳戶。
- 在請求的權限頁,按一下接受以向Knowledge Hub授予存取權
- 請等待Microsoft視窗關閉,並等待驗證已完成訊息出現。
- 點擊儲存。
- 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.
- 按一下手動同步
。 - 等待同步完成。
一個大知識庫可能需要數小時才能完成同步。您不需要留在該頁等候同步完成。請稍後再回來並重新整理,以查看狀態。
- 按一下手動同步
- 當同步完成後,狀態會變更為啟用。您的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。 |