Comparteix a través de

setContextProvider

La Plataforma omnicanal per al Customer Service ofereix un conjunt de capacitats que amplien el potencial del Dynamics 365 Customer Service Enterprise per permetre a les organitzacions connectar-se i interactuar de manera immediata amb els seus clients a través de canals de missatgeria digital. Cal una llicència addicional per accedir a la Plataforma omnicanal per al Customer Service. Per obtenir més informació, vegeu les pàgines Informació general del Dynamics 365 Customer Service i Pla de preus del Dynamics 365 Customer Service .

Defineix el proveïdor de context per als canals de xat en directe. La funció proveïdor de context, quan s'invoca, retorna el context que s'utilitzarà per inicialitzar una sessió de xat.

Important

  • El mètode setContextProvider només s'admet per al xat no autenticat. Per al xat autenticat, heu d'utilitzar el testimoni web JSON (JWT). Més informació: Enviar testimonis d'autenticació
  • Només podeu passar 100 variables de context personalitzades durant cada sessió de xat.
  • Els mètodes de l'SDK de xat en directe s'han d'invocar després de generar l'esdeveniment lcw:ready . Podeu escoltar aquest esdeveniment afegint el vostre propi oient d'esdeveniments a l'objecte window.
  • No cal que utilitzeu el setContextProvider mètode si utilitzeu l'API de l'SDK startChat per passar el context i inicialitzar la sessió de xat.

Sintaxi

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

Paràmetres

Paràmetre Tipus Descripció
Proveïdor de context Funció Funció que, quan s'invoca, retorna el context personalitzat

Valor retornat

Cap

Exemple

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

Al codi d'exemple anterior, l'atribut value conté el valor de les variables de context.

L'atribut isDisplayable , si està definit en true, mostrarà els elements passats a la tercera pestanya del control de resum de conversa d'una conversa.

Nota

Si no s'ha creat cap variable de context a la seqüència de treball en directe amb un nom lògic coincident, les variables es crearan en temps d'execució amb el tipus String. Més informació: Variables de context

Visualitza les tecles de context.

Passar l'autoservei del client com a context

Podeu passar l'autoservei d'un client com a context a l'inici d'una conversa amb aquest client. El setContextProvider mètode passa les accions recents del client com a part del context amb el tipus d'autoservei, per a una nova conversa entre el client i l'agent. Es crea un registre de recorregut del visitant per a cada acció d'autoservei.

Aquí teniu un codi d'exemple que mostra com utilitzar el setContextProvider mètode.

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

Per obtenir l'script d'exemple per fer el seguiment de les accions d'autoservei que es poden incloure al portal d'autoservei, vegeu Codi d'exemple d'autoservei.

Codis d'error

Es pot produir l'error següent per a aquest mètode.

Codi d'error Missatge d'error
1 Error en l'execució del mètode del proveïdor de context

Referència de l'API de JavaScript per a l'SDK de xat en directe
Visualitza el context personalitzat

  • Last updated on