Kongsi melalui

Sesuaikan widget sembang langsung untuk aplikasi mudah alih

Anda mempunyai dua pilihan untuk menyepadukan pemesejan dalam apl mudah alih asli anda:

  • Gunakan kit pembangunan perisian mudah alih (SDK) asli untuk iOS dan Android
  • Gunakan widget web di dalam WebView

Kami amat mengesyorkan agar anda menggunakan SDK mudah alih asli kerana ia memberikan sokongan dan prestasi ciri yang unggul.

Sepadukan dengan SDK mudah alih Dynamics 365 Contact Center

SDK mudah alih dan dokumentasinya dihoskan di GitHub:

SDK mengandungi:

  • Contoh aplikasi untuk membantu anda bermula
  • Antara muka pemesejan di luar kotak yang boleh dikonfigurasikan
  • Set penuh fungsi kitaran hayat pemesejan untuk menyepadukan UI pemesejan yang dipesan lebih dahulu, jika dikehendaki
  • Sokongan untuk pemberitahuan tolak dengan Azure Notification Hub

Kami mengesyorkan agar anda menggunakan sembang yang disahkan dan berterusan dengan SDK pemesejan. Ini memberikan pengalaman pelanggan terbaik untuk corak penggunaan mudah alih.

Nota

Antara muka di luar kotak digayakan secara visual melalui kod dalam aplikasi anda dan bukannya melalui pusat pentadbiran.

Render widget sembang langsung menggunakan kod terbenam

Jika SDK Pemesejan Mudah Alih tidak memenuhi keperluan atau garis masa anda, maka anda boleh membenamkan widget web dalam apl mudah alih anda. Walau bagaimanapun, membenamkan kod widget sembang mempunyai banyak had seperti prestasi yang dikurangkan, kebolehgunaan mudah alih yang terhad dan ciri yang tidak tersedia.

A WebView ialah penyemak imbas terbenam yang membolehkan aplikasi asli memaparkan kandungan web. Gunakan WebView komponen bahasa sistem pengendalian mudah alih anda untuk mendayakan pemaparan versi web widget sembang pada peranti mudah alih. Keupayaan WebView ditawarkan pada kedua-dua Android dan iOS.

Kod sampel berikut memaparkan widget sembang dalam aplikasi mudah alih.

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)

Widget sembang menggunakan storan setempat untuk mengurus keadaannya. Untuk widget sembang mengakses storan tempatan pada Android, anda perlu mengkonfigurasi kebenaran dalam kod asli.

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

Anda boleh mengoptimumkan pemaparan widget sembang untuk pengalaman web mudah alih dengan menggunakan teg data seperti data-hide-chat-button dan data-render-mobile, bersama-sama dengan beberapa API dan acara yang disediakan oleh SDK klien widget sembang langsung. Maklumat lanjut: Sesuaikan widget sembang menggunakan teg data

Untuk membuka sesi sembang, anda boleh memanggil kaedah startChat apabila butang sembang baharu dipilih.

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

Anda boleh menggunakan data-render-mobile tag data untuk mengoptimumkan rendering widget sembang langsung pada mudah alih. Sebagai contoh, ia menyembunyikan pengepala widget sembang. Bersama-sama dengan pengepala, butang Tutup (X) juga hilang. Untuk menutup sembang, anda perlu membuat butang "tamat sembang" dalam aplikasi mudah alih dan memanggil kaedah closeChat pada acara klik.

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

Kod sebelumnya merangkumi senario di mana pengguna aplikasi mudah alih menamatkan sembang. Walau bagaimanapun, dalam senario lain, di mana ejen menamatkan perbualan, anda boleh mendengar peristiwa lcw:threadUpdate dan memanggil kaedah closeChat untuk menamatkan perbualan daripada bahagian klien, seperti yang ditunjukkan dalam kod berikut.

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

Apabila sembang ditutup, widget sembang langsung mencetuskan acara lcw:closeChat . Anda boleh mendengar acara ini dan melakukan sebarang langkah selepas sembang jika perlu.

Nota

Ciri widget sembang langsung seperti meningkatkan kepada suara dan video dan memuat turun transkrip sembang tidak disokong melalui paparan web.

Rujukan SDK sembang langsung
Membangunkan widget sembang langsung tersuai
mulaSembang
tutup sembang
lcw:chatDiperoleh
lcw:chatQueued
Sesuaikan widget sembang langsung menggunakan tag data

  • Last updated on