Siųsti pasirinktinį kontekstą tiesioginio pokalbio metu

Pasirinktinis kontekstas yra raktų arba reikšmių porų rinkinys. Bet kuriam raktui leidžiamos tik primityvios reikšmės. Raktai turi atitikti konteksto kintamuosius, sukurtus susietam darbo srautui. Jei tiesioginiame darbo sraute nebuvo sukurta konteksto kintamųjų su atitinkančiu loginiu pavadinimu, kintamieji sukuriami vykdymo metu, darant prielaidą, kad jų tipas yra Eilutė. Pasirinktinio konteksto teikėjas bus iškviečiamas tiesioginio pokalbio valdiklio, kai pradedamas naujas pokalbis. Kadangi reikšmėse skiriamos didžiosios ir mažosios raidės, naudokite tikslią atitiktį, kad perduotumėte jas konteksto kintamiesiems. Daugiau informacijos: Konteksto kintamųjų svarstymai

Svarbu

  • Autentifikuotam pokalbiui taip pat galite perduoti kontekstą JSON žiniatinklio prieigos rakte (JWT). Sužinokite daugiau skiltyje Siųsti autentifikavimo atpažinimo ženklus.
  • Kiekvienos pokalbio sesijos metu galite perduoti tik 100 tinkintų konteksto kintamųjų.

Kai klientas pradeda pokalbį iš portalo, galite perduoti pasirinktinį kontekstą "Dynamics 365 Contact Center". Šis pasirinktinis kontekstas gali būti naudojamas norint rodyti informaciją vartotojo sąsajoje ir kurti maršruto parinkimo taisykles, kurios galiausiai nustato eilę, į kurią turite nukreipti pokalbius.

Norėdami siųsti pasirinktinį kontekstą, kai pradedate pokalbį, atlikite šiuos veiksmus:

  1. Tiesioginio pokalbio SDK metodai turėtų būti iškviesti iškėlus įvykį lcw:ready . Šio įvykio galite klausytis įtraukdami savo įvykio klausyklą į lango objektą.
  2. Iškėlus lcw:ready įvykį, užregistruokite pasirinktinį konteksto teikėją tiesioginiame pokalbyje naudodami metodą setContextProvider .
  3. Pradėkite pokalbį naudodami startChat metodą.

Pavyzdžio kodas

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

Informacijos apie tai, kaip rodyti konteksto kintamuosius pokalbio suvestinėje, ieškokite Pasirinktinio konteksto rodymas.

setContextProvider
getContextProvider
removeContextProvider
Tiesioginio pokalbio SDK JavaScript API nuoroda
Roboto konteksto kintamųjų konfigūravimas