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 Kontextanbieter für Live-Chat-Kanäle fest. Wenn die Kontextanbieterfunktion aufgerufen wird, gibt sie den Kontext zurück, der zum Initialisieren einer Chatsitzung verwendet werden soll.
Von Bedeutung
- Die setContextProvider-Methode wird nur für nicht authentifizierte Chats unterstützt. Für authentifizierte Chats müssen Sie das JSON Web Token (JWT) verwenden. Weitere Informationen: Senden von Authentifizierungstoken
- Sie können während jeder Chat-Sitzung nur 100 benutzerdefinierte Kontextvariablen übergeben.
- 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.
- Sie müssen die
setContextProviderMethode nicht verwenden, wenn Sie diestartChatSDK-API verwenden, um den Kontext zu übergeben und die Chatsitzung zu initialisieren.
Syntax
Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(contextProvider);
Die Parameter
| Parameter | Typ | Description |
|---|---|---|
| contextProvider | Funktion | Funktion, die beim Aufrufen den benutzerdefinierten Kontext zurückgibt |
Rückgabewert
Nichts
Example
window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
// Set the custom context provider
// Throws error if contextProvider is not a function
Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(function contextProvider(){
//Here it is assumed that the corresponding work stream would have context variables with logical name of 'contextKey1', 'contextKey2', 'contextKey3'. If no context variable exists with a matching logical name, items are created assuming Type:string
return {
'contextKey1': {'value': 'contextValue1', 'isDisplayable': true},
'contextKey2': {'value': 12.34, 'isDisplayable': false},
'contextKey3': {'value': true}
};
});
});
Im vorherigen Beispielcode enthält das value Attribut den Wert der Kontextvariablen.
Wenn das isDisplayable Attribut auf truefestgelegt ist, werden die übergebenen Elemente auf der dritten Registerkarte des Steuerelements für die Unterhaltungszusammenfassung für eine Unterhaltung angezeigt.
Hinweis
Wenn unter dem Live-Workstream keine Kontextvariablen mit einem passenden logischen Namen angelegt wurden, dann werden die Variablen zur Laufzeit mit dem Typ String angelegt. Weitere Informationen: Kontextvariablen
Übergeben Sie den Self-Service des Kunden als Kontext
Sie können den Self-Service eines Kunden zu Beginn einer Konversation mit diesem Kunden als Kontext übergeben. Die setContextProvider Methode übergibt die letzten Kundenaktionen als Teil des Kontexts mit dem Self-Service-Typ für eine neue Konversation zwischen dem Kunden und dem Agenten. Für jede Self-Service-Aktion wird ein Besucherverlaufsdatensatz erstellt.
Im Folgenden finden Sie einen Beispielcode, der zeigt, wie die setContextProvider Methode verwendet wird.
window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(function contextProvider(){
return {
'SelfService': { 'value' :
'[ {"msdyn_displaytitle":"Page visited", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350000}, \
{"msdyn_displaytitle":"Phrase searched", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350001}, \
{"msdyn_displaytitle":"Knowledge article viewed", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350002}, \
{"msdyn_displaytitle":"Custom action performed", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350003} \
]'
}, // Additional context can be added as shown below
//Here it is assumed that the corresponding work stream would have context variables with logical name of 'contextKey1', 'contextKey2', 'contextKey3'. If no context variable exists with a matching logical name, items are created assuming Type:string
'contextKey1': {'value': 'contextValue1', 'isDisplayable': true},
'contextKey2': {'value': 12.34, 'isDisplayable': false},
'contextKey3': {'value': true}
};
});
});
Das Beispielskript zum Nachverfolgen von Self-Service-Aktionen, die in das Self-Service-Portal eingeschlossen werden können, finden Sie unter Self-Service-Beispielcode.
Fehlercodes
Der folgende Fehler kann bei dieser Methode auftreten.
| Fehlercode | Fehlermeldung |
|---|---|
| 1 | Fehler bei der Ausführung der Kontextanbietermethode |
Verwandte Informationen
JavaScript-API-Referenz für das Livechat-SDK
Benutzerdefinierten Kontext anzeigen