Envío de contexto personalizado durante el chat en directo

El contexto personalizado es una colección de pares de claves o valores. Solo se permiten valores primitivos para cualquier clave. Las claves deben corresponder a variables de contexto que se crean para la secuencia de trabajo asociada. Si no se han creado variables de contexto en la secuencia de trabajo en vivo con un nombre lógico coincidente, las variables se crean en tiempo de ejecución asumiendo el tipo como String. El widget de chat en vivo invocaría el proveedor de contexto personalizado cuando se inicie un nuevo chat. Dado que los valores distinguen entre mayúsculas y minúsculas, use la coincidencia exacta para pasarlos a las variables de contexto. Más información: Consideraciones para las variables de contexto

Cuando un cliente inicia un chat desde el portal, puede pasar un contexto personalizado a la Plataforma omnicanal para Customer Service. Este contexto personalizado se puede usar para mostrar información en la interfaz de usuario y para crear reglas de enrutamiento que finalmente determinen la cola a la que debe enrutar los chats.

Sigue estos pasos para enviar contexto personalizado cuando inicies un chat:

1. Los métodos del SDK de chat en vivo deben invocarse después de que se genere el evento lcw:ready . Puede escuchar este evento agregando su propio detector de eventos en el objeto window.
2. Una vez generado el lcw:ready evento, registre un proveedor de contexto personalizado con chat en vivo mediante el método setContextProvider .
3. Inicie el chat con el método startChat .

Código de ejemplo

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

Para obtener información sobre cómo mostrar las variables de contexto en el resumen de la conversación, consulte Mostrar contexto personalizado.

Información relacionada

setContextProvider
getContextProvider
removeContextProvider
Referencia de la API de JavaScript del SDK de chat en vivo
Configuración de variables de contexto para un bot