위젯 사용자 지정
브랜드와 일치하고 방문자를 효과적으로 참여시키기 위해 채팅 위젯의 모양, 동작 및 메시징을 구성하세요.
모양
사이트에서 위젯이 어떻게 보이는지 제어하세요.
| 설정 | 옵션 | 설명 |
|---|---|---|
기본 색상 | 16진수 값 | 위젯 헤더, 전송 버튼 및 액센트 색상을 설정합니다. 브랜드와 일치시키세요 (예: #2563eb). |
위치 | bottom-right, bottom-left | 위젯이 나타나는 페이지의 구석. |
채팅 표시 | 켜기 / 끄기 | 임베드 코드를 제거하지 않고 위젯을 켜거나 끕니다. 유지 관리 또는 계절 캠페인에 유용합니다. |
팁: 흰색 텍스트와 대비가 좋은 색상을 사용하세요. 위젯 헤더 텍스트는 항상 흰색이므로 매우 밝은 색상은 피하세요.
환영 메시지
환영 메시지는 방문자가 처음으로 채팅을 열고 기존 메시지가 없을 때 표시됩니다.
작동 방식
- 기본 언어 (예: 영어)로 메시지 설정
- 메시지는 언어별 맵 (JSON)으로 저장됨
- 방문자가 채팅을 열 때 메시지는 Claude를 통해 자동으로 번역되어 브라우저 언어로 표시됨
- 번역된 버전은 캐시되므로 동일한 언어의 후속 방문자는 즉시 보게 됨
예제
영어로 환영 메시지 설정:
"Hi there! How can we help you today?"프랑스어 브라우저의 방문자는 다음을 봅니다:
"Bonjour ! Comment pouvons-nous vous aider aujourd'hui ?"선제적 메시징
선제적 메시지는 방문자가 위젯을 클릭하기 전에 대화를 시작하도록 장려합니다.
모드
| 모드 | 동작 |
|---|---|
auto_open | 채팅 위젯이 페이지 로드 시 자동으로 열립니다. 방문자는 즉시 전체 채팅 창을 봅니다. |
attract | 위젯 옆에 선제적 메시지와 함께 떠다니는 버블이 나타나 방해가 되지 않고 주의를 끕니다. |
선제적 메시지는 환영 메시지처럼 언어별이며 방문자의 브라우저 언어로 자동 번역됩니다.
팁: „attract" 모드는 이커머스에 잘 작동하고 („선택에 도움이 필요하신가요? 물어보세요!") „auto_open"은 방문자가 이미 도움을 찾고 있는 지원 페이지에 더 적합합니다.
폴백 메시지
폴백 메시지는 방문자가 운영자에게 연결될 때 표시됩니다. 응답 시간에 대한 기대치를 설정합니다.
세부 정보
- 언어별로 저장되며, 다른 메시지처럼 자동 번역됨
- 대화가 운영자 참여를 기다릴 때 표시됨
- 예: „메시지 주셔서 감사합니다! 저희 팀원이 곧 도와드리겠습니다."
운영자 언어
각 위젯에는 기본 운영자 언어가 있습니다. 이것은 특정 운영자가 대화에 아직 할당되지 않았을 때 번역이 대상으로 삼는 언어입니다.
사용 방법
- 방문자가 스페인어로 메시지 전송
- 아직 운영자가 할당되지 않음
- 메시지가 위젯의 운영자 언어 (예: 영어)로 번역됨
- 운영자가 대화를 요청하면 번역이 해당 운영자의 개인 언어를 대상으로 함
번역
이 위젯에서 메시지가 자동으로 번역되는지 제어하세요.
| 설정 | 설명 |
|---|---|
번역 활성화 | 이 위젯의 마스터 스위치. 꺼지면 이 위젯의 메시지가 번역되지 않습니다. |
번역 모델 | 번역에 사용되는 AI 모델. Haiku는 속도와 비용의 최적 균형을 위해 권장됩니다. |
활성화되면 모든 메시지가 양방향으로 자동 번역됩니다 — 방문자 메시지는 운영자 언어로 번역되고 운영자 답변은 방문자 언어로 번역됩니다. 전체 세부 정보는 번역 가이드를 참조하세요.
속도 제한
메시지 속도 제한으로 남용으로부터 위젯을 보호하세요.
구성
- 분당 메시지 — 기본값은
20 - 방문자 세션당 적용
- 제한에 도달하면 방문자는 자신의 언어로 현지화된 „속도를 줄여주세요" 메시지를 봅니다
- 스팸 및 과도한 토큰 소비 방지
허용된 출처
보안을 위해 위젯을 임베드할 수 있는 도메인을 제한하세요.
작동 방식
- 위젯이 작동해야 하는 도메인 추가 (예:
https://yoursite.com) - 위젯은 화이트리스트된 도메인에서만 로드됩니다
- 목록이 비어 있으면 위젯은 모든 도메인에서 허용됩니다 (제한 없음)
- 제3자 사이트에서 위젯 키의 무단 사용 방지에 유용
보안: 프로덕션 사용의 경우 항상 허용된 출처를 추가하세요. 이렇게 하면 누군가 임베드 코드를 복사하여 자신의 사이트에서 위젯 (그리고 토큰)을 사용하는 것을 방지할 수 있습니다.
임베드 코드
각 위젯에는 고유한 임베드 코드가 있습니다 — 웹사이트에 추가하는 단일 스크립트 태그.
<script src="https://enuchat.com/widget/enuchat-v1.js"
data-widget-key="wgt_your_key_here"></script>세부 정보
data-widget-key속성은 위젯을 식별합니다- 스크립트는 비동기식으로 로드됩니다 — 페이지를 차단하지 않습니다
- HTML의
</body>바로 앞에 배치하세요 - 위젯 키는 클라이언트 측 코드에서 노출하는 것이 안전합니다 — 대시보드에 액세스하는 것이 아니라 채팅 세션을 시작하는 데만 사용할 수 있습니다