Envoyer un contexte personnalisé lors d’une conversation instantanée

Le contexte personnalisé désigne un ensemble de paires de clés ou valeurs. Seules les valeurs primitives sont autorisées pour n’importe quelle clé. Les clés doivent correspondre aux variables de contexte créées pour le flux de travail associé. Si aucune variable de contexte n’a été créée dans le flux de travail en direct avec un nom logique correspondant, les variables sont créées au moment de l’exécution en supposant que le type est Chaîne. Le fournisseur de contexte personnalisé serait appelé par le widget de conversation instantanée en direct au début d’une nouvelle conversation instantanée. Comme les valeurs sont sensibles à la casse, utilisez une correspondance exacte pour les transmettre aux variables de contexte. Pour en savoir plus : Considérations des variables de contexte

Important

• Le setContextProvider est pris en charge uniquement pour les conversations instantanées non authentifiées. Pour une conversation instantanée authentifiée, vous devez utiliser le jeton Web JSON (JWT). Pour plus d’informations : Envoyer des jetons d’authentification
• Vous ne pouvez transmettre que 100 variables de contexte personnalisées lors de chaque session de conversation instantanée.

Lorsqu’un client démarre une conversation depuis le portail, vous pouvez transmettre le 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 d’acheminement qui déterminent la file d’attente vers laquelle acheminer les conversations.

Procédez comme suit pour envoyer le contexte personnalisé au lancement d’une conversation instantanée :

1. Les méthodes du SDK de conversation instantanée en direct doivent être appelées une fois l’événement lcw:ready déclenché. Vous pouvez écouter cet événement en ajoutant votre propre écouteur d’événement sur l’objet de la fenêtre.
2. Après que l’événement lcw:ready a été déclenché, enregistrez un fournisseur de contexte personnalisé avec la conversation instantanée à l’aide de la méthode setContextProvider.
3. Démarrez la conversation en utilisant 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é des conversations, consultez Afficher le contexte personnalisé.

Voir aussi

setContextProvider
getContextProvider
removeContextProvider
Référence de l’API JavaScript pour le kit de développement logiciel de la conversation instantanée en direct
Configurer des variables de contexte pour un bot