Kirim konteks khusus selama live chat

Konteks kustom adalah kumpulan pasangan kunci atau nilai. Hanya nilai primitif yang diizinkan untuk kunci apa pun. Kunci harus sesuai dengan variabel konteks yang dibuat untuk aliran kerja terkait. Jika tidak ada variabel konteks yang dibuat di bawah aliran kerja langsung dengan nama logis yang cocok, variabel dibuat pada runtime dengan asumsi jenis sebagai String. Penyedia konteks kustom akan dipanggil oleh widget obrolan langsung saat obrolan baru dimulai. Karena nilainya peka huruf besar/kecil, gunakan pencocokan persis untuk meneruskannya ke variabel konteks. Informasi selengkapnya: Pertimbangan untuk variabel konteks

Penting

• Untuk obrolan yang diautentikasi, Anda juga dapat meneruskan konteks di JSON Web Token (JWT). Pelajari lebih lanjut di Mengirim token autentikasi.
• Anda hanya dapat meneruskan 100 variabel konteks kustom selama setiap sesi chat.

Saat pelanggan memulai obrolan dari portal, Anda dapat meneruskan konteks kustom ke Dynamics 365 Contact Center. Konteks kustom ini dapat digunakan untuk menampilkan informasi pada antarmuka pengguna dan untuk membuat aturan perutean yang pada akhirnya menentukan antrean tempat Anda harus merutekan obrolan.

Ikuti langkah-langkah berikut untuk mengirim konteks khusus saat Anda memulai chat:

1. Metode SDK obrolan langsung harus dipanggil setelah peristiwa peristiwa lcw:ready diangkat. Anda dapat mendengarkan peristiwa ini dengan menambahkan pemroses peristiwa Anda sendiri pada objek jendela.
2. Setelah lcw:ready peristiwa diangkat, daftarkan penyedia konteks kustom dengan obrolan langsung menggunakan metode setContextProvider .
3. Mulai obrolan menggunakan metode startChat .

Contoh kode

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': 'contextValue1', // string value
			'contextKey2': 12.34, // number value
			'contextKey3': true // boolean value
	};
}

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
	// Handle LiveChat Ready event
	// SDK methods are ready for use now
	// Setting custom context provider to be used with Chat for Dynamics 365
	// The custom context provided by custom context provider can be used for routing the chat to a particular queue
	Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(contextProvider);
	// Starting a new chat
	Microsoft.Omnichannel.LiveChatWidget.SDK.startChat();
});

window.addEventListener("lcw:error", function handleLivechatErrorEvent(errorEvent){
	// Handle LiveChat SDK error event
	console.log(errorEvent);
});

Untuk informasi tentang cara menampilkan variabel konteks dalam Ringkasan percakapan, lihat Menampilkan konteks kustom.

Informasi terkait

setContextProvider
getContextProvider
removeContextProvider
Referensi API JavaScript SDK obrolan langsung
Mengonfigurasi variabel konteks untuk bot