Udostępnij przez


setContextProvider

Aplikacja Obsługa wielokanałowa klientów dla Dynamics 365 oferuje zestaw funkcji, które rozszerzają możliwości Dynamics 365 Customer Service Enterprise, aby umożliwić organizacjom natychmiastowe łączenie się i interakcję z klientami za pośrednictwem cyfrowych kanałów komunikacji. Do uzyskania dostępu do plików sieciOwych w celu obsługa klienta jest wymagana dodatkowa licencja. Aby uzyskać więcej informacji, zobacz omówienie cennika usługi Dynamics 365 Customer Service i strony cennika Dynamics 365 Customer Service.

Ustawia dostawcę kontekstu dla kanałów czatu na żywo. Funkcja dostawcy kontekstu po wywołaniu zwraca kontekst, który ma być używany do inicjowania sesji czatu.

Ważne

  • Metoda setContextProvider jest obsługiwana tylko w przypadku nieuwierzytelnionego czatu. W przypadku uwierzytelnionego czatu należy użyć tokenu internetowego JSON (JWT). Więcej informacji: Wysyłanie tokenów uwierzytelniania
  • Podczas każdej sesji czatu możesz przekazać tylko 100 niestandardowych zmiennych kontekstowych.
  • Metody SDK czatu na żywo powinny być wywoływane po zgłoszeniu zdarzenia lcw:ready . To zdarzenie można wykrywać, dodając własny detektor zdarzeń do obiektu window.
  • Nie musisz używać tej setContextProvider metody, jeśli używasz startChat interfejsu API SDK do przekazywania kontekstu i inicjowania sesji czatu.

Składnia

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

Parametry

Parameter Typ Description
contextProvider (dostawca kontekstu) Funkcja Funkcja, która po wywołaniu zwraca kontekst niestandardowy

Wartość zwracana

Żaden

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

W poprzednim przykładowym kodzie value atrybut zawiera wartość zmiennych kontekstowych.

Atrybut isDisplayable , jeśli jest ustawiony na true, spowoduje wyświetlenie przekazanych elementów na trzeciej karcie w kontrolce Podsumowanie konwersacji dla konwersacji.

Uwaga / Notatka

Jeśli w strumieniu pracy na żywo nie utworzono żadnych zmiennych kontekstowych o pasującej nazwie logicznej, zmienne są tworzone w czasie wykonywania z typem String. Więcej informacji: Zmienne kontekstowe

Wyświetlanie kontekstowych.

Przekazywanie informacji o samoobsłudze klienta jako kontekstu

Możesz przekazać samoobsługę klienta jako kontekst na początku rozmowy z tym klientem. Metoda setContextProvider przekazuje ostatnie akcje klienta w ramach kontekstu z typem samoobsługi dla nowej konwersacji między klientem a agentem. Rekord podróży odwiedzającego jest tworzony dla każdej akcji samoobsługowej.

Oto przykładowy kod, który pokazuje, jak używać tej setContextProvider metody.

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

Aby zapoznać się z przykładowym skryptem do śledzenia akcji samoobsługowych, które można uwzględnić w portalu samoobsługowym, zobacz Przykładowy kod samoobsługi.

Kody błędów

W przypadku tej metody może wystąpić następujący błąd.

Kod błędu Komunikat o błędzie
1 Wykonanie metody dostawcy kontekstu nie powiodło się

Dokumentacja interfejsu API JavaScript dla pakietu SDK czatu na żywo
Wyświetlanie kontekstu niestandardowego