setAuthTokenProvider

Omnikanál pro Customer Service nabízí sadu funkcí, které rozšiřují výkon Dynamics 365 Customer Service Enterprise, což umožňuje organizacím okamžitě se spojit a komunikovat se svými zákazníky prostřednictvím kanálů digitálního zasílání zpráv. Pro přístup k Omnikanálu pro Customer Service je vyžadována další licence. Více informací naleznete na stránkách Přehled cen Dynamics 365 Customer Service a Cenový plán Dynamics 365 Customer Service.

Nastaví poskytovatele ověřovacího tokenu.

Funkce zprostředkovatele ověřovacího tokenu, pokud je volána s funkcí zpětného volání jako parametrem, vyvolá funkci zpětného volání s platným řetězcem JSON Web Token (JWT) jako argumentem.
Tato metoda vyvolá chybu, pokud hodnota parametru authTokenProvider není funkcí.

Důležité

  • V datové části tokenu JWT by hodnota zadaná pro lwicontexts key měla být serializovaným vlastním kontextem.
  • Vlastní kontext je kolekce párů klíč/hodnota. Pro každý klíč jsou povoleny pouze primitivní hodnoty.
  • Klíče vlastního kontextu musí odpovídat kontextovým proměnným, které jsou vytvořeny pro přidružený tok práce v Omnikanálu pro Customer Service.
  • Poskytovatel ověřovacího tokenu by byl vyvolán widgetem živého chatu při zahájení nového chatu.

Poznámka:

Metody sady SDK pro živý chat by měly být vyvolány po vyvolání události lcw:ready . Tuto událost můžete poslouchat přidáním vlastního posluchače událostí na objekt window.

Tato sada SDK je použitelná pouze v případě, že je pro widget povoleno ověřování. Chcete-li povolit ověření pro widget, přečtěte si článek Vytvoření nastavení ověření chatu.

Syntaxe

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

Parametry

Parameter Typ Description
authTokenProvider Funkce Funkce, která při vyvolání se zpětně volající funkcí jako argumentem načte token JWT a vyvolá funkci zpětného volání s tokenem JWT jako argumentem

Návratová hodnota

None

Example

Ukázková datová část tokenu

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

Poznámka:

Ve výše uvedené datové části by hodnota odpovídající lwicontexts klíči měla být serializovaným vlastním kontextem. Klíče msdyn_cartvalue a msdyn_isvip v serializovaném vlastním kontextu odpovídají kontextovým proměnným, které jsou vytvořeny pro přidružený tok práce v Omnikanálu pro 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);
        });
    });
});

Kódy chyb

Při této metodě může dojít k následujícím chybám.

Kód chyby Zpráva o chybě
2 Spuštění metody poskytovatele ověřovacího tokenu se nezdařilo
3 Poskytovatel ověřovacího tokenu neposkytl žádný token
4 Poskytovatel ověřovacího tokenu poskytl neplatný token

Referenční informace k rozhraní JavaScript API pro sadu SDK pro živý chat

  • Poslední aktualizace v