setContextProvider

Customer Service için Çok Yönlü Kanal, kuruluşların, dijital mesajlaşma kanallarında anında bağlanıp müşterileriyle etkileşim kurmalarını sağlamak için Dynamics 365 Customer Service Enterprise'ın gücünü genişleten bir özellikler paketi sunar. Customer Service için Çok Yönlü Kanal'a erişmek için ek bir lisans gerekir. Daha fazla bilgi için Dynamics 365 Customer Service fiyatlandırmasına genel bakış ve Dynamics 365 Customer Service fiyatlandırma planı sayfalarına bakın.

Canlı sohbet kanalları için bağlam sağlayıcısını ayarlar. Bağlam sağlayıcı işlevi çağrıldığında, bir sohbet oturumunu başlatmak için kullanılacak bağlamı döndürür.

Önemli

  • setContextProvider yöntemi yalnızca kimliği doğrulanmamış sohbet için desteklenir. Kimliği doğrulanmış sohbet için JSON Web Belirteci (JWT) kullanmanız gerekir. Daha fazla bilgi: Kimlik doğrulama belirteçleri gönderme
  • Her sohbet oturumu sırasında yalnızca 100 özel bağlam değişkeni geçirebilirsiniz.
  • Canlı sohbet SDK yöntemleri, lcw:ready olayı tetiklendikten sonra çağrılmalıdır. Pencere nesnesine kendi olay dinleyicinizi ekleyerek bu olayı dinleyebilirsiniz.
  • Bağlamı iletmek ve sohbet oturumunu başlatmak için SDK API'sini setContextProvider kullanıyorsanız yöntemi kullanmanız startChat gerekmez.

Sözdizimi

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

Parametreler

Parametre Türü Description
contextProvider (bağlam Sağlayıcısı) İşlev Çağrıldığında özel bağlamı döndüren işlev

Dönüş değeri

Hiç kimse

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

Yukarıdaki örnek kodda, value öznitelik bağlam değişkenlerinin değerini içerir.

Özniteliği isDisplayable olarak ayarlanırsa true, iletilen öğeler bir konuşma için Konuşma Özeti Denetimi'ndeki üçüncü sekmede görüntülenir.

Uyarı

Canlı iş akışı altında eşleşen bir mantıksal adla hiçbir bağlam değişkeni oluşturulmadıysa, değişkenler çalışma zamanında String türüyle oluşturulur. Daha fazla bilgi: Bağlam değişkenleri

Bağlam tuşlarını görüntüleyin.

Müşterinin self servisini bağlam olarak geçirin

Bir müşterinin self servisini o müşteriyle yapılan bir konuşmanın başında bağlam olarak geçirebilirsiniz. Yöntem setContextProvider , müşteri ile temsilci arasında yeni bir konuşma için self servis türüyle bağlamın bir parçası olarak son müşteri eylemlerini geçirir. Her self servis eylemi için bir ziyaretçi yolculuğu kaydı oluşturulur.

Yöntemin setContextProvider nasıl kullanılacağını gösteren örnek bir kod aşağıda verilmiştir.

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

Self Servis Portalı'na dahil edilebilecek self servis eylemlerini izlemeye yönelik örnek betik için Self Servis örnek koduna bakın.

Hata kodları

Bu yöntem için aşağıdaki hata oluşabilir.

Hata kodu Hata mesajı
1 Bağlam sağlayıcısı yöntemi yürütme başarısız oldu

Canlı sohbet SDK'sı için JavaScript API referansı
Özel bağlamı görüntüleme

  • Son güncelleştirme: