Κοινή χρήση μέσω

Προσαρμόστε τα γραφικά στοιχεία ζωντανής συνομιλίας για εφαρμογές για κινητά

Έχετε δύο επιλογές για την ενσωμάτωση μηνυμάτων στην εγγενή εφαρμογή σας για κινητά:

  • Χρήση εγγενών κιτ ανάπτυξης λογισμικού για κινητές συσκευές (SDK) για iOS και Android
  • Χρήση του γραφικού στοιχείου ιστού μέσα σε μια προβολή ιστού

Συνιστούμε ιδιαίτερα να χρησιμοποιήσετε τα εγγενή SDK για κινητές συσκευές, επειδή παρέχουν ανώτερη υποστήριξη δυνατοτήτων και απόδοση.

Ενοποίηση με τα SDK του Dynamics 365 Contact Center για κινητές συσκευές

Τα SDK για κινητές συσκευές και η τεκμηρίωσή τους φιλοξενούνται στο GitHub:

Τα SDK περιέχουν:

  • Ένα παράδειγμα εφαρμογής που θα σας βοηθήσει να ξεκινήσετε
  • Μια διαμορφώσιμη, έτοιμη διεπαφή ανταλλαγής μηνυμάτων
  • Ένα πλήρες σύνολο λειτουργιών κύκλου ζωής ανταλλαγής μηνυμάτων για την ενσωμάτωση ενός εξατομικευμένου περιβάλλοντος εργασίας χρήστη ανταλλαγής μηνυμάτων, εάν είναι επιθυμητό
  • Υποστήριξη για ειδοποιήσεις push με το Κέντρο ειδοποιήσεων Azure

Συνιστούμε να χρησιμοποιείτε μόνιμη συνομιλία με έλεγχο ταυτότητας με τα SDK ανταλλαγής μηνυμάτων. Αυτό παρέχει την καλύτερη εμπειρία πελατών για μοτίβα χρήσης κινητών.

Σημείωμα

Η έτοιμη διεπαφή διαμορφώνεται οπτικά μέσω κώδικα στην εφαρμογή σας αντί μέσω του κέντρου διαχείρισης.

Απόδοση του γραφικού στοιχείου ζωντανής συνομιλίας χρησιμοποιώντας ενσωματωμένο κώδικα

Αν τα SDK ανταλλαγής μηνυμάτων για κινητά δεν πληρούν τις απαιτήσεις ή τα χρονοδιαγράμματά σας, τότε μπορείτε να ενσωματώσετε ένα γραφικό στοιχείο ιστού στην εφαρμογή σας για κινητά. Ωστόσο, η ενσωμάτωση ενός κώδικα widget συνομιλίας έχει πολλούς περιορισμούς, όπως μειωμένη απόδοση, περιορισμένη χρηστικότητα για κινητά και μη διαθέσιμες λειτουργίες.

Το A WebView είναι ένα ενσωματωμένο πρόγραμμα περιήγησης που επιτρέπει σε μια εγγενή εφαρμογή να εμφανίζει περιεχόμενο web. Χρησιμοποιήστε το WebView στοιχείο της γλώσσας του λειτουργικού συστήματος του κινητού σας για να ενεργοποιήσετε την απόδοση της έκδοσης web του γραφικού στοιχείου συνομιλίας σε κινητές συσκευές. Η δυνατότητα 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, μαζί με μερικά API και συμβάντα που παρέχονται από το SDK προγράμματος-πελάτη widget ζωντανής συνομιλίας. Περισσότερες πληροφορίες: Προσαρμογή γραφικού στοιχείου συζήτησης με χρήση ετικετών δεδομένων

Για να ανοίξετε μια συνεδρία συνομιλίας, μπορείτε να καλέσετε τη μέθοδο 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 . Μπορείτε να ακούσετε αυτό το συμβάν και να εκτελέσετε τυχόν βήματα μετά τη συνομιλία, εάν απαιτείται.

Σημείωμα

Οι λειτουργίες widget ζωντανής συνομιλίας, όπως η κλιμάκωση σε φωνή και βίντεο και η λήψη της μεταγραφής συνομιλίας, δεν υποστηρίζονται μέσω προβολής ιστού.

Αναφορά SDK ζωντανής συνομιλίας
Ανάπτυξη προσαρμοσμένων γραφικών στοιχείων ζωντανής συνομιλίας
έναρξηΣυνομιλία
closeChat
lcw:chatRetrieved
lcw:chatQueued
Προσαρμόστε τα γραφικά στοιχεία ζωντανής συζήτησης χρησιμοποιώντας ετικέτες δεδομένων

  • Last updated on