setContextProvider

Vsi kanali za storitve za stranke ponuja nabor zmogljivosti, ki razširjajo zmogljivosti storitve Dynamics 365 Customer Service Enterprise, da omogoča organizacijam, da se takoj povežejo in sodelujejo s svojimi strankami prek kanalov za digitalno sporočanje. Za dostop do storitve Vsi kanali za storitve za stranke je potrebna dodatna licenca. Za več informacij glejte strani Pregled cen za Dynamics 365 Customer Service in Cenik za Dynamics 365 Customer Service.

Nastavi ponudnika konteksta za kanale za klepet v živo. Ko se prikliče funkcija ponudnika konteksta, vrne kontekst, ki se uporabi za inicializacijo seje klepeta.

Pomembno

  • Metoda setContextProvider je podprta le za klepet brez preverjanja pristnosti. Za klepet s preverjeno pristnostjo morate uporabiti spletni žeton JSON (JWT). Več informacij: Pošiljanje žetonov za preverjanje pristnosti
  • Med vsako sejo klepeta lahko posredujete samo 100 spremenljivk konteksta po meri.
  • Metode SDK za klepet v živo je treba priklicati po sproženju dogodka lcw:ready . Ta dogodek lahko poslušate tako, da dodate lasten poslušalec dogodka v predmet okna.
  • Metode vam ni treba uporabiti setContextProvider , če uporabljate startChat API SDK za posredovanje konteksta in inicializacijo seje klepeta.

Skladnja

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

Parametrov

Parameter Type Description
contextPonudnik Funkcija Funkcija, ki ob klicu vrne kontekst po meri

Vrnjena vrednost

Nobena

Primer

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 prejšnji vzorčni kodi value atribut vsebuje vrednost spremenljivk konteksta.

Če je isDisplayable atribut nastavljen na true, bo prikaže posredovane elemente na tretjem zavihku kontrolnika povzetka pogovora za pogovor.

opomba,

Če v delovnem toku v živo z ustreznim logičnim imenom ni bila ustvarjena nobena spremenljivka konteksta, so spremenljivke ustvarjene v času izvajanja z vrsto String. Več informacij: Spremenljivke konteksta

Prikažite kontekstne tipke.

Posredujte samopostrežno storitev stranke kot kontekst

Samopostrežbo stranke lahko prenesete kot kontekst na začetku pogovora s to stranko. Metoda setContextProvider posreduje nedavna dejanja strank kot del konteksta s samopostrežno vrsto za nov pogovor med stranko in agentom. Zapis potovanja obiskovalca je ustvarjen za vsako samopostrežno dejanje.

Tukaj je vzorčna koda, ki prikazuje, kako uporabiti metodo setContextProvider .

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

Za vzorčni skript za sledenje samopostrežnim dejanjem, ki jih je mogoče vključiti v samopostrežni portal, glejte Samopostrežna vzorčna koda.

Kode napak

Pri tej metodi lahko pride do naslednje napake.

Koda napake Sporočilo o napaki
1 Izvajanje metode ponudnika konteksta ni uspelo

Sklic API-ja JavaScript za SDK za klepet v živo
Prikaz konteksta po meri