共用方式為

自訂行動應用程式的即時聊天小工具

您有兩個選項可將訊息整合到原生行動應用程式中：

  • 使用適用於 iOS 和 Android 的原生行動軟體開發套件 （SDK）
  • 在 WebView 中使用 Web 小工具

我們強烈建議您使用原生行動 SDK，因為它們提供卓越的功能支援和效能。

與 Dynamics 365 Contact Center 行動 SDK 整合

行動 SDK 及其文件託管在 GitHub 上：

SDK 包含：

  • 幫助您入門的範例應用程式
  • 可設定的開箱即用訊息介面
  • 一整套訊息生命週期功能，可整合自訂的訊息 UI（如有需要）
  • 支援 Azure 通知中樞的推播通知

建議您搭配傳訊 SDK 使用經過驗證的持續聊天。 這為行動使用模式提供了最佳的客戶體驗。

備註

現成可用的介面會透過應用程式中的程式碼來視覺化樣式化，而不是透過系統管理中心。

使用內嵌程式碼轉譯即時聊天小工具

如果行動傳訊 SDK 不符合您的需求或時間表，您可以在行動應用程式中內嵌網頁小工具。 然而，嵌入聊天小部件代碼有許多限制，例如性能下降、移動可用性有限和功能不可用。

A WebView 是一種嵌入式瀏覽器，可讓原生應用程式顯示 Web 內容。 使用 WebView 行動作業系統語言的元件，在行動裝置上啟用聊天小工具的網頁版本轉譯。 WebView 功能在 Android 和 iOS 上均提供。

下列範例程式碼會在行動應用程式中轉譯聊天小工具。

var html: String = """
        <html>
            <head>
                <meta http-equiv="no-cache">
                <meta http-equiv="Expires" content="-1">
                <meta http-equiv="Cache-Control" content="no-cache">
                <script 
                    type="text/javascript"
                    src = "Use src from widget code snippet"
                    id = Microsoft_Omnichannel_LCWidget
                    data-app-id = "Use data-app-Id from widget code snippet"
                    data-org-id = "Use data-org-Id from widget code snippet"
                    data-org-url = "Use data-org-url from widget code snippet"
                    data-render-mobile = "true"
                    data-hide-chat-button = "true"
                    data-color-override = "desired color code eg. #008577">
                </script>
            </head>
            <body>
            </body>
        </html>
    """.trimIndent()
    var baseUrl: String = "Get baseUrl from data-org-url eg. https://oc-cdn-ocprod.azureedge.net"
    chatWebView.loadDataWithBaseURL(baseUrl,html, "text/html", null, baseUrl)

聊天小工具使用本機儲存來管理其狀態。 若要讓聊天小工具存取 Android 上的本機存儲，您需要在本機程式碼中設定權限。

chatWebView = findViewById(R.id.webview)
webSettings = webView.getSettings();
webSettings.setDomStorageEnabled(true);

您可以使用資料標籤 （例如 data-hide-chat-button 和 data-render-mobile） 以及即時聊天小工具用戶端 SDK 提供的一些 API 和事件，來最佳化行動 Web 體驗的聊天小工具轉譯。 其他資訊： 使用資料標籤自訂聊天小工具

若要開啟聊天會話，您可以在選取新的聊天按鈕時呼叫 startChat 方法。

chatWebView.evaluateJavascript(
    "Microsoft.Omnichannel.LiveChatWidget.SDK.closeChat();",
    null
)

您可以使用 data-render-mobile 資料標籤來最佳化行動裝置上即時聊天小工具的呈現。 例如，它隱藏了聊天小部件的標題。 除了標題之外， 關閉 （X） 按鈕也會消失。 要關閉聊天，您必須在移動應用程序中創建一個“結束聊天”按鈕，並在點擊事件上調用 closeChat 方法。

chatWebView.evaluateJavascript(
    "Microsoft.Omnichannel.LiveChatWidget.SDK.closeChat();", null)

上述程式碼涵蓋行動應用程式使用者結束聊天的案例。 不過，在另一個案例中，客服專員結束交談，您可以監聽 lcw：threadUpdate 事件，並呼叫 closeChat 方法，從用戶端結束交談，如下列程式碼所示。

chatWebView.evaluateJavascript(
    "window.addEventListener(\"lcw:threadUpdate\", function(){Microsoft.Omnichannel.LiveChatWidget.SDK.closeChat();})", null)

當聊天關閉時，即時聊天小工具會觸發 lcw：closeChat 事件。 您可以監聽此事件，並視需要執行任何聊天後步驟。

備註

即時聊天小工具功能 （例如升級為語音和視訊，以及下載聊天記錄） 不支援透過 Web 檢視。

即時聊天 SDK 參考
開發自定義實時聊天小部件
開始聊天
關閉聊天
lcw：chat已擷取
lcw：聊天佇列
使用資料標籤自訂即時聊天小工具

  • Last updated on