Prispôsobenie miniaplikácií konverzácie naživo pre mobilné aplikácie

Máte dve možnosti integrácie správ do natívnej mobilnej aplikácie:

  • Používanie natívnych súprav na vývoj mobilného softvéru (SDK) pre iOS a Android
  • Používanie webového widgetu vo WebView

Dôrazne odporúčame používať natívne mobilné súpravy SDK, pretože poskytujú vynikajúcu podporu funkcií a výkon.

Integrácia s mobilnými súpravami SDK kontaktného centra Dynamics 365

Mobilné súpravy SDK a ich dokumentácia sú hosťované na GitHube:

Súpravy SDK obsahujú:

  • Príklad aplikácie, ktorá vám pomôže začať
  • Konfigurovateľné, predpripravené rozhranie na odosielanie správ
  • Kompletná sada funkcií životného cyklu správ na integráciu používateľského rozhrania na mieru
  • Podpora oznámení bez vyžiadania pomocou centra oznámení Azure

Odporúčame vám používať overený trvalý chat so súpravami SDK na odosielanie správ. To poskytuje najlepšiu zákaznícku skúsenosť pre vzory používania mobilných zariadení.

Poznámka

Predpripravené rozhranie je vizuálne štylizované pomocou kódu vo vašej aplikácii namiesto centra spravovania.

Vykreslenie miniaplikácie živého chatu pomocou vloženého kódu

Ak súpravy SDK pre mobilné správy nespĺňajú vaše požiadavky alebo časové harmonogramy, môžete do mobilnej aplikácie vložiť webovú miniaplikáciu. Vloženie kódu miniaplikácie chatu má však mnoho obmedzení, ako je znížený výkon, obmedzená mobilná použiteľnosť a nedostupné funkcie.

A WebView je vložený prehliadač, ktorý umožňuje natívnej aplikácii zobrazovať webový obsah. Použite WebView komponent jazyka vášho mobilného operačného systému na povolenie vykresľovania webovej verzie chatovacieho widgetu na mobilných zariadeniach. Funkcia WebView je ponúkaná v systémoch Android aj iOS.

Nasledujúci vzorový kód vykreslí miniaplikáciu chatu v mobilnej aplikácii.

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)

Miniaplikácia chatu používa na správu svojho stavu lokálne úložisko. Aby miniaplikácia chatu mala prístup k lokálnemu úložisku v systéme Android, musíte nakonfigurovať povolenie v natívnom kóde.

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

Vykresľovanie miniaplikácie chatu pre mobilný web môžete optimalizovať pomocou údajových značiek, ako data-hide-chat-button sú a data-render-mobile, spolu s niekoľkými rozhraniami API a udalosťami, ktoré poskytuje klientska súprava SDK miniaplikácie živého chatu. Ďalšie informácie: Prispôsobenie miniaplikácie chatu pomocou značiek údajov

Ak chcete otvoriť reláciu chatu, môžete zavolať metódu startChat , keď je vybraté nové tlačidlo chatu.

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

Dátovú značku data-render-mobile môžete použiť na optimalizáciu vykresľovania miniaplikácie živého chatu na mobile. Napríklad skryje hlavičku miniaplikácie chatu. Spolu s hlavičkou zmizne aj tlačidlo Zavrieť (X). Ak chcete chat ukončiť, musíte v mobilnej aplikácii vytvoriť tlačidlo "ukončiť chat" a pri kliknutí zavolať metódu closeChat .

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

Predchádzajúci kód sa týka scenára, v ktorom používateľ mobilnej aplikácie ukončí chat. V inom scenári, keď agent ukončí konverzáciu, však môžete počúvať udalosť lcw:threadUpdate a zavolať metódu closeChat na ukončenie konverzácie zo strany klienta, ako je znázornené v nasledujúcom kóde.

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

Keď je chat zatvorený, miniaplikácia živého chatu spustí udalosť lcw:closeChat . Túto udalosť si môžete vypočuť a v prípade potreby vykonať akékoľvek kroky po chate.

Poznámka

Funkcie miniaplikácie živého četu, ako je eskalácia na hlas a video a stiahnutie prepisu chatu, nie sú podporované prostredníctvom webového zobrazenia.

Referenčné informácie o súprave SDK pre živý rozhovor
Vývoj vlastných miniaplikácií živého chatu
Štart Chat
zavrieťChat
lcw:chatRetrieved
lcw:chatQueued
Prispôsobenie miniaplikácií živého chatu pomocou dátových značiek

  • Last updated on