チャットを開始する

チャットを開始するには、次の手順に従ってください:

  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 リファレンス
チャット ウィジェットのカスタマイズ
チャットを積極的に開始する