Dalintis per

Tiesioginių pokalbių valdiklių tinkinimas programoms mobiliesiems

Turite dvi parinktis, kaip integruoti pranešimus į savo vietinę programą mobiliesiems:

  • Naudokite vietinius mobiliosios programinės įrangos kūrimo rinkinius (SDK), skirtus "iOS" ir "Android".
  • Žiniatinklio valdiklio naudojimas žiniatinklio rodinyje

Primygtinai rekomenduojame naudoti vietinius mobiliųjų įrenginių SDK, nes jie užtikrina puikų funkcijų palaikymą ir našumą.

Integravimas su "Dynamics 365" kontaktų centro mobiliųjų įrenginių SDK

Mobilieji SDK ir jų dokumentacija talpinami "GitHub":

SDK yra:

  • Programos pavyzdys, padėsiantis pradėti
  • Konfigūruojama, iš anksto paruošta pranešimų sąsaja
  • Visas pranešimų siuntimo ciklo funkcijų rinkinys, skirtas integruoti individualią pranešimų vartotojo sąsają, jei pageidaujama
  • Tiesioginių pranešimų palaikymas naudojant "Azure" pranešimų telkinį

Rekomenduojame naudoti autentifikuotą, nuolatinį pokalbį su pranešimų SDK. Tai užtikrina geriausią klientų patirtį naudojant mobiliuosius įrenginius.

Pastaba.

Paruošta naudoti sąsaja vizualiai sukuriama naudojant kodą jūsų programoje, o ne per administravimo centrą.

Tiesioginio pokalbio valdiklio atvaizdavimas naudojant įterptąjį kodą

Jei mobiliųjų pranešimų SDK neatitinka jūsų reikalavimų ar laiko planavimo juostų, galite įdėti žiniatinklio valdiklį į programą mobiliesiems. Tačiau pokalbio valdiklio kodo įterpimas turi daug apribojimų, tokių kaip sumažėjęs našumas, ribotas mobiliųjų įrenginių naudojimas ir nepasiekiamos funkcijos.

A WebView yra įterptoji naršyklė, leidžianti vietinei programai rodyti žiniatinklio turinį. Naudokite WebView mobiliosios operacinės sistemos kalbos komponentą, kad įgalintumėte pokalbių valdiklio žiniatinklio versijos atvaizdavimą mobiliuosiuose įrenginiuose. "WebView" galimybė siūloma tiek "Android", tiek "iOS".

Toliau pateiktas kodo pavyzdys atvaizduoja pokalbio valdiklį mobiliojoje programoje.

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)

Pokalbio valdiklis naudoja vietinę saugyklą, kad valdytų savo būseną. Kad pokalbio valdiklis galėtų pasiekti vietinę saugyklą "Android", turite sukonfigūruoti leidimą vietiniame kode.

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

Galite optimizuoti pokalbio valdiklio atvaizdavimą žiniatinklio mobiliesiems naudojimui naudodami duomenų žymes, pvz., data-hide-chat-button ir data-render-mobile, kartu su keliomis API ir įvykiais, kuriuos teikia tiesioginio pokalbio valdiklio kliento SDK. Daugiau informacijos: Pokalbio valdiklio tinkinimas naudojant duomenų žymes

Norėdami atidaryti pokalbio seansą, galite paskambinti į startChat metodą, kai pasirenkamas naujas pokalbio mygtukas.

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

Galite naudoti data-render-mobile duomenų žymą, kad optimizuotumėte tiesioginio pokalbio valdiklio atvaizdavimą mobiliajame telefone. Pavyzdžiui, jis slepia pokalbio valdiklio antraštę. Kartu su antrašte išnyksta ir mygtukas Uždaryti (X). Norėdami uždaryti pokalbį, mobiliojoje programėlėje turite sukurti mygtuką "baigti pokalbį" ir paspaudimo įvykio metu iškviesti closeChat metodą.

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

Ankstesnis kodas apima scenarijų, kai mobiliosios programėlės vartotojas baigia pokalbį. Tačiau kitu atveju, kai agentas baigia pokalbį, galite klausytis įvykio lcw:threadUpdate ir iškviesti closeChat metodą, kad baigtumėte pokalbį iš kliento pusės, kaip parodyta toliau pateiktame kode.

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

Kai pokalbis uždaromas, tiesioginio pokalbio valdiklis suaktyvina įvykį lcw:closeChat . Galite klausytis šio įvykio ir, jei reikia, atlikti bet kokius veiksmus po pokalbio.

Pastaba.

Tiesioginio pokalbio valdiklio funkcijos, pvz., balso ir vaizdo įrašų perkėlimas ir pokalbio stenogramos atsisiuntimas, nepalaikomos naudojant žiniatinklio rodinį.

Tiesioginio pokalbio SDK nuoroda
Kurkite pasirinktinius tiesioginių pokalbių valdiklius
pradėtiPokalbis
uždarytiPokalbis
lcw:chatRetrieved
lcw:chatQueued
Tinkinkite tiesioginio pokalbio valdiklius naudodami duomenų žymas

  • Last updated on