Partager via

Démarrer une conversation instantanée

  • Article

Procédez comme suit pour démarrer une conversation instantanée :

  1. Écoutez l’événement lcw:readylancé par une conversation instantanée pour commencer à utiliser les méthodes du kit de développement logiciel de conversation instantanée en direct. Les méthodes 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. Une fois que l’événement lcw:ready est lancé, appelez la méthode startChat pour lancer une conversation instantanée.

    Pour authentifier un client lorsque vous démarrez une conversation, consultez Envoyer un jeton d’authentification.

    Pour démarrer une conversation de manière proactive en fonction de divers scénarios client dans votre organisation, consultez Démarrer une conversation de manière proactive.

Exemple de code

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
	// Handle LiveChat SDK ready event
	// SDK methods are ready for use now
	// Initiate a chat using startChat SDK
	Microsoft.Omnichannel.LiveChatWidget.SDK.startChat();
});

window.addEventListener("lcw:error", function handleLivechatErrorEvent(errorEvent){
	// Handle LiveChat error event
	console.log(errorEvent);
});

Prenons le cas d’un scénario où le client est sur la page de votre portail et où vous souhaitez lancer une conversation instantanée une fois que le client est sur la page depuis un moment. Vous pouvez ouvrir de façon programmée le widget de la conversation instantanée une fois que le temps spécifié s’est écoulé.

L’exemple de code suivant montre comment vous pouvez démarrer une conversation instantanée une fois que le client attend depuis 5 minutes :

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
    // Open chat widget proactively after customer has been waiting for 5 minutes
    setTimeout(function startProactiveChat() {
        Microsoft.Omnichannel.LiveChatWidget.SDK.startChat();
    }, 300000);
});

Utiliser le bouton de conversation personnalisée

Pour utiliser un bouton de conversation instantané personnalisé au lieu du bouton de conversation instantané prêt à l’emploi, ajoutez l’attribut data-hide-chat-button dans l’extrait de code de widget et définissez sa valeur sur true. Appelez la méthode startChat en cliquant sur le composant d’interface utilisateur personnalisé pour démarrer la conversation.

Exemple d’extrait de code pour masquer le bouton de conversation standard

<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-hide-chat-button="true"></script>

Voir aussi

startChat
Référence d’API JavaScript pour le kit de développement logiciel de conversation instantanée en direct
Personnaliser le widget de conversation instantanée
Démarrer une conversation de manière proactive