使用 Dynamics 365 管道整合架構 2.0 進行軟體電話整合的範例程式碼

發行項
12/08/2023

下載 Microsoft Dynamics 365 管道整合架構 2.0 版的軟體電話整合範例。

注意

Internet Explorer 以及沒有 webRTC 支援的瀏覽器不支援此範例程式碼。其他資訊：WebRTC

先決條件

Dynamics 365 Customer Service 全通路
需要有效的 Azure 訂閱，才能將範例應用程式發佈至 Azure。

注意

如果您沒有 Azure 訂閱，則可以建立免費帳戶。

將範例應用程式發佈至 Azure

使用 Visual Studio 2017 開啟解決方案 SampleInteg.sln。
在 方案總管中，以滑鼠右鍵按一下解決方案並建置完整解決方案。
在 方案總管中，以滑鼠右鍵按一下專案 SampleInteg，並選取發佈。
選取開始以啟動發佈精靈。
選擇應用程式服務做為發佈目標。
選取建立新的，然後選取發佈。
提供應用程式名稱。例如，SampleInteg。
提供有效訂閱、資源群組和主控方案詳細資料。
選取建立以建立 Azure 應用程式服務，並儲存應用程式服務 URL 供日後使用。

例如：https://sampleinteg.azurewebsites.net。

建立要與應用程式服務搭配使用的函式

建立 client-voice 函式的範例程式碼。
請參閱 Dynamics 365 測試人員入口網站中與範例軟體電話整合一起封裝之讀我檔案中的函式。
使用 capability-token 函式的範例程式碼。
請參閱 Dynamics 365 測試人員入口網站中與範例軟體電話整合一起封裝之讀我檔案中的函式。

注意

儲存您從上述範例程式碼中取得的 capability-token 函式 URL。例如，URL 是 https://sampleinteg.sample/capability-token。

設定 Dynamics 365 中的範例應用程式

記下儲存所有 Web 資源之 Dynamics 365 組織的基底 URL。對於線上組織，其格式應為 https://<orgname>.crmXX.dynamics.com。例如：https://sampleorg.crm10.dynamics.com
取得 Dynamics 365 管道整合架構解決方案。如需詳細資訊，請參閱取得 Dynamics 365 管道整合架構。

提供矩陣中所示的詳細資料以設定管道提供者。如需詳細資訊，請參閱設定管道提供者。

欄位	Description
名稱	管道提供者的名稱。範例：Contoso
唯一名稱	使用 <首碼>_<名稱> 格式的唯一識別碼。重要：唯一名稱的需求如下：首碼只能是英數字元，而且其長度必須介於 3 到 8 個字元之間。首碼與名稱之間必須有底線
Label	標籤會顯示為 widget 上的標題。範例：Contoso
管道 URL	管道 URL 使用此格式：`<azure_app_service_url>?base=<crm_base_url>` 注意：對於此範例，URL 是 `https://sampleinteg.azurewebsites.net?base=https://sampleorg.crm10.dynamics.com`。
啟用輸入通訊	.是
管道順序	0
API 版本	2.0
信任的網域	可存取管道整合架構 API 的網域 (URL)。
選取管道的整合介面應用程式	用於向專員顯示管道的整合介面應用程式清單。
選取管道的角色	Dynamics 365 中提供的資訊安全角色。注意：如果不指派任何角色，則會向 Dynamics 365 整合介面應用程式所指派的所有使用者顯示管道提供者。

啟動整合介面應用程式以查看左側的通訊 widget。

重要

所有 URL 都必須是 HTTPS。
如果您對 Azure 應用程式或 Dynamics 365 組織使用自我簽署憑證，則某些瀏覽器可能會拒絕連線，且無法載入範例電話。若要解決問題，請在另一個索引標籤中開啟 Azure 應用程式，並接受憑證一次。
確認瀏覽器原則未封鎖麥克風和喇叭存取。

匯入設定資料

下載設定移轉工具。設定移轉工具是做為 NuGet 套件來提供。
啟動設定移轉工具。按兩下資料夾中的 DataMigrationUtility.exe：[your folder]\Tools\ConfigurationMigration\。
在主要畫面中，選取匯入資料，然後選取繼續。
在登入畫面中，提供驗證詳細資料，以連接至您要從中匯入資料的 Dynamics 365 執行個體。如果 Dynamics 365 Server 上有多個組織，並且想要選取您要匯入設定資料的組織，請選取一律顯示可用組織清單核取方塊。選取登入。
如果您有多個組織，而且您選取一律顯示可用組織清單核取方塊，下一個畫面會讓您選擇您想要連線到的組織。選取要連接到的 Dynamics 365 應用程式組織。
提供要匯入的資料檔 (data.zip)。瀏覽至資料檔，並加以選取。選取匯出資料。
只有在您正在匯入的資料包含來源系統的使用者資訊時，這個步驟才適用。在目標系統上，輸入對應使用者資訊。您可以將全部都對應至正在執行匯入程序的使用者，或藉由使用使用者對應檔 (.xml)，對應至個別使用者。如果您選擇後者，您必須指定現有的使用者對應檔或工具可以為您產生它。如果您產生新的檔案，請在新增參數中針對來源伺服器上的每個使用者填入對應的使用者名稱。完成時選取工具中的使用者對應檔，並選取確定。
下一個畫面會顯示記錄的匯入狀態。資料匯入分多個階段完成，先匯入基礎資料，同時將相依資料排入佇列，然後在後續階段中匯入相依資料以處理任何資料相依性或連結。這可確保全新且一致的資料匯入。
選取完成以關閉工具。

另請參閱

取得 Dynamics 365 管道整合架構

共用方式為