Partajați prin

setContextProvider

Omnicanal pentru Customer Service oferă o suită de capacități care extinde puterea Dynamics 365 Customer Service Enterprise pentru a permite organizațiilor să se conecteze instantaneu și să interacționeze cu clienții lor prin canale de mesagerie digitală. Este necesară o licență suplimentară pentru a accesa Omnicanal pentru Customer Service. Pentru mai multe informații, consultați paginile Prezentare generală a prețurilor Dynamics 365 Customer Service și Planul de prețuri Dynamics 365 Customer Service .

Setează furnizorul de context pentru canalele de chat live. Funcția furnizor de context, atunci când este invocată, returnează contextul care urmează să fie utilizat pentru inițializarea unei sesiuni de chat.

Importantă

  • Metoda setContextProvider este acceptată numai pentru chatul neautentificat. Pentru chatul autentificat, trebuie să utilizați JSON Web Token (JWT). Informații suplimentare: Trimiterea tokenurilor de autentificare
  • Puteți transmite doar 100 de variabile de context personalizate în timpul fiecărei sesiuni de chat.
  • Metodele SDK de chat live ar trebui invocate după ce este ridicat evenimentul lcw:ready . Puteți asculta acest eveniment adăugând propriul ascultător de evenimente pe obiectul window.
  • Nu trebuie să utilizați setContextProvider metoda dacă utilizați API-ul startChat SDK pentru a transmite contextul și a inițializa sesiunea de chat.

Sintaxă

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

Parametrii

Parametru Tip Descriere
contextProvider Funcționa Funcție care, atunci când este invocată, returnează contextul personalizat

Valoare returnată

Fără

Exemplu

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

În exemplul de cod precedent, atributul value conține valoarea variabilelor de context.

Atributul isDisplayable , dacă este setat la true, va afișa elementele trecute în a treia filă din Controlul rezumat conversație pentru o conversație.

Notă

Dacă nu au fost create variabile de context în fluxul de lucru live cu un nume logic corespunzător, atunci variabilele sunt create la rulare cu tipul Șir. Informații suplimentare: Variabile de context

Afișați tastele contextuale.

Transmiteți autoservirea clientului ca context

Puteți transmite autoservirea unui client ca context la începutul unei conversații cu acel client. Metoda setContextProvider trece acțiunile recente ale clientului ca parte a contextului cu tipul self service, pentru o nouă conversație între client și agent. Se creează o înregistrare a călătoriei vizitatorului pentru fiecare acțiune de autoservire.

Iată un exemplu de cod care arată cum să utilizați setContextProvider metoda.

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

Pentru scriptul eșantion pentru a urmări acțiunile de autoservire care pot fi incluse în portalul de autoservire, consultați Codul eșantion de autoservire.

Coduri de eroare

Următoarea eroare poate apărea pentru această metodă.

Cod de eroare Mesaj de eroare
1 Executarea metodei furnizorului de context a eșuat

Referință API JavaScript pentru SDK-ul de chat live
Afișați contextul personalizat

  • Last updated on