本頁說明如何與 Microsoft Dynamics 整合。整合完成後，服務專員可以直接在 Microsoft Dynamics 資訊主頁接聽電話和處理即時通訊。
Microsoft Dynamics 整合檢查清單
以下檢查清單列出設定 Microsoft Dynamics 整合的步驟。
將 UJET 解決方案安裝到您的環境。最新版本為 1.2.0.0。
設定 UJET 解決方案的 IFrameUrl。
檢查網域控管設定。
建立新的 Azure 應用程式註冊
新增平台設定。
設定 API 權限
建立新的憑證和密鑰。
為這個環境設定應用程式使用者
在管理員入口網站中設定值，即可連線至 Microsoft Dynamics 執行個體。
繼續執行選用步驟。
安裝連接器
如要安裝 Contact Center AI Platform 連接器，請按照下列步驟操作：
下載並解壓縮 UJET 解決方案。您可以在這裡找到： UJETConnector_1_2_0_0_managed-dynamics.zip。
在 Microsoft Dynamics 中，依序前往「服務」>「解決方案」。
按一下「匯入」，然後上傳 UJET 解決方案。
找到「UJETConnector」UJETConnector項目，確認已正確安裝。您可以在連接器設定管理員中檢查這項設定。詳情請參閱「設定連結器網址」。
更新或安裝受管理套件
受管理封裝包含連接器。安裝至 Microsoft Dynamics 的連接器可讓服務專員直接在 Microsoft Dynamics 資訊主頁接聽電話和進行即時通訊。
在解決方案管理中更新或安裝連線器
在 Microsoft Dynamics 中，使用右上方的齒輪前往「進階設定」。
在「設定」畫面中，按一下「設定」旁邊的「展開更多」，開啟下拉式選單，然後選取「解決方案」。
結果：在「解決方案管理」清單中，您會看到連結器。
在 Microsoft Dynamics 中更新或安裝 Contact Center AI Platform 連接器
事前準備
您必須獲派管理員使用者身分，並在「解決方案管理」中擁有匯入連結器的權限。
您必須擁有受管理連接器的 ZIP 檔案。例如：
Connector_1_2_0_0_managed.zip.您必須具備 Power Apps 使用者介面。
您必須預留足夠的時間，讓代理程式介面卡停機。建議預留約 10 分鐘。
在 Microsoft Dynamics 中匯入連結器
在「Power Apps」標題中，按一下「匯入」連結。「新增解決方案」窗格隨即顯示。
按一下「瀏覽」，選取要匯入的連結器。
按一下 [匯入]。系統應會顯示要匯入的連接器套件詳細資料。如果詳細資料正確無誤，請繼續下一個步驟。 如果不是，請確認選取的檔案是否正確。
點選「下一步」。
按照步驟完成匯入程序。升級連接器時，不需要任何特定選項。
安裝完成後，請重新整理代理程式頁面，顯示更新後的連接器。
結果：連接器已安裝完成，隨時可供使用。
設定連接器網址
安裝 v1_2_0_0 版套件後，整合器系統建構工具即可存取新應用程式。
在搜尋列中找到「UJET Connector Settings Manager」，然後按一下「Play」。這會將您帶往應用程式，並顯示可存取 UJET 設定表格的檢視畫面，其中包含 iframe 介面的設定。
如果是新安裝的應用程式，則必須在設定表格中新增項目。按一下「新增」，新增 IFrameUrl 設定。
系統會開啟新頁面，讓你新增 IFrameUrl。系統會顯示兩個欄位：「名稱」和「值」。使用下列範例值來協助設定：
名稱：IFrameUrl
值：
https://<tenant_subdomain>.<environment_domain>
按一下 [儲存]。設定表格中會顯示新的項目。IFrameUrl 設定現已完成。
為代理程式介面卡新增網域式存取控管機制
網域存取權控管機制可維護安全性，同時允許您定義及控管哪些網域可顯示代理程式介面卡。
您可以透過網域存取權控管，定義及控管哪些網域可以顯示 Agent Adapter。這是重要的導入步驟。請務必按照相關指南，在開發人員設定中新增所有必要網域。否則可能會導致轉接頭損壞。
如有任何問題或需要導入方面的協助，請與支援團隊聯絡。
在開發人員設定中新增網域
如要在開發人員設定中新增網域，請按照下列步驟操作：
在 CCAI Platform 入口網站中，依序點選「Settings」>「Developer Settings」。 如果沒有看到「設定」選單，請按一下「選單」圖示 。
前往「Agent Adapter - Domain Based Access Control」(代理程式介面卡 - 網域型存取權控管)
請逐行輸入網域，格式為
*.domain，例如*.mycompany.com。
指定網域
指定執行個體網域的格式可以是任何有效的網域名稱，也可以包含萬用字元 (*)，比對任意數量的子網域。萬用字元必須放在網域開頭，且會比對任何子網域。此外，使用者也可以使用 <protocol>://<domain>:<port> 語法指定通訊協定和通訊埠。
通訊埠可以是萬用字元，但通訊協定不能是萬用字元。如果指定通訊協定，則只會比對該通訊協定，其他通訊協定都無法顯示介面卡。舉例來說，https://some.example.domain.com 不會與 http://some.example.domain.com 或 mail://some.example.domain.com 相符。
CRM 專屬網域
輸入 CRM 網域時，請使用下列網域命名慣例。
Salesforce：*.visualforce.com *.force.com *.salesforce.com
Zendesk：*.zdusercontent.com *.zendesk.com
Microsoft Dynamics：*.crm.dynamics.com
Kustomer：*.kustomerapp.com
在轉接程式上重新載入影格
管理員變更設定後，如果服務專員看不到服務專員介面卡，必須對服務專員介面卡按一下滑鼠右鍵，然後點選「重新載入框架」。
Azure 應用程式註冊 (OAuth 用戶端)
在 Azure 中建立新的應用程式註冊
依序前往「Azure Active Directory」>「App registrations」>「New application registration」。「Register an application」(註冊應用程式) 頁面隨即顯示。
填寫必填欄位：
在「Name」(名稱) 欄位中，輸入不含
https://的環境網址。例如：yourcompany.domain.co.在「支援的帳戶類型」部分，按一下「僅限組織目錄中的帳戶」。
按一下「Register」。應用程式現已註冊。
驗證設定
新增平台設定
如要在 Microsoft Dynamics 中新增平台設定，請按照下列步驟操作：
建立已註冊的應用程式後，請前往「驗證」，並在「重新導向 URI」欄位中輸入回呼網址，例如
https://yourcompany.domain.co/v1/dynamics/oauth_callback。勾選「ID 權杖」核取方塊。
建立新憑證和密鑰
如要在 Microsoft Dynamics 中建立新憑證和密鑰，請按照下列步驟操作：
前往「Certificates & secrets」(憑證和密鑰)，在「Add a client secret」(新增用戶端密鑰) 面板中建立新金鑰：
在「Description」(說明) 欄位輸入說明，例如「API 金鑰」。
在「到期」部分中，按一下安全性團隊允許的最長期限。
注意：達到有效期限後，必須重新產生這個權杖。
按一下「新增」。
新增 API 權限
如要在 Microsoft Dynamics 中新增 API 權限，請按照下列步驟操作：
前往「管理」>「API 權限」，然後按一下「新增權限」。
按一下「Dynamics CRM」。
按一下「委派的權限」。
勾選 user_permission 方塊。
在「API permissions」中，再次按一下「Add a permission」。
按一下「Microsoft Graph」。
按一下「應用程式權限」。
新增 Application.ReadWrite.All、Directory.Read.All 和 User.Read.All 權限。
確認已選取「Microsoft Graph」底下的所有權限，包括「User.Read」。
按一下「Grant admin consent for [your organization name]」，然後在隨即顯示的對話方塊中確認。
確認「您的機構名稱」的狀態現在為「已核准」。
在 Contact Center AI 平台入口網站中輸入值
如要在 Contact Center AI Platform 入口網站中輸入值，請按照下列步驟操作：
在 CCAI Platform 入口網站中，依序點選「Settings」>「Developer Settings」。 如果沒有看到「設定」選單，請按一下「選單」圖示 。
捲動至「CRM」>「Agent Platform」。
按一下「Microsoft Dynamics」，然後輸入下列值：
應用程式 ID：應用程式註冊總覽頁面中的應用程式用戶端 ID (Microsoft Dynamics)。
金鑰密碼：建立後必須複製，因為重新整理後就無法再次查看完整密碼。詳情請參閱「驗證設定」。
Active Directory 租戶：應用程式註冊總覽頁面中的目錄 (租戶 ID)。
Microsoft Dynamics 網域 - 輸入環境的網址。您可以在環境總覽頁面找到這項資訊。
注意：請先確認所有欄位都正確無誤，再儲存並繼續操作。
按一下 [儲存]。
為環境設定應用程式使用者
如要在 Microsoft Dynamics 中為環境設定應用程式使用者，請按照下列步驟操作：
選擇環境，然後按一下「設定」。
按一下「應用程式使用者」。
按一下「設定應用程式使用者」。
在「應用程式」欄位中選擇現有應用程式，然後按一下「新增」。
點選「業務單位」欄位，然後點選業務單位。
新增下列安全性角色：
服務讀取者
服務寫入者
點選「建立」。
測試自訂欄位對應
本節以 MyCustomField 為例，逐步說明如何新增及對應自訂欄位。
如要設定自訂欄位對應，請在 Microsoft Dynamics 中按照下列步驟操作：
在解決方案元件中建立新的自訂欄位：
依序前往「銷售」>「設定」>「解決方案」。
在「所有解決方案」頁面頂端，按一下「新增」。
輸入「TestCustomFields」TestCustomFields做為顯示名稱。
按一下「儲存並關閉」。
按一下現有的解決方案元件
依序前往「Components」>「Entities」>「Add Existing」。
按一下「Contact」(聯絡人) 解決方案元件。
按一下「確定」，即可查看聯絡人解決方案元件詳細資料。系統會顯示解決方案元件「系統表單」對話方塊。
按一下要納入解決方案的實體資產。
包含實體中繼資料
新增所有素材資源
以這個範例來說，請按一下「Include entity metadata」(包含實體中繼資料)。
按一下「完成」。
依序前往「元件」>「實體」>「聯絡人」>「欄位」。
點選「New」(新增)。
「名稱」欄位會填入新的欄位名稱。複製欄位名稱，以供稍後使用：
按一下「儲存並關閉」。
編輯表單，顯示自訂欄位
以下範例著重於先前在「在解決方案管理中更新或安裝連接器」中設定的聯絡人解決方案元件。
如要編輯表單以顯示自訂欄位，請在 Microsoft Dynamics 中按照下列步驟操作：
開啟聯絡人，然後按一下「表單」。
開啟「欄位探索工具」，然後依「自訂欄位」篩選。
按兩下「MyCustomField」MyCustomField。
依序點選「儲存」和「發布」，將新欄位新增至表單。
重新整理瀏覽器，確認表單顯示在聯絡人畫面中。
確認表單中是否包含「MyCustomField」MyCustomField。
在「MyCustomField」MyCustomField欄位中輸入識別的值。
按一下 [儲存]。
在 Contact Center AI Platform 入口網站中設定自訂欄位對應
如要在 Contact Center AI Platform 入口網站中設定自訂欄位對應，請按照下列步驟操作：
在 CCAI Platform 入口網站中，依序點選「Settings」>「Developer Settings」。 如果沒有看到「設定」選單，請按一下「選單」圖示 。
前往「自訂欄位對應」，然後按一下方塊。
在「CRM field to use in lookup」(用於查詢的 CRM 欄位) 下方，按一下先前建立的自訂欄位 (new_mycustomfield)。
在自訂案件表單中填入帳戶和客戶欄位
Microsoft Dynamics 預設動作是在建立案件時填寫顧客資訊。更新這項設定後，系統會同時填入案件中的顧客資訊。
在 CCAI Platform 入口網站中，依序點選「Settings」>「Developer Settings」。 如果沒有看到「設定」選單，請按一下「選單」圖示 。
依序前往「CRM」>「帳戶查詢」。
按一下「物件類型」下方的「聯絡人」。
勾選「使用自訂參數比對」核取方塊。
切換物件類型時，系統會清除表格，除非您已儲存欄位。 這樣一來，系統就能同時更新案件物件的「聯絡人」欄位，以及與聯絡人相關聯的帳戶 (如有) 的「客戶」欄位。
勾選「使用自訂參數比對」核取方塊，且「參數設定」有效時，系統會更新 CRM 待處理事項，否則會還原為預設邏輯來更新 CRM。如果所有參數都設定正確，系統就會更新所有參數。如果任何參數設定有誤，系統只會更新設定正確的參數。
測試 USER 區隔 DAP
如要測試 DAP，請按照下列步驟操作：
在 CCAI Platform 入口網站中，依序點選「Settings」>「Queue」。如果沒有看到「設定」選單，請按一下「選單」圖示 。
選擇偏好的社群管道
在「設定」面板中，前往「存取點」，然後按一下要更新的存取點旁邊的「編輯」圖示。
在「客戶關係管理自訂使用者區隔欄位」中，輸入客戶關係管理系統中包含使用者區隔資訊的欄位名稱，例如
new_mycustomfield。