Partager via

setAuthTokenProvider

Omnicanal pour Customer Service contient une suite de capacités qui étendent la puissance de Dynamics 365 Customer Service Enterprise pour permettre aux organisations de se connecter et d’interagir instantanément avec leurs clients sur les canaux de messagerie numérique. Une licence supplémentaire est requise pour accéder à Omnichannel pour Customer Service. Pour plus d’informations, voir les pages Vue d’ensemble de la tarification de Dynamics 365 Customer Service et Plan de tarification de Dynamics 365 Customer Service.

Définit le fournisseur de jeton d’authentification.

La fonction du fournisseur de jeton d’authentification, lorsqu’elle est appelée avec une fonction de rappel en tant que paramètre, appelle la fonction de rappel avec une chaîne JSON Web Token (JWT) valide comme argument.
Cette méthode génère une erreur si la valeur du paramètre n’est authTokenProvider pas une fonction.

Important

  • Dans la charge utile du jeton JWT, la valeur fournie pour lwicontexts key doit être le contexte personnalisé sérialisé.
  • Le contexte personnalisé est une collection de paires clé/valeur. Seules les valeurs primitives sont autorisées pour une clé.
  • Les clés de contexte personnalisé doivent correspondre aux variables de contexte créées pour le flux de travail associé dans Omnicanal pour Customer Service.
  • Le fournisseur de jeton d’authentification serait appelé par le widget de chat en direct lors du démarrage d’un nouveau chat.

Note

Les méthodes SDK de chat en direct doivent être appelées après le déclenchement de l’événement lcw :ready . Vous pouvez écouter cet événement en ajoutant votre propre écouteur d’événements sur l’objet window.

Ce SDK n’est applicable que si l’authentification est activée pour le widget. Pour activer l’authentification de votre widget, consultez la section Créer des paramètres d’authentification de chat.

Syntaxe

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

Paramètres

Paramètre Type Descriptif
authTokenProvider Fonction Fonction qui, lorsqu’elle est appelée avec une fonction de rappel comme argument, récupère le jeton JWT et appelle la fonction de rappel avec le jeton JWT comme argument

Valeur retournée

Aucun

Example

Exemple de charge utile de jeton

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

Note

Dans la charge utile ci-dessus, la valeur correspondant à lwicontexts la clé doit être le contexte personnalisé sérialisé. Les clés msdyn_cartvalue et msdyn_isvip dans le contexte personnalisé sérialisé correspondent aux variables de contexte créées pour le flux de travail associé dans Omnicanal pour 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);
        });
    });
});

Codes d’erreur

Les erreurs suivantes peuvent se produire avec cette méthode.

Code d’erreur Message d'erreur
2 Échec de l’exécution de la méthode du fournisseur de jetons d’authentification
3 Le fournisseur de jetons d’authentification n’a pas fourni de jeton
4 Fournisseur de jetons d’authentification fourni un jeton non valide

Référence de l’API JavaScript pour le SDK de chat en direct

  • Last updated on