Intercom、LiveChat & Zendesk ウィジェット連携

1. 連携の仕組み

訪問者がサイト内のチャットウィジェットからサポートに連絡しても、担当者にはユーザーの状況が分かりにくいことがあります。スクリーンショットや再現手順をお客様に求めると、手間が増えて解決が遅れます。

この問題を MousePlayer チャットメタデータ連携ブリッジ が解決します。ブラウザー内で自動のバックグラウンド監視（initChatMetadataBridge）を実行します。有効にすると、トラッキングスクリプトがページ上の Intercom、 LiveChat、 Zendesk を検出し、ワンクリックで直接再生できる URL（mouseplayer_session_url）を含むカスタム属性をチャットセッションのメタデータに自動挿入します。

2. 連携を有効にする方法

ライブチャット連携ブリッジは、コード不要のダッシュボードのスイッチ、または JavaScript 設定オブジェクトへの手動指定で有効にできます。

方法 A：ダッシュボードでコードなしに有効化（推奨）

1. MousePlayer アカウントにログインし、 プロパティに移動します。
2. 対象ドメインの横にある 設定／連携 ボタンをクリックします。
3. 連携モーダルで、 ライブチャットメタデータ連携ブリッジを有効にする を次に切り替えます： ON。
4. プロバイダー（Intercom、LiveChat、Zendesk）を選択し、 設定を保存をクリックします。変更はすべてのアクティブユーザーに直ちに適用されます。

方法 B：手動でスクリプトを設定

リモート設定ローダーを使わず MousePlayer をコードに直接記述する場合は、 chat_bridge_active: true を、次の window.mp_config オブジェクト内に渡します。

3. プロバイダーごとの技術的なデータフロー

チャットソフトウェアに応じ、MousePlayer が各プロバイダーの SDK メソッドを呼び出して、進行中の再生 URL を関連付けます。

チャットのプロバイダー	実行する JavaScript メソッド	挿入するメタデータキー
Intercom	window.Intercom('update', { ... })	mouseplayer_session_url
LiveChat	window.LiveChatWidget.call('set_session_variables', { ... })	mouseplayer_session_url
Zendesk	window.zE('webWidget', 'identify', { ... })	mouseplayer_session_url

4. 担当者の画面での表示

有効にすると、ユーザーが会話を始めるたびに、担当者のダッシュボード内にライブセッションへの直接リンクが表示されます。

1. Intercom の受信トレイ表示

担当者が Intercom で会話を開くと、右側のサイドバーの ユーザーデータ／カスタム属性 パネルにリンクが表示されます。URL をクリックすると、新しいブラウザータブで MousePlayer Theatre の再生をすぐに開けます。

2. LiveChat 担当者アプリ

LiveChat 担当者アプリで、進行中のチャットウィンドウの右側のサイドバーに移動し、 詳細 → カスタム変数 セクションを展開します。変数 mouseplayer_session_url がクリック可能なリンクとして表示されます。

3. Zendesk 担当者ワークスペース

Zendesk 担当者ワークスペースでは、チケット表示の右側にある 顧客のコンテキスト／ユーザー情報 パネルを確認します。メタデータのリンクはユーザーのカスタムプロファイルフィールドに表示され、すぐにライブで共同ブラウジングやデバッグを行えます。