setContextProvider

Multicanle para Customer Service ofrece un conxunto de capacidades que amplían o poder de Dynamics 365 Customer Service Enterprise para permitir ás organizacións conectarse instantáneamente e interactuar cos seus clientes a través de canles como o chat en directo e SMS. Requírese unha licenza adicional para acceder á Multicanle para Customer Service. Para obter máis información, consulte as páxinas Visión xeral dos prezos de Dynamics 365 Customer Service e Plan de prezos de Dynamics 365 Customer Service .

Establece o provedor de contexto para as canles de chat en directo. A función do provedor de contexto, cando se invoca, devolve o contexto a usar para inicializar unha sesión de chat.

Importante

  • O método setContextProvider só está soportado para chat non autenticado. Para o chat autenticado, debes usar o token web JSON (JWT). Máis información: Enviar tokens de autenticación
  • Só podes pasar 100 variables de contexto personalizadas durante cada sesión de chat.
  • Os métodos SDK de chat en directo deben ser invocados despois de que se levante o evento lcw:ready . Pode escoitar este evento engadindo o seu propio oínte de eventos no obxecto da xanela.
  • Non é necesario usar o setContextProvider método se está a usar a startChat API SDK para pasar o contexto e inicializar a sesión de chat.

Sintaxe

Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(contextProvider);

Parámetros

Parámetro Tipo Descripción
ContextProvider Función Función que, cando se invoca, devolve o contexto personalizado

Valor de devolución

Nada

Exemplo

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

No código de mostra anterior, o value atributo contén o valor das variables de contexto.

O isDisplayable atributo, se está establecido en true, mostrará os elementos pasados na terceira pestana do control de resumo de conversa para unha conversa.

Nota

Se non se crearon variables de contexto baixo o fluxo de traballo en directo cun nome lóxico correspondente, entón as variables créanse en tempo de execución co tipo String. Máis información: Variables de contexto

Mostrar as teclas de contexto.

Pasar o autoservizo do cliente como contexto

Podes pasar o autoservizo dun cliente como contexto ao comezo dunha conversa con ese cliente. O setContextProvider método pasa as accións recentes do cliente como parte do contexto con tipo de autoservizo, para unha nova conversa entre o cliente e o axente. Créase un rexistro de viaxe do visitante para cada acción de autoservizo.

Aquí tes unha mostra de código que mostra como usar o 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 o script de exemplo para rastrexar as accións de autoservizo que se poden incluír no Portal de Self-Service, consulte Código de exemplo de Self Service.

Códigos de erro

O seguinte erro pode ocorrer neste método.

Código de erro Mensaxe de erro
1 Fallou a execución do método do provedor de contexto

Referencia da API JavaScript para o SDK de chat en directo
Mostrar o contexto personalizado

  • Last updated on