Während des Live-Chats benutzerdefinierten Kontext senden
Der benutzerdefinierte Kontext ist eine Sammlung von Schlüssel- oder Wert-Paaren. Nur primitive Werte für einen Schlüssel sind erlaubt. Die Schlüssel müssen Kontextvariablen entsprechen, die für den zugehörigen Workstream erstellt werden. Wenn unter einem Live-Arbeitsstream keine Kontextvariablen mit einem übereinstimmenden logischen Namen erstellt wurden, werden zur Runtime Variablen mit dem Typ Zeichenfolge erstellt. Der benutzerdefinierte Kontextanbieter kann von Livechatwidget ausgelöst werden, sobald ein neuer Chat begonnen wird. Da bei den Werten zwischen Groß- und Kleinschreibung unterschieden wird, achten Sie bei der Übergabe an die Kontextvariablen auf eine genaue Übereinstimmung. Mehr Informationen: Berücksichtigungen für Kontextvariablen
Wichtig
- Der setContextProvider wird nur für nicht authentifizierten Chat unterstützt. Für authentifizierten Chat müssen Sie das JSON Web Token (JWT) verwenden. Weitere Informationen: Authentifizierungstoken senden
- Sie können während jeder Chatsitzung nur 100 benutzerdefinierte Kontextvariablen übergeben.
Wenn ein Kunde einen Chat im Portal beginnt, können Sie benutzerdefinierte Kontext an Omnichannel for Customer Service weiterleiten. Dieser benutzerdefinierte Kontext kann verwendet werden, um Informationen auf der Benutzeroberfläche anzeigen und um Routing-Regeln zu erstellen, die letztendlich die Warteschlange bestimmen, an die Sie die Chats weiterleiten müssen.
Folgen Sie den Anweisungen, um benutzerdefinierten Kontext zu senden, wenn Sie den Chat starten:
- Die SDK Livechatmethoden können ausgelöst werden, nachdem das Ereignis lcw:ready Ereignis ist ausgelöst wurde. Sie können auf dieses Ereignis achten, indem Sie Ihre eigenen Ereignislistener dem Fensterobjekt hinzufügen.
- Nachdem das
lcw:ready
Ereignis gestartet wird, registrieren Sie einen benutzerdefinierten Kontextanbieter mit Livechat mit der Funktionsweise setContextProvider. - Chat starten mithilfe der startChat Methode.
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);
});
Informationen zum Anzeigen der Kontextvariablen in der Unterhaltungszusammenfassung finden Sie unter Benutzerdefinierten Kontext anzeigen.
setContextProvider
getContextProvider
removeContextProvider
Live Chat SDK JavaScript API Referenz
Konfigurieren von Kontextvariablen für einen Bot