Compartilhar via

setAuthTokenProvider

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 token de autenticação.

A função do provedor de token de autenticação, quando chamada com uma função de retorno de chamada como parâmetro, invoca a função de retorno de chamada com uma cadeia de caracteres JWT (JSON Web Token) válida como argumento.
Esse método gerará um erro se o valor do authTokenProvider parâmetro não for uma função.

Importante

  • Na carga útil do token JWT, o valor fornecido para lwicontexts a chave deve ser o contexto personalizado serializado.
  • O contexto personalizado é uma coleção de pares chave/valor. Somente valores primitivos são permitidos para qualquer chave.
  • As chaves de contexto personalizado devem corresponder às variáveis de contexto criadas para o fluxo de trabalho associado no Omnicanal para Customer Service.
  • O provedor de token de autenticação seria invocado pelo widget de chat ao vivo ao iniciar um novo chat.

Observação

Os métodos do SDK do chat ao vivo devem ser invocados depois que o evento lcw:ready for gerado. Você pode escutar esse evento adicionando seu próprio ouvinte de eventos no objeto window.

Esse SDK só será aplicável se a autenticação estiver ativada para o widget. Para ativar a autenticação para seu widget, consulte Criar configurações de autenticação de chat.

Sintaxe

Microsoft.Omnichannel.LiveChatWidget.SDK.setAuthTokenProvider(authTokenProvider);

Parâmetros

Parâmetro Tipo Description
authTokenProvider Função Função que, quando invocada com uma função de retorno de chamada como argumento, busca o token JWT e invoca a função de retorno de chamada com o token JWT como argumento

Valor de retorno

None

Example

Exemplo de conteúdo do token

{
    "sub" : "87b4d06c-abc2-e811-a9b0-000d3a10e09e",
    "lwicontexts" :"{\"msdyn_cartvalue\":\"10000\", \"msdyn_isvip\":\"false\"}",
    "iat" : 1542622071,
    "iss" : "contosohelp.com",
    "exp" : 1542625672,
    "nbf" : 1542622072
}

Observação

Na carga acima, o valor correspondente à lwicontexts chave deve ser o contexto personalizado serializado. As chaves msdyn_cartvalue e msdyn_isvip no contexto personalizado serializado correspondem às variáveis de contexto criadas para o fluxo de trabalho associado no Omnicanal para Customer Service.

let payloadToEncrypt = {
    "sub" : "87b4d06c-abc2-e811-a9b0-000d3a10e09e",
    "lwicontexts" :"{\"msdyn_cartvalue\":\"10000\", \"msdyn_isvip\":\"false\"}",
    "iat" : 1542622071,
    "iss" : "contosohelp.com",
    "exp" : 1542625672,
    "nbf" : 1542622072
};

function convertToJwtToken(payloadToEncrypt){
    // Ideally, you call your service to convert the payload to a valid JWT token
    return Promise.resolve("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI4N2I0ZDA2Yy1hYmMyLWU4MTEtYTliMC0wMDBkM2ExMGUwOWUiLCJsd2ljb250ZXh0cyI6IntcIm1zZHluX2NhcnR2YWx1ZVwiOlwiMTAwMDBcIiwgXCJtc2R5bl9pc3ZpcFwiOlwiZmFsc2VcIn0iLCJpYXQiOjE1NDI2MjIwNzEsImlzcyI6ImNvbnRvc29oZWxwLmNvbSIsImV4cCI6MTU0MjYyNTY3MiwibmJmIjoxNTQyNjIyMDcyfQ.r37z1M5rMyRYMOJ-rhyTRYFOgvl9N7KvTMueSFPkiuM");
}

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
// Sets the auth-token provider
// Throws error if authTokenProvider is not a function
    convertToJwtToken(payloadToEncrypt).then(function (jwtToken){
        Microsoft.Omnichannel.LiveChatWidget.SDK.setAuthTokenProvider(function authTokenProvider(callback){
            callback(jwtToken);
        });
    });
});

Códigos de erro

Os erros a seguir podem ocorrer com esse método.

Código do erro Mensagem de erro
2 Falha na execução do método do provedor de token de autenticação
3 O provedor de token de autenticação não forneceu nenhum token
4 O provedor de token de autenticação forneceu token inválido

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

  • Last updated on