Starten eines Chats

Gehen Sie folgendermaßen vor, um einen Chat zu starten:

1. Hören Sie sich das lcw:ready-Ereignis an, das von einem Livechat ausgelöst wird, um mit der Verwendung der Livechat-SDK-Methoden zu beginnen. Die Live-Chat-Methoden sollten aufgerufen werden, nachdem das lcw:ready-Ereignis ausgelöst wurde. Sie können auf dieses Ereignis lauschen, indem Sie dem window-Objekt einen eigenen Ereignis-Listener hinzufügen.

2. Rufen Sie nach dem Auslösen des lcw:ready-Ereignisses die startChat-Methode auf, um einen Chat zu starten.

   Informationen zum Authentifizieren eines Kunden beim Starten eines Chats finden Sie unter Senden eines Authentifizierungstokens.

   Informationen zum proaktiven Starten eines Chats in Abhängigkeit von verschiedenen Kundenszenarien in Ihrer Organisation finden Sie unter Proaktives Starten eines Chats.

Beispielcode

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

Stellen Sie sich ein Szenario vor, in dem sich der Kunde auf Ihrer Portalseite befindet und Sie einen Chat starten möchten, nachdem der Kunde einige Zeit auf der Seite verbracht hat. Sie können das Chat-Widget nach Ablauf der angegebenen Zeit programmgesteuert öffnen.

Der folgende Beispielcode zeigt, wie Sie einen Chat starten können, nachdem der Kunde 5 Minuten gewartet hat:

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

Benutzerdefinierte Chat-Schaltfläche verwenden

Um eine benutzerdefinierte Chat-Schaltfläche anstelle der vordefinierten Chat-Schaltfläche zu verwenden, fügen Sie das Attribut data-hide-chat-button im Widget-Snippet hinzu und legen Sie seinen Wert auf truefest. Rufen Sie die startChat-Methode auf, wenn Sie auf die benutzerdefinierte UI-Komponente klicken, um den Chat zu starten.

Beispielcodeausschnitt zum Ausblenden der Standardchatschaltfläche

<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>

Verwandte Informationen

startChat
JavaScript-API-Referenz für das Live Chat SDK
Chat-Widget anpassen
Proaktiv einen Chat starten