Udostępnij przez

setAuthTokenProvider

Aplikacja Obsługa wielokanałowa klientów dla Dynamics 365 oferuje zestaw funkcji, które rozszerzają możliwości Dynamics 365 Customer Service Enterprise, aby umożliwić organizacjom natychmiastowe łączenie się i interakcję z klientami za pośrednictwem cyfrowych kanałów komunikacji. Do uzyskania dostępu do plików sieciOwych w celu obsługa klienta jest wymagana dodatkowa licencja. Aby uzyskać więcej informacji, zobacz omówienie cennika usługi Dynamics 365 Customer Service i strony cennika Dynamics 365 Customer Service.

Ustawia dostawcę tokenu uwierzytelniania.

Funkcja dostawcy tokenu uwierzytelniania, gdy jest wywoływana z funkcją wywołania zwrotnego jako parametrem, wywołuje funkcję wywołania zwrotnego z prawidłowym ciągiem tokenu internetowego JSON (JWT) jako argumentem.
Ta metoda zgłasza błąd, jeśli wartość parametru authTokenProvider nie jest funkcją.

Ważne

  • W ładunku tokenu JWT wartość podana dla lwicontexts klucza powinna być serializowanym kontekstem niestandardowym.
  • Kontekst niestandardowy to kolekcja par klucz/wartość. Tylko wartości pierwotne są dozwolone dla dowolnego klucza.
  • Klucze kontekstu niestandardowego muszą odpowiadać zmiennym kontekstowym, które są tworzone dla skojarzonego strumienia pracy w aplikacji Obsługa wielokanałowa dla Customer Service.
  • Dostawca tokena uwierzytelniania będzie wywoływany przez widżet czatu na żywo podczas rozpoczynania nowego czatu.

Uwaga / Notatka

Metody SDK czatu na żywo powinny być wywoływane po zgłoszeniu zdarzenia lcw:ready . To zdarzenie można wykrywać, dodając własny detektor zdarzeń do obiektu window.

Ten zestaw SDK ma zastosowanie tylko wtedy, gdy dla widżetu jest włączone uwierzytelnianie. Aby włączyć uwierzytelnianie dla widżetu, zobacz Tworzenie ustawień uwierzytelniania czatu.

Składnia

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

Parametry

Parameter Typ Description
authTokenProvider (dostawca tokenów) Funkcja Funkcja, która po wywołaniu z funkcją wywołania zwrotnego jako argumentem pobiera token JWT i wywołuje funkcję wywołania zwrotnego z tokenem JWT jako argumentem

Wartość zwracana

Żaden

Example

Przykładowy ładunek tokenu

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

Uwaga / Notatka

W powyższym ładunku wartość odpowiadająca lwicontexts kluczowi powinna być serializowanym kontekstem niestandardowym. Klucze msdyn_cartvalue i msdyn_isvip w serializowanym kontekście niestandardowym odpowiadają zmiennym kontekstowym, które są tworzone dla skojarzonego strumienia pracy w aplikacji Obsługa wielokanałowa dla 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);
        });
    });
});

Kody błędów

W przypadku tej metody mogą wystąpić następujące błędy.

Kod błędu Komunikat o błędzie
2 Wykonanie metody dostawcy tokenu uwierzytelniania nie powiodło się
3 Dostawca tokenu uwierzytelniania nie dostarczył żadnego tokenu
4 Dostawca tokenu uwierzytelniania dostarczył nieprawidłowy token

Dokumentacja interfejsu API JavaScript dla pakietu SDK czatu na żywo

  • Last updated on