开始聊天

请按照以下步骤开始聊天:

  1. 侦听实时聊天引发的 lcw:ready 事件,以开始使用 实时聊天 SDK 方法。 应在引发 lcw:ready 事件后调用实时聊天方法。 您可以通过在窗口对象上添加自己的事件侦听器来监听此事件。

  2. 引发 lcw:ready 事件后,调用 startChat 方法开始聊天。

    若要在开始聊天时对客户进行身份验证,请参阅 发送身份验证令牌

    若要根据组织中的各种客户方案主动启动聊天,请参阅主动 开始聊天

代码示例

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

考虑这样一个场景:客户在您的门户页面上,并且您希望在客户在页面上花费一段时间后开始聊天。 您可以在指定时间过去后以编程方式打开聊天小组件。

以下示例代码演示如何在客户等待 5 分钟后开始聊天:

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

使用自定义聊天按钮

要使用自定义聊天按钮而不是现成的聊天按钮,请在小组件代码段中添加属性 data-hide-chat-button 并将其值 true设置为 。 单击自定义 UI 组件时调用 startChat 方法以开始聊天。

隐藏标准聊天按钮的示例代码片段

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

startChat
实时聊天 SDK 的 JavaScript API 参考
自定义聊天小部件
主动开始聊天