Odeslání vlastního kontextu během živého chatu

Vlastní kontext je kolekce párů klíčů nebo hodnot. Pro každý klíč jsou povoleny pouze primitivní hodnoty. Klíče musí odpovídat kontextovým proměnným, které jsou vytvořeny pro přidružený tok práce. Pokud nebyly v živém toku práce vytvořeny žádné kontextové proměnné s odpovídajícím logickým názvem, proměnné se vytvoří za běhu a převezmou typ Řetězec. Widget živého chatu vyvolá vlastního poskytovatele kontextu při zahájení nového chatu. Protože hodnoty rozlišují velká a malá písmena, použijte přesnou shodu k jejich předání kontextovým proměnným. Další informace: Důležité informace o kontextových proměnných

Důležité

• Pro autentizovaný chat můžete také předávat kontext v JSON Web Tokenu (JWT). Další informace: Odeslání tokenů ověřování.
• Během každé relace chatu můžete předat pouze 100 vlastních kontextových proměnných.

Když zákazník zahájí chat z portálu, můžete do Omnikanálu pro Customer Service předat vlastní kontext. Tento vlastní kontext lze použít k zobrazení informací v uživatelském rozhraní a k vytvoření pravidel směrování, která nakonec určí frontu, do které musíte chaty směrovat.

Při zahájení chatu odešlete vlastní kontext podle následujících kroků:

1. Metody sady SDK pro živý chat by měly být vyvolány po vyvolání události lcw:ready . Tuto událost můžete poslouchat přidáním vlastního posluchače událostí na objekt window.
2. lcw:ready Po vyvolání události zaregistrujte vlastního poskytovatele kontextu s živým chatem pomocí metody setContextProvider.
3. Spusťte chat pomocí metody startChat .

Ukázkový kód

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

Informace o tom, jak zobrazit kontextové proměnné v souhrnu konverzace, naleznete v tématu Zobrazení vlastního kontextu.

Související informace

Poskytovatel setContextProvider
Poskytovatel getContextProvider
Poskytovatel removeContextProvider
Referenční informace k rozhraní API sady SDK JavaScript pro živý chat
Konfigurace kontextových proměnných pro robota