Wysyłanie kontekstu niestandardowego podczas czatu na żywo

Kontekst niestandardowy to kolekcja par kluczy lub wartości. Tylko wartości pierwotne są dozwolone dla dowolnego klucza. Klucze muszą odpowiadać zmiennym kontekstowym, które są tworzone dla skojarzonego strumienia pracy. Jeśli w strumieniu pracy na żywo nie utworzono żadnych zmiennych kontekstowych o pasującej nazwie logicznej, zmienne są tworzone w czasie wykonywania, przyjmując typ Ciąg. Dostawca niestandardowego kontekstu będzie wywoływany przez widżet czatu na żywo po rozpoczęciu nowego czatu. Ponieważ w wartościach jest rozróżniana wielkość liter, użyj dopasowania ścisłego, aby przekazać je do zmiennych kontekstowych. Więcej informacji: Zagadnienia dotyczące zmiennych kontekstowych

Gdy klient rozpoczyna czat z portalu, możesz przekazać niestandardowy kontekst do aplikacji Obsługa wielokanałowa dla Customer Service. Ten niestandardowy kontekst może służyć do wyświetlania informacji w interfejsie użytkownika i tworzenia reguł routingu, które ostatecznie określają kolejkę, do której należy kierować czaty.

Wykonaj następujące kroki, aby wysłać niestandardowy kontekst po rozpoczęciu czatu:

1. Metody zestawu SDK czatu na żywo powinny być wywoływane po wywołaniu zdarzenia lcw:ready . To zdarzenie można wykrywać, dodając własny detektor zdarzeń do obiektu window.
2. Po zgłoszeniu lcw:ready zdarzenia zarejestruj niestandardowego dostawcę kontekstu z czatem na żywo przy użyciu metody setContextProvider .
3. Rozpocznij czat za pomocą metody startChat .

Przykładowy kod

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);
});

Aby uzyskać informacje na temat wyświetlania zmiennych kontekstowych w podsumowaniu konwersacji, zobacz Wyświetlanie kontekstu niestandardowego.

Informacje pokrewne

setContextProvider
getContextProvider (Dostawca Danych)
removeContextProvider (Dostawca UsuńKontekst)
Dokumentacja interfejsu API JavaScript zestawu SDK czatu na żywo
Konfigurowanie zmiennych kontekstowych dla bota