Benutzerdefinierten Kontext während des Live-Chats senden

Der benutzerdefinierte Kontext ist eine Sammlung von Schlüssel- oder Wertpaaren. Für jeden Schlüssel sind nur primitive Werte zulässig. Die Schlüssel müssen Kontextvariablen entsprechen, die für den zugeordneten Workstream erstellt werden. Wenn unter dem Live-Workstream keine Kontextvariablen mit einem übereinstimmenden logischen Namen erstellt wurden, werden Variablen zur Laufzeit mit dem Typ String erstellt. Der benutzerdefinierte Kontextanbieter wird vom Live-Chat-Widget aufgerufen, wenn ein neuer Chat gestartet wird. Da bei den Werten zwischen Groß- und Kleinschreibung unterschieden wird, verwenden Sie exact match, um sie an die Kontextvariablen zu übergeben. Weitere Informationen: Überlegungen zu Kontextvariablen

Wenn ein Kunde einen Chat über das Portal startet, können Sie benutzerdefinierten Kontext an Omnichannel for Customer Service übergeben. Dieser benutzerdefinierte Kontext kann verwendet werden, um Informationen auf der Benutzeroberfläche anzuzeigen und Routingregeln zu erstellen, die schließlich die Warteschlange bestimmen, an die Sie die Chats weiterleiten müssen.

Führen Sie die folgenden Schritte aus, um benutzerdefinierten Kontext zu senden, wenn Sie einen Chat starten:

1. Die Livechat-SDK-Methoden sollten aufgerufen werden, nachdem das lcw:ready-Ereignisereignis ausgelöst wurde. Sie können auf dieses Ereignis lauschen, indem Sie dem window-Objekt einen eigenen Ereignis-Listener hinzufügen.
2. Nachdem das lcw:ready Ereignis ausgelöst wurde, registrieren Sie einen benutzerdefinierten Kontextanbieter mit der setContextProvider-Methode beim Livechat.
3. Starten Sie den Chat mit der startChat-Methode .

Beispielcode

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 Anzeigen des benutzerdefinierten Kontexts.

Verwandte Informationen

setContextProvider
getContextProvider
removeContextProvider
JavaScript-API-Referenz für das Live-Chat-SDK
Konfigurieren von Kontextvariablen für einen Bot