Κοινοποίηση μέσω

setContextProvider

Το Πανκαναλικό για Customer Service προσφέρει δυνατότητες που επεκτείνουν την ισχύ του Dynamics 365 Customer Service Enterprise για να έχουν οι οργανισμοί τη δυνατότητα να συνδεθούν και να επικοινωνήσουν άμεσα με τους πελάτες τους μέσω καναλιών όπως η Live Συνομιλία και το SMS. Απαιτείται μια πρόσθετη άδεια χρήσης για την πρόσβαση στο Πανκαναλικό για Customer Service. Για περισσότερες πληροφορίες δείτε τις σελίδες Επισκόπηση τιμολόγησης Dynamics 365 Customer Service και Πλάνο τιμολόγησης Dynamics 365 Customer Service.

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

Σημαντικό

  • Η μέθοδος setContextProvider υποστηρίζεται μόνο για συνομιλία χωρίς έλεγχο ταυτότητας. Για συνομιλία με έλεγχο ταυτότητας, πρέπει να χρησιμοποιήσετε το JSON Web Token (JWT). Περισσότερες πληροφορίες: Αποστολή διακριτικών ελέγχου ταυτότητας
  • Μπορείτε να περάσετε μόνο 100 προσαρμοσμένες μεταβλητές περιβάλλοντος κατά τη διάρκεια κάθε συνεδρίας συνομιλίας.
  • Οι μέθοδοι SDK ζωντανής συνομιλίας θα πρέπει να ενεργοποιηθούν μετά την εμφάνιση του συμβάντος lcw:ready . Μπορείτε να ακούσετε αυτό το συμβάν προσθέτοντας το δικό σας πρόγραμμα ακρόασης συμβάντων στο αντικείμενο παραθύρου.
  • Δεν χρειάζεται να χρησιμοποιήσετε τη setContextProvider μέθοδο εάν χρησιμοποιείτε το startChat API SDK για να περάσετε το περιβάλλον και να προετοιμάσετε την περίοδο λειτουργίας συνομιλίας.

Σύνταξη

Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(contextProvider);

Παράμετροι

Παράμετρος Type Περιγραφή
contextProvider Λειτουργία Συνάρτηση που, όταν καλείται, επιστρέφει το προσαρμοσμένο περιβάλλον

Τιμή επιστροφής

None

Παράδειγμα

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
        // Set the custom context provider
        // Throws error if contextProvider is not a function
        Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(function contextProvider(){
                   //Here it is assumed that the corresponding work stream would have context variables with logical name of 'contextKey1', 'contextKey2', 'contextKey3'. If no context variable exists with a matching logical name, items are created assuming Type:string               
	               return {
                             'contextKey1': {'value': 'contextValue1', 'isDisplayable': true},
                             'contextKey2': {'value': 12.34, 'isDisplayable': false},
                             'contextKey3': {'value': true}
                   };
        });
});

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

Το isDisplayable χαρακτηριστικό, εάν οριστεί σε true, θα εμφανίσει τα στοιχεία που μεταβιβάστηκαν στην τρίτη καρτέλα του στοιχείου ελέγχου σύνοψης συνομιλίας για μια συνομιλία.

Σημείωμα

Εάν δεν έχουν δημιουργηθεί μεταβλητές περιβάλλοντος στη ζωντανή ροή εργασίας με αντίστοιχο λογικό όνομα, τότε οι μεταβλητές δημιουργούνται κατά το χρόνο εκτέλεσης με τον τύπο Συμβολοσειρά. Περισσότερες πληροφορίες: Μεταβλητές περιβάλλοντος

Εμφάνιση πλήκτρων περιβάλλοντος.

Περάστε την αυτοεξυπηρέτηση του πελάτη ως πλαίσιο

Μπορείτε να μεταβιβάσετε την αυτοεξυπηρέτηση ενός πελάτη ως πλαίσιο στην αρχή μιας συνομιλίας με αυτόν τον πελάτη. Η setContextProvider μέθοδος μεταβιβάζει τις πρόσφατες ενέργειες πελατών ως μέρος του περιβάλλοντος με τύπο αυτοεξυπηρέτησης, για μια νέα συνομιλία μεταξύ του πελάτη και του αντιπροσώπου. Δημιουργείται μια καρτέλα διαδρομής επισκέπτη για κάθε ενέργεια αυτοεξυπηρέτησης.

Ακολουθεί ένα δείγμα κώδικα που δείχνει τον τρόπο χρήσης της setContextProvider μεθόδου.

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){

Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(function contextProvider(){
    return {
            'SelfService': { 'value' : 
                '[ {"msdyn_displaytitle":"Page visited", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350000}, \
                   {"msdyn_displaytitle":"Phrase searched", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350001}, \
                   {"msdyn_displaytitle":"Knowledge article viewed", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350002}, \
                   {"msdyn_displaytitle":"Custom action performed", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350003} \
                 ]'
             }, // Additional context can be added as shown below
                //Here it is assumed that the corresponding work stream would have context variables with logical name of 'contextKey1', 'contextKey2', 'contextKey3'. If no context variable exists with a matching logical name, items are created assuming Type:string
                'contextKey1': {'value': 'contextValue1', 'isDisplayable': true},
                'contextKey2': {'value': 12.34, 'isDisplayable': false},
                'contextKey3': {'value': true}
         };
    });
});

Για το δείγμα δέσμης ενεργειών για την παρακολούθηση ενεργειών αυτοεξυπηρέτησης που μπορούν να συμπεριληφθούν στην πύλη αυτοεξυπηρέτησης, ανατρέξτε στο θέμα Δείγμα κώδικα αυτοεξυπηρέτησης.

Κωδικοί σφάλματος

Το ακόλουθο σφάλμα μπορεί να προκύψει για αυτήν τη μέθοδο.

Κωδικός σφάλματος Μήνυμα σφάλματος
1 Η εκτέλεση της μεθόδου υπηρεσίας παροχής περιβάλλοντος απέτυχε

Αναφορά API JavaScript για SDK ζωντανής συζήτησης
Εμφάνιση προσαρμοσμένου περιβάλλοντος

  • Last updated on