Enviar context personalitzat durant el xat en directe

El context personalitzat és una col·lecció de parells de claus o valors. Només es permeten valors primitius per a qualsevol clau. Les claus han de correspondre a les variables de context que es creen per a la seqüència de treball associada. Si no s'ha creat cap variable de context a la seqüència de treball en directe amb un nom lògic coincident, les variables es creen en temps d'execució assumint el tipus com a String. El proveïdor de context personalitzat seria invocat pel giny de xat en directe quan s'inicia un xat nou. Com que els valors distingeixen entre majúscules i minúscules, utilitzeu la concordança exacta per passar-los a les variables de context. Més informació: Consideracions sobre les variables de context

Important

• Per al xat autenticat, també pots passar context al JSON Web Token (JWT). Obteniu més informació a Enviar testimonis d'autenticació.
• Només podeu passar 100 variables de context personalitzades durant cada sessió de xat.

Quan un client inicia un xat des del portal, podeu passar context personalitzat a l'Omnicanal per al Customer Service. Aquest context personalitzat es pot utilitzar per mostrar informació a la interfície d'usuari i per crear regles d'encaminament que finalment determinin la cua a la qual heu d'encaminar els xats.

Seguiu aquests passos per enviar context personalitzat quan inicieu un xat:

1. Els mètodes de l'SDK de xat en directe s'han d'invocar després de generar l'esdeveniment de l'esdeveniment lcw:ready . Podeu escoltar aquest esdeveniment afegint el vostre propi oient d'esdeveniments a l'objecte window.
2. Un cop generat l'esdeveniment lcw:ready , registreu un proveïdor de context personalitzat amb el xat en directe mitjançant el mètode setContextProvider .
3. Inicieu el xat mitjançant el mètode startChat .

Codi d'exemple

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

Per obtenir informació sobre com visualitzar les variables de context al resum de la conversa, consulta Mostrar el context personalitzat.

Informació relacionada

setContextProvider
getContextProvider
removeContextProvider
Referència de l'API JavaScript de l'SDK de xat en directe
Configurar variables de context per a un bot