共用方式為


開始聊天

請依照以下步驟開始聊天:

  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>

開始聊天
即時聊天 SDK 的 JavaScript API 參考
自定義聊天小部件
主動開始聊天