웹 채팅 위젯

웹 채팅 위젯

웹 채팅 위젯은 <script> 태그 하나로 어느 웹 페이지에나 붙일 수 있는 채팅 말풍선입니다. 방문자는 여러분의 AI와 대화하고, 사람이 넘겨받으면 그 답변도 같은 말풍선 안에 — 실시간으로 — 나타납니다.

사이트에 추가하기

닫는 </body> 태그 바로 앞에 스니펫을 붙여 넣습니다.

<script src="https://blz.actionbridge.io/support/widget.js" data-key="wk_your_key_here"></script>

위젯은 자체 프레임 안에서 로드되므로 사이트의 스타일이나 스크립트와 충돌하지 않습니다.

옵션

속성 하는 일
data-key 필수입니다. Settings에서 가져온 데스크의 위젯 키입니다.
data-position right(기본값) 또는 left — 말풍선이 어느 모서리에 놓일지 정합니다.
data-offset 모서리로부터의 픽셀 값입니다(기본값 20).
data-lang 위젯의 언어를 고정합니다. 예: ja. 지정하지 않으면 방문자마다 자신의 브라우저 언어로 보입니다.

페이지의 같은 모서리에 reCAPTCHA 배지가 있으면 위젯이 자동으로 그 위로 올라가 서로 겹치지 않습니다.

위젯은 어떤 언어로 말하나

그대로 두면 위젯은 방문자 각자의 브라우저 언어를 따릅니다. 영어 사이트를 찾은 일본어 방문자에게는 일본어 말풍선이 보입니다. 설정할 것은 없으며, 같은 페이지의 방문자마다 서로 다른 언어로 보일 수 있습니다.

대신 언어 하나로 고정하려면 — 누가 읽든 하나의 시장을 상대하는 사이트라면 — data-lang을 추가합니다.

<script src="https://blz.actionbridge.io/support/widget.js" data-key="wk_your_key_here" data-lang="ja"></script>

11개 언어로 번역되어 있습니다. 영어, 일본어, 한국어, 중국어(간체와 번체), 스페인어, 프랑스어, 독일어, 포르투갈어, 아랍어, 러시아어입니다. 아랍어는 오른쪽에서 왼쪽으로 배치되고, 중국어는 방문자의 문자 체계를 따릅니다 — 대만, 홍콩, 마카오에서는 번체, 그 밖에서는 간체입니다. 그 밖의 언어는 반쯤 번역된 말풍선을 보여 주는 대신 영어로 되돌아가므로, data-lang="it"는 영어로 표시됩니다.

호스팅되는 웹 양식도 마찬가지입니다. 주소에 ?lang=ja를 붙이면 고정되고, 붙이지 않으면 방문자를 따릅니다.

브랜드 색상

따로 고르기 전까지 채팅은 저희 청록색입니다. 여러분의 색을 고르면 채팅의 헤더와 버튼, 고객이 보낸 메시지, 채팅이 열려 있는 동안 런처에 표시되는 닫기(✕) 버튼, 그리고 호스팅되는 웹 양식에 그 색이 쓰입니다.

  1. 데스크의 Settings(설정)를 엽니다. Web chat(웹 채팅) 섹션에서 Chat bubble icon(채팅 말풍선 아이콘) 바로 아래에 있는 Brand colour(브랜드 색상)를 찾습니다.
  2. 색을 고르고 Save colour(색상 저장)를 클릭합니다.
  3. 마음이 바뀌셨나요? Reset to default(기본값으로 되돌리기)를 누르면 저희 청록색으로 돌아갑니다.

색상은 약 5분 안에 웹사이트에 반영되며, 스니펫을 다시 붙여 넣을 필요는 없습니다. 아이콘과 마찬가지로 데스크 관리자와 소유자만 바꿀 수 있습니다.

직접 만든 말풍선 아이콘 쓰기

기본적으로 웹사이트의 런처는 말풍선 아이콘(💬)이 들어간 저희 청록색 버블입니다. 이것을 여러분의 PNG로 바꿔 위젯이 사이트에 어울려 보이게 할 수 있습니다. 업로드한 이미지는 버튼 전체가 됩니다. 56픽셀 런처를 가득 채우며, 그 뒤에 저희 청록색 원은 더 이상 그려지지 않습니다.

  1. 데스크의 Settings(설정)를 엽니다. Web chat(웹 채팅) 섹션으로 가서 Chat bubble icon(채팅 말풍선 아이콘)을 찾습니다.
  2. Upload PNG(PNG 업로드)를 클릭하고 파일을 고릅니다. 버튼 옆의 미리 보기 말풍선이 런처가 실제로 어떻게 보일지 그대로 보여 줍니다.
  3. 마음이 바뀌셨나요? Reset to default(기본값으로 되돌리기)를 누르면 저희 말풍선 아이콘으로 돌아갑니다.
이미지 가능한 조건
형식 PNG
권장 크기 정사각형, 최소 112×112 픽셀
표시 크기 런처 전체를 채움, 56×56 픽셀
모양 이미지 자체가 정함 — 투명 배경을 강력히 권장합니다
파일 크기 최대 256 KB

런처는 56×56 픽셀로 그려지므로 112×112(또는 그 이상) 원본이면 고해상도 화면에서도 마크가 또렷하게 유지됩니다. 은은한 그림자는 저희가 알아서 넣어 주며 여러분 그림의 윤곽을 따라가므로, PNG에 그림자를 미리 구워 넣을 필요는 없습니다.

런처 아이콘은 이미지이므로 브랜드 색상이 아이콘을 다시 칠하지는 않습니다 — 업로드한 아이콘이 곧 방문자가 보는 모습입니다. 이제 여러분의 이미지 뒤에 저희 원이 그려지지 않으므로, 투명 PNG를 쓰면 방문자가 보는 색은 곧 여러분 그림의 색입니다.

방문자에게 보이는 것

  1. 말풍선을 열고 이름, 이메일, 첫 메시지를 남깁니다.
  2. AI가 답합니다. 여러분의 지식에서 출처와 함께, 팀의 누구도 기다리지 않고 채팅 안에서 바로 답합니다.
  3. 사람이 넘겨받을 수 있습니다 — 그 답변은 몇 초 안에 같은 채팅에 나타납니다.

방문자가 남긴 이메일은 다음번에 그 사람을 알아보는 근거가 됩니다 — 고객 정보를 참고하세요.

웹 채팅은 다섯 가지 경로 중 하나입니다 — 고객이 문의하는 방법과, 채팅이 시작된 뒤 티켓이 동작하는 방식을 참고하세요.

게시일 2026-09-22
마지막 업데이트 날짜 2026-09-30
버전 3