Kohandatud konteksti saatmine reaalajas vestluse ajal

Kohandatud kontekst on võtme- või väärtuspaaride kogum. Iga võtme jaoks on lubatud ainult primitiivsed väärtused. Võtmed peavad vastama kontekstimuutujatele, mis on loodud seotud töövoo jaoks. Kui reaalajas töövoos ei ole loodud ühtegi kontekstimuutujat, millel on vastav loogiline nimi, luuakse käitusajal muutujad, eeldades, et tüübiks on String. Uue vestluse alustamisel kutsub reaalajas vestluse vidin kohandatud konteksti pakkuja välja. Kuna väärtused on tõstutundlikud, kasutage nende edastamiseks kontekstimuutujatele täpset vastet. Lisateave: Kontekstimuutujate kaalutlused

Oluline

  • Autentitud vestluse jaoks saad konteksti edastada ka JSON Web Tokenis (JWT). Lisateavet leiate teemast Autentimistõendite saatmine.
  • Iga vestlusseansi ajal saate edastada ainult 100 kohandatud kontekstimuutujat.

Kui klient alustab portaalist vestlust, saate edastada kohandatud konteksti Dynamics 365 Contact Center'ile. Seda kohandatud konteksti saab kasutada teabe kuvamiseks kasutajaliideses ja marsruutimisreeglite loomiseks, mis määravad lõpuks järjekorra, kuhu peate vestlused suunama.

Vestluse alustamisel kohandatud konteksti saatmiseks toimige järgmiselt.

  1. Reaalajas vestluse SDK meetodid tuleks käivitada pärast sündmuse lcw:ready tõstatamist. Saate seda sündmust kuulata, lisades aknaobjektile oma sündmuse kuulaja.
  2. Pärast sündmuse lcw:ready tõstatamist registreerige kohandatud konteksti pakkuja reaalajas vestlusega, kasutades meetodit setContextProvider .
  3. Alustage vestlustmeetodi startChat abil.

Näidiskood

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

Lisateavet kontekstimuutujate kuvamise kohta vestluse kokkuvõttes leiate teemast Kohandatud konteksti kuvamine.

setContextProvider
getContextProvider
removeContextProvider
Reaalajas vestluse SDK JavaScripti API viide
Roboti kontekstimuutujate konfigureerimine