Enviar contexto personalizado durante el chat en directo

El contexto personalizado es una colección de pares de clave o valor. Solo se permiten valores primitivos para cualquier clave. Las claves deben corresponder a las variables de contexto que se crean para el flujo de trabajo asociado. Si no se han creado variables de contexto en el flujo de trabajo en vivo con un nombre lógico coincidente, las variables se crean en runtime asumiendo el tipo como Cadena. El proveedor de contexto personalizado sería invocado por el widget de chat al iniciar un nuevo chat. Dado que los valores distinguen mayúsculas de minúsculas, use la coincidencia exacta para pasarlos a las variables de contexto. Más información: Consideraciones para variables de contexto

Importante

• setContextProvider solo se admite para el chat no autenticado. Para el chat autenticado, debe usar el token web JSON (JWT). Más información: Enviar tokens de autenticación
• Puede pasar solo 100 variables de contexto personalizadas durante cada sesión de chat.

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

Siga estos pasos para enviar contexto personalizado al iniciar un chat:

1. Los métodos de SDK de chat activo deben ser invocados después de activar el evento lcw:ready. Puede escuchar este evento agregando su propio agente de escucha del evento en el objeto de la ventana.
2. Una vez que se active el evento lcw:ready, registre un proveedor de contexto personalizado con chat activo mediante el método setContextProvider.
3. Iniciar el chat utilizando 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 conversación, consulte Mostrar contexto personalizado.

Consulte también

setContextProvider
getContextProvider
removeContextProvider
Referencia de las API de JavaScript de SDK de chat activo
Configurar variables de contexto para un bot