Sdílet prostřednictvím

setContextProvider

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 kontextu pro kanály živého chatu. Funkce zprostředkovatele kontextu při vyvolání vrátí kontext, který má být použit pro inicializaci relace chatu.

Důležité

  • Metoda setContextProvider je podporována pouze pro neověřený chat. Pro ověřený chat musíte použít JSON Web Token (JWT). Další informace: Odeslání ověřovacích tokenů
  • Během každé relace chatu můžete předat pouze 100 vlastních kontextových proměnných.
  • 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.
  • Tuto metodu nemusíte používat setContextProvider , pokud startChat používáte rozhraní API sady SDK k předání kontextu a inicializaci relace chatu.

Syntaxe

Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(contextProvider);

Parametry

Parameter Typ Description
contextProvider Funkce Funkce, která při vyvolání vrátí vlastní kontext

Návratová hodnota

None

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}
                   };
        });
});

V předchozím ukázkovém kódu value atribut obsahuje hodnotu kontextových proměnných.

Atribut isDisplayable , pokud je nastaven na true, zobrazí předané položky na třetí kartě ovládacího prvku Souhrn konverzace pro konverzaci.

Poznámka:

Pokud nebyly v živém toku práce vytvořeny žádné kontextové proměnné s odpovídajícím logickým názvem, pak jsou proměnné vytvořeny za běhu s typem Řetězec. Další informace: Kontextové proměnné

Zobrazte kontextové klávesy.

Předejte samoobsluhu zákazníka jako kontext

Samoobsluhu zákazníka můžete předat jako kontext na začátku konverzace s tímto zákazníkem. Metoda setContextProvider předává nedávné akce zákazníka jako součást kontextu s typem samoobslužné služby pro novou konverzaci mezi zákazníkem a agentem. Pro každou samoobslužnou akci se vytvoří záznam o cestě návštěvníka.

Zde je ukázkový kód, který ukazuje, jak tuto setContextProvider metodu používat.

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}
         };
    });
});

Ukázkový skript pro sledování samoobslužných akcí, které lze zahrnout do samoobslužného portálu, naleznete v ukázkovém kódu samoobslužné služby.

Kódy chyb

U této metody může dojít k následující chybě.

Kód chyby Zpráva o chybě
1 Spuštění metody zprostředkovatele kontextu se nezdařilo

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

  • Last updated on