Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La Plataforma omnicanal para Customer Service ofrece un conjunto de funciones que extienden la potencia de Dynamics 365 Customer Service Enterprise con el que las organizaciones pueden conectarse e interactuar de forma instantánea con sus clientes en distintos canales de mensajería digital. Se necesitan una licencia adicional para acceder a la Plataforma omnicanal para Customer Service. Para más información, consulte las páginas Descripción general de precios de Dynamics 365 Customer Service y Plan de precios de Dynamics 365 Customer Service.
Establece el proveedor de contexto para los canales de chat en vivo. La función de proveedor de contexto, cuando se invoca, devuelve el contexto que se usará para inicializar una sesión de chat.
Importante
- El método setContextProvider solo se admite para chats no autenticados. Para el chat autenticado, debe usar el token web JSON (JWT). Más información: Enviar tokens de autenticación
- Solo puede pasar 100 variables de contexto personalizadas durante cada sesión de chat.
- 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.
- No es necesario usar el
setContextProvidermétodo si usa la API delstartChatSDK para pasar el contexto e inicializar la sesión de chat.
Syntax
Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(contextProvider);
Parámetros
| Parámetro | Tipo | Description |
|---|---|---|
| contextProvider | Función | Función que, cuando se invoca, devuelve el contexto personalizado |
Valor devuelto
Ninguno
Example
window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
// Set the custom context provider
// Throws error if contextProvider is not a function
Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(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': {'value': 'contextValue1', 'isDisplayable': true},
'contextKey2': {'value': 12.34, 'isDisplayable': false},
'contextKey3': {'value': true}
};
});
});
En el código de ejemplo anterior, el value atributo contiene el valor de las variables de contexto.
El isDisplayable atributo, si se establece en true, mostrará los elementos pasados en la tercera pestaña del control de resumen de conversación de una conversación.
Nota:
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 con el tipo String. Más información: Variables de contexto
Pase el autoservicio del cliente como contexto
Puede pasar el autoservicio de un cliente como contexto al comienzo de una conversación con ese cliente. El setContextProvider método pasa las acciones recientes del cliente como parte del contexto con el tipo de autoservicio, para una nueva conversación entre el cliente y el agente. Se crea un registro de recorrido del visitante para cada acción de autoservicio.
Este es un código de ejemplo que muestra cómo usar el setContextProvider método.
window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(function contextProvider(){
return {
'SelfService': { 'value' :
'[ {"msdyn_displaytitle":"Page visited", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350000}, \
{"msdyn_displaytitle":"Phrase searched", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350001}, \
{"msdyn_displaytitle":"Knowledge article viewed", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350002}, \
{"msdyn_displaytitle":"Custom action performed", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350003} \
]'
}, // Additional context can be added as shown below
//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
'contextKey1': {'value': 'contextValue1', 'isDisplayable': true},
'contextKey2': {'value': 12.34, 'isDisplayable': false},
'contextKey3': {'value': true}
};
});
});
Para obtener el script de ejemplo para realizar un seguimiento de las acciones de autoservicio que se pueden incluir en el portal de autoservicio, consulte Código de ejemplo de autoservicio.
Códigos de error
Puede producirse el siguiente error para este método.
| Código de error | Mensaje de error |
|---|---|
| 1 | Error en la ejecución del método del proveedor de contexto |
Información relacionada
Referencia de la API de JavaScript para el SDK de chat en vivo
Mostrar contexto personalizado