Hantar konteks tersuai semasa sembang langsung

Konteks tersuai ialah koleksi pasangan kunci atau nilai. Hanya nilai primitif dibenarkan untuk mana-mana kunci. Kekunci mesti sepadan dengan pembolehubah konteks yang dicipta untuk aliran kerja yang berkaitan. Jika tiada pembolehubah konteks telah dicipta di bawah strim kerja langsung dengan nama logik yang sepadan, pembolehubah dicipta pada masa jalan dengan mengandaikan jenis sebagai Rentetan. Pembekal konteks tersuai akan digunakan oleh widget sembang langsung apabila sembang baharu dimulakan. Oleh kerana nilainya sensitif huruf besar, gunakan padanan tepat untuk menyampaikannya kepada pembolehubah konteks. Maklumat lanjut: Pertimbangan untuk pembolehubah konteks

Penting

• Untuk sembang yang disahkan, anda juga boleh menghantar konteks dalam Token Web JSON (JWT). Ketahui lebih lanjut dalam Hantar token pengesahan.
• Anda boleh lulus hanya 100 pembolehubah konteks tersuai semasa setiap sesi sembang.

Apabila pelanggan memulakan sembang daripada portal, anda boleh menghantar konteks tersuai kepada Dynamics 365 Contact Center. Konteks tersuai ini boleh digunakan untuk memaparkan maklumat pada antara muka pengguna dan untuk mencipta peraturan penghalaan yang akhirnya menentukan baris gilir yang anda mesti menghalakan sembang.

Ikut langkah ini untuk menghantar konteks tersuai apabila anda memulakan sembang:

1. Kaedah SDK sembang langsung hendaklah digunakan selepas acara acara lcw:ready dibangkitkan. Anda boleh mendengar acara ini dengan menambah pendengar acara anda sendiri pada objek tetingkap.
2. Selepas lcw:ready acara dibangkitkan, daftarkan pembekal konteks tersuai dengan sembang langsung menggunakan kaedah setContextProvider .
3. Mulakan sembang menggunakan kaedah startChat .

Kod sampel

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 maklumat tentang cara memaparkan pembolehubah konteks dalam Ringkasan perbualan, lihat Paparkan konteks tersuai.

Maklumat berkaitan

setContextProvider
getContextProvider
removeContextProvider
Rujukan API JavaScript SDK sembang langsung
Konfigurasikan pembolehubah konteks untuk bot