Envoyer un contexte personnalisé pendant le chat en direct

Le contexte personnalisé est une collection de paires de clés ou de valeurs. Seules les valeurs primitives sont autorisées pour une clé. Les clés doivent correspondre à des variables de contexte créées pour le flux de travail associé. Si aucune variable de contexte n’a été créée dans le cadre d’un flux de travail en direct avec un nom logique correspondant, les variables sont créées au moment de l’exécution en prenant le type String. Le fournisseur de contexte personnalisé est appelé par le widget de chat en direct lorsqu’un nouveau chat est démarré. Étant donné que les valeurs sont sensibles à la casse, utilisez la correspondance exacte pour les transmettre aux variables de contexte. Pour plus d’informations : Considérations relatives aux variables de contexte

Lorsqu’un client démarre une conversation à partir du portail, vous pouvez transmettre un contexte personnalisé à Omnicanal pour Customer Service. Ce contexte personnalisé peut être utilisé pour afficher des informations sur l’interface utilisateur et pour créer des règles de routage qui déterminent finalement la file d’attente vers laquelle vous devez acheminer les conversations.

Suivez ces étapes pour envoyer un contexte personnalisé lorsque vous démarrez une discussion :

1. Les méthodes SDK de chat en direct doivent être appelées après le déclenchement de l’événement lcw :ready . Vous pouvez écouter cet événement en ajoutant votre propre écouteur d’événements sur l’objet window.
2. Une fois l’événement lcw:ready déclenché, enregistrez un fournisseur de contexte personnalisé avec le chat en direct à l’aide de la méthode setContextProvider .
3. Démarrez le chat à l’aide de la méthode startChat .

Exemple de code

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

Pour plus d’informations sur l’affichage des variables de contexte dans le résumé de la conversation, voir Afficher le contexte personnalisé.

Informations connexes

setContextProvider
getContextProvider
removeContextProvider
Référence de l’API JavaScript du SDK de chat en direct
Configurer les variables de contexte d’un bot