Αποστολή προσαρμοσμένου περιβάλλοντος κατά τη διάρκεια ζωντανής συνομιλίας

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

Σημαντικό

• Για συνομιλία με έλεγχο ταυτότητας, μπορείτε επίσης να μεταβιβάσετε το περιβάλλον στο JSON Web Token (JWT). Μάθετε περισσότερα στο Στείλτε διακριτικά ελέγχου ταυτότητας.
• Μπορείτε να περάσετε μόνο 100 προσαρμοσμένες μεταβλητές περιβάλλοντος κατά τη διάρκεια κάθε συνεδρίας συνομιλίας.

Όταν ένας πελάτης ξεκινά μια συνομιλία από την πύλη, μπορείτε να μεταβιβάσετε προσαρμοσμένο περιβάλλον στο Dynamics 365 Contact Center. Αυτό το προσαρμοσμένο περιβάλλον μπορεί να χρησιμοποιηθεί για την εμφάνιση πληροφοριών στο περιβάλλον εργασίας χρήστη και για τη δημιουργία κανόνων δρομολόγησης που τελικά καθορίζουν την ουρά στην οποία πρέπει να δρομολογήσετε τις συνομιλίες.

Ακολουθήστε αυτά τα βήματα για να στείλετε προσαρμοσμένο περιβάλλον κατά την έναρξη μιας συνομιλίας:

1. Οι μέθοδοι SDK ζωντανής συνομιλίας θα πρέπει να ενεργοποιηθούν μετά την εμφάνιση του συμβάντος lcw:ready . Μπορείτε να ακούσετε αυτό το συμβάν προσθέτοντας το δικό σας πρόγραμμα ακρόασης συμβάντων στο αντικείμενο παραθύρου.
2. Μετά την αύξηση του lcw:ready συμβάντος, καταχωρίστε έναν προσαρμοσμένο πάροχο περιβάλλοντος με ζωντανή συνομιλία χρησιμοποιώντας τη μέθοδο setContextProvider .
3. Ξεκινήστε τη συνομιλία χρησιμοποιώντας τη μέθοδο startChat .

Δείγμα κώδικα

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': 'contextValue1', // string value
			'contextKey2': 12.34, // number value
			'contextKey3': true // boolean value
	};
}

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
	// Handle LiveChat Ready event
	// SDK methods are ready for use now
	// Setting custom context provider to be used with Chat for Dynamics 365
	// The custom context provided by custom context provider can be used for routing the chat to a particular queue
	Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(contextProvider);
	// Starting a new chat
	Microsoft.Omnichannel.LiveChatWidget.SDK.startChat();
});

window.addEventListener("lcw:error", function handleLivechatErrorEvent(errorEvent){
	// Handle LiveChat SDK error event
	console.log(errorEvent);
});

Για πληροφορίες σχετικά με τον τρόπο εμφάνισης των μεταβλητών περιβάλλοντος στη σύνοψη συνομιλίας, ανατρέξτε στο θέμα Εμφάνιση προσαρμοσμένου περιβάλλοντος.

Σχετικές πληροφορίες

setContextProvider
getContextProvider
removeContextProvider
Αναφορά API JavaScript SDK ζωντανής συνομιλίας
Ρύθμιση παραμέτρων μεταβλητών περιβάλλοντος για ένα bot