setContextProvider

O Omnichannel for Customer Service oferece um conjunto de recursos que ampliam o poder do Dynamics 365 Customer Service Enterprise para permitir que as organizações se conectem e interajam instantaneamente com clientes em canais de mensagens digitais. É necessária uma licença adicional para acessar o Omnichannel for Customer Service. Para obter mais informações, consulte as páginas Visão geral de preços do Dynamics 365 Customer Service e Plano de preços do Dynamics 365 Customer Service.

Define o provedor de contexto para canais de chat ao vivo. A função do provedor de contexto, quando invocada, retorna o contexto a ser usado para inicializar uma sessão de chat.

Sintaxe

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

Parâmetros

Valor de retorno

None

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

No código de exemplo anterior, o value atributo contém o valor das variáveis de contexto.

O isDisplayable atributo, se definido como true, exibirá os itens passados na terceira guia no Controle de Resumo da Conversa de uma conversa.

Passar o autoatendimento do cliente como contexto

Você pode passar o autoatendimento de um cliente como contexto no início de uma conversa com esse cliente. O setContextProvider método passa as ações recentes do cliente como parte do contexto com o tipo de autoatendimento, para uma nova conversa entre o cliente e o agente. Um registro de jornada do visitante é criado para cada ação de autoatendimento.

Aqui está um código de exemplo 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 obter o script de exemplo para rastrear ações de autoatendimento que podem ser incluídas no Portal de Autoatendimento, consulte Código de exemplo de autoatendimento.

Códigos de erro

O erro a seguir pode ocorrer para esse método.

Informações relacionadas

Referência da API JavaScript para o SDK do chat ao vivo
Exibir contexto personalizado