setContextProvider

Saluran Omni untuk Customer Service menawarkan rangkaian keupayaan yang melanjutkan kuasa Dynamics 365 Customer Service Enterprise untuk mendayakan organisasi berhubung dengan segera dan terlibat dengan pelanggan mereka melalui saluran pemesejan digital. Lesen tambahan diperlukan untuk mengakses Saluran Omni untuk Customer Service. Untuk mendapatkan maklumat lanjut, lihat gambaran keseluruhan harga Dynamics 365 Customer Service dan halaman pelan harga Dynamics 365 Customer Service .

Menetapkan pembekal konteks untuk saluran sembang langsung. Fungsi pembekal konteks, apabila dipanggil, mengembalikan konteks yang akan digunakan untuk memulakan sesi sembang.

Penting

  • Kaedah setContextProvider hanya disokong untuk sembang yang tidak disahkan. Untuk sembang yang disahkan, anda mesti menggunakan Token Web JSON (JWT). Maklumat lanjut: Hantar token pengesahan
  • Anda boleh lulus hanya 100 pembolehubah konteks tersuai semasa setiap sesi sembang.
  • Kaedah SDK sembang langsung hendaklah digunakan selepas acara lcw:ready dibangkitkan. Anda boleh mendengar acara ini dengan menambah pendengar acara anda sendiri pada objek tetingkap.
  • Anda tidak perlu menggunakan kaedah ini setContextProvider jika anda menggunakan startChat API SDK untuk menghantar konteks dan memulakan sesi sembang.

Sintaks

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

Parameter

Parameter_ Jenis Description
konteksPembekal Fungsi Fungsi yang apabila dipanggil, mengembalikan konteks tersuai

Nilai pulangan

Tiada

Contoh

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

Dalam kod sampel sebelumnya, value atribut mengandungi nilai pembolehubah konteks.

isDisplayable Atribut, jika ditetapkan kepada true, akan memaparkan item yang dihantar dalam tab ketiga pada Kawalan Ringkasan Perbualan untuk perbualan.

Nota

Jika tiada pembolehubah konteks telah dicipta di bawah strim kerja langsung dengan nama logik yang sepadan, maka pemboleh ubah dicipta pada masa jalan dengan jenis Rentetan. Maklumat lanjut: Pembolehubah konteks

Paparkan kekunci konteks.

Lulus layan diri pelanggan sebagai konteks

Anda boleh menyerahkan layan diri pelanggan sebagai konteks pada permulaan perbualan dengan pelanggan tersebut. Kaedah ini setContextProvider melepasi tindakan pelanggan baru-baru ini sebagai sebahagian daripada konteks dengan jenis layan diri, untuk perbualan baru antara pelanggan dan ejen. Rekod perjalanan pelawat dibuat untuk setiap tindakan layan diri.

Berikut ialah kod sampel yang menunjukkan cara menggunakan kaedah tersebut 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}
         };
    });
});

Untuk skrip sampel untuk menjejaki tindakan layan diri yang boleh disertakan dalam Portal Layan Diri, lihat Kod sampel Layan Diri.

Kod ralat

Ralat berikut boleh berlaku untuk kaedah ini.

Kod ralat Mesej ralat
1 Pelaksanaan kaedah pembekal konteks gagal

Rujukan API JavaScript untuk SDK sembang langsung
Paparkan konteks tersuai

  • Last updated on