Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Omnichannel for Customer Service bietet eine Reihe von Funktionalitäten, die die Möglichkeiten von Dynamics 365 Customer Service Enterprise erweitern und es Unternehmen ermöglichen, über digitale Nachrichtenkanäle sofort mit ihren Kunden in Kontakt zu treten und sich mit ihnen zu engagieren. Für den Zugriff auf Omnichannel for Customer Service ist eine zusätzliche Lizenz erforderlich. Weitere Informationen finden Sie auf den Seiten Dynamics 365 Customer Service Preisübersicht und Dynamics 365 Customer Service Preisplan.
Legt den Authentifizierungstokenanbieter fest.
Wenn die Authentifizierungstokenanbieterfunktion mit einer Rückruffunktion als Parameter aufgerufen wird, ruft sie die Rückruffunktion mit einer gültigen JSON Web Token (JWT)-Zeichenfolge als Argument auf.
Diese Methode löst einen Fehler aus, wenn der Wert des authTokenProvider Parameters keine Funktion ist.
Von Bedeutung
- In der Nutzlast des JWT-Tokens sollte der für key angegebene
lwicontextsWert der serialisierte benutzerdefinierte Kontext sein. - Der benutzerdefinierte Kontext ist eine Sammlung von Schlüssel-Wert-Paaren. Für jeden Schlüssel sind nur primitive Werte zulässig.
- Die Schlüssel des benutzerdefinierten Kontexts müssen Kontextvariablen entsprechen, die für den zugehörigen Arbeitsablauf in Omnichannel for Customer Service erstellt werden.
- Der Authentifizierungstoken-Anbieter wird vom Live-Chat-Widget aufgerufen, wenn ein neuer Chat gestartet wird.
Hinweis
Die Livechat-SDK-Methoden sollten aufgerufen werden, nachdem das lcw:ready-Ereignis ausgelöst wurde. Sie können auf dieses Ereignis lauschen, indem Sie dem window-Objekt einen eigenen Ereignis-Listener hinzufügen.
Dieses SDK ist nur anwendbar, wenn die Authentifizierung für das Widget aktiviert ist. Informationen zum Aktivieren der Authentifizierung für Ihr Widget finden Sie unter Erstellen von Chat-Authentifizierungseinstellungen.
Syntax
Microsoft.Omnichannel.LiveChatWidget.SDK.setAuthTokenProvider(authTokenProvider);
Die Parameter
| Parameter | Typ | Description |
|---|---|---|
| authTokenProvider | Funktion | Funktion, die, wenn sie mit einer Callback-Funktion als Argument aufgerufen wird, das JWT-Token abruft und die Callback-Funktion mit dem JWT-Token als Argument aufruft |
Rückgabewert
Nichts
Example
Beispiel für eine Token-Nutzlast
{
"sub" : "87b4d06c-abc2-e811-a9b0-000d3a10e09e",
"lwicontexts" :"{\"msdyn_cartvalue\":\"10000\", \"msdyn_isvip\":\"false\"}",
"iat" : 1542622071,
"iss" : "contosohelp.com",
"exp" : 1542625672,
"nbf" : 1542622072
}
Hinweis
In der obigen Nutzlast sollte der Wert, der dem lwicontexts Schlüssel entspricht, der serialisierte benutzerdefinierte Kontext sein.
Die Schlüssel msdyn_cartvalue und msdyn_isvip im serialisierten benutzerdefinierten Kontext entsprechen Kontextvariablen, die für den zugeordneten Arbeitsablauf in Omnichannel for Customer Service erstellt werden.
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);
});
});
});
Fehlercodes
Die folgenden Fehler können bei dieser Methode auftreten.
| Fehlercode | Fehlermeldung |
|---|---|
| 2 | Fehler bei der Ausführung der Authentifizierungstokenanbietermethode. |
| 3 | Der Auth-Tokenanbieter hat kein Token bereitgestellt. |
| 4 | Auth-Tokenanbieter bereitgestellt ungültiges Token |