Démarrer une discussion

Suivez ces étapes pour démarrer une discussion :

1. Écoutez l’événement lcw :ready déclenché par un chat en direct pour commencer à utiliser les méthodes SDK de chat en direct. Les méthodes 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é, appelez la méthode startChat pour démarrer une conversation.

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

Imaginons que le client se trouve sur la page de votre portail et que vous souhaitiez démarrer une conversation après que le client a passé un certain temps sur la page. Vous pouvez ouvrir le widget de chat par programmation une fois le temps spécifié écoulé.

L’exemple de code suivant montre comment vous pouvez démarrer une conversation après que le client a attendu pendant 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 chat personnalisé

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

Exemple d’extrait de code pour masquer le bouton de chat 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>

Informations connexes

startChat
Référence de l’API JavaScript pour le SDK Live Chat
Personnaliser le widget de chat
Démarrer un chat de manière proactive