Canlı sohbet sırasında özel bağlam gönderme

Özel bağlam, anahtar veya değer çiftlerinden oluşan bir koleksiyondur. Herhangi bir anahtar için yalnızca temel değerlere izin verilir. Anahtarlar, ilişkili iş akışı için oluşturulan bağlam değişkenlerine karşılık gelmelidir. Canlı iş akışı altında eşleşen bir mantıksal ada sahip hiçbir bağlam değişkeni oluşturulmamışsa, değişkenler çalışma zamanında türün String olduğu varsayılarak oluşturulur. Özel bağlam sağlayıcısı, yeni bir sohbet başlatıldığında canlı sohbet widget'ı tarafından çağrılır. Değerler büyük/küçük harfe duyarlı olduğundan, bunları bağlam değişkenlerine geçirmek için tam eşleşmeyi kullanın. Daha fazla bilgi: Bağlam değişkenleriyle ilgili dikkat edilmesi gerekenler

Önemli

• Doğrulanmış sohbet için, JSON Web Token'da (JWT) bağlam da iletebilirsiniz. Daha fazla bilgi: Kimlik doğrulama belirteçlerini gönderme.
• Her sohbet oturumu sırasında yalnızca 100 özel bağlam değişkeni geçirebilirsiniz.

Bir müşteri portaldan bir sohbet başlattığında, Müşteri Hizmetleri için Çok Yönlü Kanal'a özel bağlam geçirebilirsiniz. Bu özel bağlam, kullanıcı arayüzünde bilgi görüntülemek ve sonunda sohbetleri yönlendirmeniz gereken kuyruğu belirleyen yönlendirme kuralları oluşturmak için kullanılabilir.

Bir sohbet başlattığınızda özel bağlam göndermek için şu adımları izleyin:

1. Canlı sohbet SDK yöntemleri, lcw:ready olay olayı tetiklendikten sonra çağrılmalıdır. Pencere nesnesine kendi olay dinleyicinizi ekleyerek bu olayı dinleyebilirsiniz.
2. lcw:ready Olay tetiklendikten sonra, setContextProvider yöntemini kullanarak canlı sohbete özel bir bağlam sağlayıcısı kaydedin.
3. startChat yöntemini kullanarak sohbeti başlatın.

Örnek kodu

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

Konuşma özetinde bağlam değişkenlerinin nasıl görüntüleneceği hakkında daha fazla bilgi için bkz: Özel bağlamı görüntüleme.

İlgili bilgiler

setContextProvider
getContextProvider
removeContextProvider
Canlı sohbet SDK'sı JavaScript API referansı
Bot için bağlam değişkenlerini yapılandırma