Intercom, LiveChat 및 Zendesk 위젯

1. 연동 작동 방식

방문자가 사이트 채팅 위젯으로 문의하면 상담원은 실제 상황을 이해하기 어려울 수 있습니다. 스크린샷이나 재현 단계를 요청하면 마찰이 생기고 해결이 늦어집니다.

이 MousePlayer 채팅 메타데이터 브리지 는 브라우저 안에서 자동 백그라운드 감시기(initChatMetadataBridge)를 실행하여 해결합니다. 활성화 후 스크립트는 페이지에 Intercom, LiveChat또는 Zendesk 가 있는지 감지하여 클릭 한 번으로 재생하는 직접 URL(mouseplayer_session_url)을 사용자 정의 속성으로 채팅 세션 메타데이터에 삽입합니다.

지연 없음 & 자동 재시도: 라이브 채팅 위젯은 페이지 로드 뒤 비동기로 로드되는 경우가 많아 3초마다 다시 확인하여 경쟁 상태 없이 링크를 붙입니다.

2. 활성화 방법

코드가 필요 없는 대시보드 스위치 또는 JavaScript 설정 객체로 활성화할 수 있습니다.

방법 A: 대시보드 활성화(코드 불필요, 권장)

MousePlayer에 로그인하여 내 속성을 여세요.
대상 도메인 옆의 설정 / 연동 버튼을 클릭하세요.
연동 창의 라이브 채팅 메타데이터 브리지 활성화 를 ON으로 전환하세요.
제공업체(Intercom, LiveChat 또는 Zendesk)를 고르고 설정 저장을 클릭하세요. 모든 활성 사용자에게 즉시 적용됩니다.

방법 B: 수동 스크립트 설정

원격 설정 로더 없이 MousePlayer를 하드코딩하면 chat_bridge_active: true 를 window.mp_config 객체 안에 전달하세요:

<script> window.mp_config = { channel: 'YOUR_CHANNEL_ID', chat_bridge_active: true, chat_provider: 'intercom' // 'intercom', 'livechat', or 'zendesk' }; </script>

3. 제공업체별 기술적 데이터 흐름

채팅 소프트웨어에 맞는 제공업체 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 극장 재생을 즉시 엽니다.

2. LiveChat 상담원 앱

LiveChat 상담원 앱의 활성 채팅 창 오른쪽 사이드바에서 세부 정보 → 사용자 정의 변수 를 펼치세요. 다음 변수는 mouseplayer_session_url 클릭 가능한 링크로 표시됩니다.

3. Zendesk Agent Workspace

Zendesk Agent Workspace의 티켓 오른쪽에 있는 고객 컨텍스트 / 사용자 정보 패널을 확인하세요. 링크는 사용자의 사용자 정의 프로필 필드에 표시되어 실시간 공동 탐색과 디버깅이 가능합니다.

무엇을 도와드릴까요?