본문으로 건너뛰기

웹 채팅 위젯

Web Chat 채널은 웹사이트에 채팅 창을 설치합니다. 방문자는 페이지 모서리의 채팅 버튼을 클릭해 메시지를 보냅니다. 대화는 다른 채널과 마찬가지로 MonoChat 받은편지함으로 들어오며, 팀과 플로우, AI 에이전트가 답합니다.

채널 연결​

  1. 설정 › 채팅 › 채널로 이동해 연결을 클릭합니다.
  2. Web Chat을 선택합니다.
  3. 아래 설정을 입력하고 저장합니다. 각 필드에는 용도가 설명되어 있으며, 양식 오른쪽에는 편집할 때마다 바뀌는 창 미리보기가 표시됩니다. 미리보기는 닫힌 채팅 버튼, 열린 창, 샘플 대화 사이에서 전환할 수 있습니다.
  4. 채널에 표시되는 스니펫을 복사해 웹사이트에 추가합니다(스니펫 설치 참고).

Web Chat 채널은 여러 개 연결할 수 있습니다. 예를 들어 웹사이트마다 하나씩 연결할 수 있습니다.

설정​

설정기능
채널 이름MonoChat에서 사용하는 채널 이름입니다. 위젯 제목이 비어 있으면 창의 머리글로 표시됩니다.
위젯 제목채팅 창의 머리글입니다.
부제목제목 아래 한 줄로, 보통 얼마나 빨리 답하는지 등을 표시합니다. 필드를 비우면 이 줄이 숨겨집니다.
로고제목 옆에 표시되는 이미지로, PNG, JPEG, GIF, SVG 또는 WebP 파일입니다.
색상채팅 버튼, 머리글, 방문자 메시지의 색상입니다. 그 위의 텍스트는 잘 읽히도록 검은색 또는 흰색으로 바뀝니다.
위치페이지의 오른쪽 아래 또는 왼쪽 아래입니다.
첨부 파일방문자가 최대 10MB의 이미지, 동영상, 오디오, 문서를 보낼 수 있게 합니다.
이모지 버튼메시지 입력란 옆에 자주 쓰는 이모지를 고를 수 있는 버튼을 표시합니다. 기본적으로 켜져 있습니다.
런처 숨기기채팅 버튼을 숨깁니다. JavaScript API를 사용해 직접 만든 버튼으로 창을 엽니다.
모바일 보기휴대폰에서 창이 열리는 방식입니다. 전체 화면 또는 페이지 아래쪽 4분의 3을 덮는 간단히 중에서 고릅니다.
허용 도메인창이 표시될 수 있는 사이트입니다. 정확한 호스트(www.example.com) 또는 모든 하위 도메인(*.example.com)을 지정하며, 포트(localhost:3000)는 선택입니다. 비워 두면 모든 사이트에 표시될 수 있습니다.

언어​

창의 버튼과 레이블은 방문자의 브라우저 언어를 따르며, MonoChat에 해당 언어가 없으면 영어로 표시됩니다.

위젯 제목, 부제목, 양식 소개, 동의 문구에는 워크스페이스의 언어마다 버전이 있으며, 언어는 설정 › CRM › 언어에서 지정합니다(언어 설정 참고). 필드를 클릭해 각 버전을 작성하세요. 창에는 방문자의 브라우저 언어로 된 버전이 표시되고, 그 언어의 버전이 없으면 기본 언어로 된 버전이 표시됩니다.

브라우저와 관계없이 창을 한 가지 언어로 표시하려면 JavaScript API에서 MonoChat('setLocale', 'tr-TR')를 호출하세요.

채팅 전 양식​

양식이 꺼져 있으면 방문자는 바로 메시지를 쓸 수 있습니다. 이메일 주소나 전화번호를 물으려면 플로우를 사용하세요(플로우와 위젯 참고).

양식이 켜져 있으면 창은 첫 메시지 전에 다음을 묻습니다.

필드옵션
이름끔, 선택 또는 필수
이메일끔, 선택 또는 필수
전화번호끔, 선택 또는 필수

필드 위에 표시할 문구를 작성하고, 직접 작성한 문구와 개인정보 처리방침 링크가 있는 동의 체크박스를 추가할 수도 있습니다. 체크박스를 켜면 방문자는 체크해야 채팅을 시작할 수 있습니다. 이름, 이메일 주소, 전화번호는 고객 프로필에 저장됩니다.

스니펫 설치​

채널을 연결한 직후와 채널을 편집할 때 미리보기 아래에 위젯 주소와 채널 키가 이미 채워진 스니펫이 표시됩니다. 채팅을 표시할 모든 페이지의 닫는 </body> 태그 앞에 붙여 넣으세요.

<script>
window.MonoChat = window.MonoChat || function () { (MonoChat.q = MonoChat.q || []).push(arguments) }
</script>
<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>"></script>

창은 페이지가 로드된 뒤에 로드되므로 페이지 속도를 늦추지 않습니다.

이전 WebChat에서 옮기기

사이트에 이전 WebChat 채널의 스니펫이 남아 있다면 삭제하고 그 자리에 새 Web Chat 채널의 스니펫을 붙여 넣으세요.

전체 페이지 모드​

지원 페이지처럼 채팅만을 위한 페이지를 만들려면 스니펫의 두 번째 태그에 &mode=fullpage를 추가하세요.

<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>&mode=fullpage"></script>

그러면 창이 페이지 전체를 채우고 항상 열려 있으며, 머리글과 채팅 버튼이 표시되지 않고 close와 toggle은 아무 동작도 하지 않습니다. 창은 페이지 뒤가 아니라 페이지와 함께 로드되며, 모바일 보기 설정은 적용되지 않습니다.

Google Tag Manager​

  1. 컨테이너에 Custom HTML 태그를 추가하고 스니펫을 그대로 붙여 넣습니다.
  2. All Pages 트리거나, 채팅을 표시할 페이지에서만 실행되는 트리거를 선택합니다.
  3. Submit을 클릭한 다음 Publish를 클릭합니다.

페이지의 자체 스크립트가 MonoChat을 호출한다면 태그보다 먼저 실행될 수 있습니다. 스니펫의 첫 번째 <script>도 페이지에 남겨 두면 그 호출이 창을 기다립니다.

웹사이트 빌더와 온라인 스토어​

사이트 코드를 편집할 수 없다면, 플랫폼이 모든 페이지에 코드를 넣도록 제공하는 칸(페이지 끝이나 푸터)에 스니펫을 그대로 붙여 넣으세요.

플랫폼스니펫을 넣는 곳
WordPressWPCode 플러그인을 설치하고 스니펫을 플러그인의 Footer 칸에 붙여 넣습니다. WordPress.com에서는 요금제에 따라 코드를 추가할 수 있는지가 달라집니다.
ShopifyOnline Store › Edit code: theme.liquid를 열고 </body> 바로 앞에 스니펫을 붙여 넣습니다.
WixSettings › Custom Code › Add Custom Code: 모든 페이지와 Body – end를 선택합니다. 사이트가 게시되어 있고 도메인이 연결되어 있어야 합니다.
SquarespaceCode Injection의 Footer 칸이며, Core, Plus, Advanced 요금제에서 사용할 수 있습니다.
WebflowSite settings › Custom code › Footer code에 넣은 뒤 사이트를 게시합니다.
ikasSales Channel › Extensions › Scripts › Add Script: 스니펫을 스크립트 내용으로 붙여 넣고 저장한 뒤 스크립트가 켜져 있는지 확인합니다.

JavaScript API​

스니펫은 페이지에 MonoChat 함수를 정의합니다. 직접 작성한 스크립트, 링크, 버튼에서 이 함수를 호출해 창을 제어하세요. 창이 로드되기 전에 한 호출은 준비될 때까지 기다리므로, 스니펫 바로 뒤에서 호출해도 됩니다.

명령​

호출기능
MonoChat('open')창을 엽니다.
MonoChat('close')창을 닫습니다.
MonoChat('toggle')창이 닫혀 있으면 열고, 열려 있으면 닫습니다.
MonoChat('hideLauncher')채팅 버튼을 숨깁니다. 창은 여전히 open과 toggle로 열 수 있습니다.
MonoChat('showLauncher')채팅 버튼을 다시 표시합니다.
MonoChat('setUser', { name, email, phone })방문자에 대해 이미 알고 있는 정보를 전달합니다. 로그인한 방문자를 참고하세요.
MonoChat('setLocale', 'tr-TR')브라우저 언어와 관계없이 창을 이 언어로 표시합니다. 언어를 참고하세요.
MonoChat('on', event, callback)event가 발생할 때마다 callback을 호출합니다. 이벤트를 참고하세요.

이벤트​

이벤트발생 시점callback이 받는 값
ready창이 로드되었을 때.없음
open채팅 버튼이나 호출로 창이 열릴 때.없음
close창이 닫힐 때.없음
unread읽지 않은 답장 수가 바뀔 때: 창이 닫혀 있는 동안 답장이 도착하거나 방문자가 창을 열 때.읽지 않은 답장 수

ready를 놓치지 않도록 콜백은 스니펫 바로 뒤에 등록하세요.

로그인한 방문자​

방문자가 사이트에 로그인한 경우 setUser로 방문자 정보를 전달하세요. 모든 필드는 선택 사항이며, 창은 name, email, phone만 읽습니다.

  • 채팅 전 양식이 이 정보로 채워집니다. 양식이 묻는 항목이 모두 있으면 건너뛰지만, 동의 체크박스가 켜져 있으면 건너뛰지 않습니다. 체크박스는 항상 방문자가 직접 체크합니다.
  • 정보는 MonoChat의 고객 프로필에 저장되므로, 팀에서 누가 메시지를 보내는지 알 수 있습니다.
  • 이메일 주소나 전화번호가 유효하지 않으면 어떤 정보도 저장되지 않습니다.

예시​

직접 만든 버튼으로 창을 열고 채팅 버튼을 숨깁니다.

<button onclick="MonoChat('open')">채팅 상담</button>
<script>
MonoChat('hideLauncher')
</script>

로그인한 사용자 정보를 전달하고 페이지 언어로 창을 표시합니다.

<script>
MonoChat('setUser', { name: 'Jane Doe', email: 'jane@example.com', phone: '+1 555 010 0000' })
MonoChat('setLocale', document.documentElement.lang)
</script>

읽지 않은 답장 수를 직접 만든 버튼에 표시합니다.

<button onclick="MonoChat('open')">고객지원 <span id="chat-unread"></span></button>
<script>
MonoChat('hideLauncher')
MonoChat('on', 'unread', function (count) {
document.getElementById('chat-unread').textContent = count || ''
})
</script>

방문자가 창을 열면 분석 도구로 이벤트를 보냅니다.

<script>
MonoChat('on', 'open', function () {
gtag('event', 'chat_opened')
})
</script>

대화​

방문자는 각각 MonoChat의 고객이 되며, 대화는 방문자의 브라우저에 보관됩니다. 같은 브라우저로 다시 방문하면 마지막 메시지 후 90일 동안 최근 200개의 메시지가 보입니다. 다른 브라우저나 기기에서는 새 대화가 시작됩니다. 팀의 답변과 입력 중 표시는 창에 바로 나타납니다.

메시지 입력란 옆의 이모지 버튼에서 자주 쓰는 이모지를 고를 수 있습니다. 방문자는 키보드로 어떤 이모지든 입력할 수도 있습니다.

방문자가 보낸 메시지에는 WhatsApp처럼 체크 표시가 붙습니다. 메시지가 전송되면 회색 체크 하나, MonoChat에 도착하면 회색 체크 둘, 팀원 중 누군가 대화를 열면 파란 체크 둘이 표시됩니다. MonoChat에서는 방문자의 창이 답장을 받으면 전달됨으로, 방문자가 창을 열면 읽음으로 표시됩니다.

창이 닫혀 있을 때 새 답변이 오면 채팅 버튼에 읽지 않은 메시지 수가 표시되고 짧은 알림음이 재생됩니다. 브라우저는 방문자가 페이지의 어딘가를 클릭하거나 입력한 뒤에만 소리를 재생합니다.

메시지 유형​

창은 MonoChat 채팅 화면과 같은 방식으로 메시지를 표시합니다. 답장 위에는 상담원 이름이, 날짜가 바뀌는 곳에는 날짜 줄이, 각 말풍선 안에는 시간이 표시되며, 방문자 메시지에는 체크 표시가 붙습니다.

텍스트, 이모지, 파일 외에도 답장에 아래 유형을 사용할 수 있습니다. 메시지 보내기 플로우 노드, 단문 메시지, 앱, 함수에서 보내세요(메시지 유형 참고).

유형창에 표시되는 방식
이미지, 동영상, 오디오, 스티커말풍선 안에 표시됩니다.
문서파일 형식과 이름이 있는 카드로, 클릭하면 파일을 다운로드합니다.
빠른 답장마지막 메시지 아래의 버튼입니다. 클릭하면 버튼 제목이 방문자의 답장으로 전송됩니다.
버튼선택 사항인 머리글(텍스트, 이미지, 동영상 또는 문서), 바닥글, 버튼이 있는 메시지입니다. 버튼은 답장을 보내거나 웹 주소를 열거나 전화번호로 전화를 겁니다.
CTA URL웹 주소를 여는 버튼 하나가 있는 메시지입니다.
목록섹션별로 묶인 행이 말풍선 안에 표시됩니다. 행을 클릭하면 그 행이 방문자의 답장으로 전송됩니다.
캐러셀방문자가 옆으로 스크롤하는 카드로, 각 카드에 이미지 또는 동영상, 제목, 부제목, 버튼이 있습니다.
위치장소 이름과 주소가 있는 핀으로, 클릭하면 Google Maps에서 그 장소가 열립니다.
위치 요청위치 보내기 버튼입니다. 브라우저가 방문자에게 권한을 요청한 뒤, 방문자의 위치가 위치 메시지로 MonoChat에 도착합니다.
연락처각 연락처의 이름과 회사가 표시되며, 전화번호로 전화를 걸고 이메일 주소로 메일을 쓰는 링크가 있습니다.

빠른 답장, 답장 버튼, 목록 행, 위치 요청은 마지막 메시지에서만 작동하므로 방문자가 지난 질문에 답할 수 없습니다.

버튼 아이콘​

웹 주소를 여는 버튼에는 아이콘을 표시할 수 있습니다. CTA URL 메시지나 웹 URL 버튼의 아이콘 필드에서 고르세요. 이 필드는 Web Chat용으로 메시지를 만들 때만 나타나며, 다른 채널에서는 아이콘이 표시되지 않습니다. 아이콘은 링크, 웹사이트, WhatsApp, Instagram, Messenger, Facebook, Telegram, TikTok, 전화, 이메일, 위치이며, 아이콘이 없는 버튼에는 링크 아이콘이 표시됩니다.

플로우와 위젯​

환영 메시지, 영업시간, 영업시간 외 답변, 이메일 주소나 전화번호 요청, 선제 메시지는 채널 설정이 아니라 플로우로 설정합니다.

고객 액션 수신됨 이벤트는 창에서 플로우를 시작합니다.

  • 채팅 위젯 처음 열림: 열린 대화가 없는 방문자가 창을 엽니다. MonoChat이 대화를 시작하거나 닫힌 대화를 다시 열므로, 방문자보다 먼저 플로우가 방문자에게 메시지를 보낼 수 있습니다. 대화가 열려 있는 동안 창을 다시 열어도 다시 발생하지 않습니다.
  • 채팅 위젯 열림: 방문자가 창을 열 때마다 발생하며, 처음 열 때도 포함됩니다. 열린 대화가 없는 방문자에게는 위와 같이 대화가 시작됩니다.
  • 채팅 위젯 닫힘: 열린 대화 중에 방문자가 창을 닫습니다.

채팅 전 양식이 켜져 있으면 방문자가 양식을 작성한 시점에 창이 열린 것으로 간주됩니다.

위젯이 있는 페이지를 보기만 해서는 어느 것도 발생하지 않습니다. 아직 메시지를 쓰지 않은 방문자는 이 액션을 기다리는 플로우가 있을 때만 MonoChat의 고객이 됩니다.

전체 페이지 모드에서는 페이지와 함께 창이 열리므로, 페이지를 불러오면 창을 연 것으로 간주됩니다. 각 채널은 1분에 최대 60번의 창 열기만 집계하며, 이를 넘는 열기는 플로우를 시작하지 않습니다.

방문자를 맞이하려면 고객 액션 수신됨을 채팅 위젯 처음 열림으로 설정한 플로우를 만들고, 환영 메시지를 담은 메시지 보내기 노드를 추가하세요. 메시지는 메시지 빌더로 만들며, 답장 버튼, 목록 또는 아이콘이 있는 링크를 넣을 수 있습니다.

Powered by MonoChat​

창에는 MonoChat 로고와 함께 작은 Powered by 문구가 표시됩니다. 채널 설정이 아니며, MonoChat 설치 전체에 대해서만 숨길 수 있습니다.