위젯 커스터마이징

채팅 위젯의 외관을 브랜드 및 웹사이트 디자인에 맞게 개인화하세요.

설정

모든 위젯 커스터마이징 옵션은 설정 → 채널 → 웹에서 사용할 수 있습니다. 웹 채널을 선택하고 외관 탭을 여세요.

테마 색상

테마 색상은 위젯 전체에 일관되게 적용됩니다:

런처 버튼 배경
헤더 바 배경
전송 버튼 색상
링크 강조 색상
사용자 메시지 버블 배경

브랜드 아이덴티티에 맞는 색상을 선택하고 흰색 텍스트와의 충분한 대비를 확보하세요.

환영 메시지

환영 메시지는 고객이 위젯을 열었을 때 처음 보는 텍스트입니다. 친근하게 작성하고 봇이 어떤 도움을 줄 수 있는지 명확하게 설명하세요.

예시:

“안녕하세요! 오늘 무엇을 도와드릴까요?”
“Acme 지원에 오신 것을 환영합니다. 제품과 서비스에 대해 무엇이든 질문해 주세요.”
“안녕하세요! 도움을 드리기 위해 여기 있습니다. 무엇을 도와드릴까요?”

위젯 위치

위치	설정값	사용 시기
오른쪽 하단	`bottom-right` (기본값)	표준 배치, 대부분의 사이트에 적합
왼쪽 하단	`bottom-left`	오른쪽이 다른 요소와 충돌하는 경우

아바타

v1.6.4

이미지 URL을 제공하여 위젯 헤더와 홈 화면에 커스텀 아바타를 표시합니다.

대시보드에서: 설정 → 채널 → 웹 → 커스터마이저 → 아바타 URL에서 아바타 URL을 설정하세요.

임베드 코드에서: 테마 설정에서 avatarUrl을 전달하세요:

<script>
  window.ClientaConfig = {
    botId: "YOUR_BOT_ID",
    widgetId: "YOUR_WIDGET_ID",
    theme: {
      avatarUrl: "https://example.com/your-logo.png"
    }
  };
</script>

요구 사항:

반드시 https:// URL이어야 합니다 (http, data:, javascript: URL은 보안상의 이유로 거부됩니다)
권장 크기: 128 × 128 픽셀 (정사각형)
지원 형식: PNG, JPG, WebP, SVG
URL이 유효하지 않거나 이미지 로드에 실패하면 기본 아이콘이 표시됩니다

인사말 모드

v1.6.2

인사말 메시지는 세 가지 언어 모드를 지원합니다. 설정 → 채널 → 웹 → 커스터마이저로 이동하여 인사말 모드 섹션을 찾으세요.

정적 (Static)

언어에 관계없이 모든 방문자에게 동일한 인사말 텍스트가 표시됩니다. 기본 모드입니다.

텍스트 필드에 단일 인사말을 입력하세요. 예: “안녕하세요! 오늘 무엇을 도와드릴까요?”

방문자 언어 맞춤 (Match Visitor)

각 언어마다 다른 인사말을 표시합니다. 위젯은 방문자의 감지된 언어를 읽고 해당 인사말을 표시합니다.

방문자 언어 맞춤 모드를 선택하세요.
지원되는 15개 로케일 각각에 대한 필드가 나타납니다.
지원하려는 각 언어의 인사말 텍스트를 입력하세요.
특정 로케일 필드를 비워 두면 해당 언어에 대해 정적 인사말로 대체됩니다.

설정 예시:

태국어: “สวัสดีค่ะ! มีอะไรให้ช่วยไหม?”
영어: “Hi! How can I help you today?”
일본어: “こんにちは！何かお手伝いできますか？“

조직 기본 언어 (Org-Main)

방문자의 언어에 관계없이 인사말이 항상 조직의 주요 응답 언어로 표시됩니다. 이 모드는 **AI 설정 → 주요 응답 언어**에서 설정된 언어를 읽습니다.

팀이 하나의 언어로 운영되고 모든 인사말을 일관되게 유지하려는 경우 조직 기본 언어(Org-Main) 모드를 사용하세요.

언어 선택기

v1.6.2

언어 선택기는 위젯 헤더에 지구본 아이콘(🌐)을 추가하여 방문자가 언어를 명시적으로 선택할 수 있게 합니다. 기본적으로 비활성화되어 있습니다.

활성화 방법: 설정 → 채널 → 웹 → 커스터마이저에서 언어 선택기 표시를 켜세요.

방문자가 드롭다운에서 언어를 선택하면:

해당 세션 동안 모든 AI 응답이 선택한 언어로 고정됩니다
방문자가 다른 언어로 입력해도 자동 감지보다 고정 언어가 우선합니다
위젯 UI가 선택한 언어로 전환됩니다

전체 동작 개요는 웹 위젯 — 언어 선택기를 참조하세요.

기본 언어

v1.6.8

자동 감지가 시작되기 전에 방문자가 원하는 로케일로 UI를 볼 수 있도록 위젯의 기본 언어를 설정하세요. 설정 → 채널 → 웹 → 커스터마이저 → 기본 언어로 이동하여 드롭다운에서 선택하세요.

언어 우선순위는 다음과 같습니다:

이 언어 강제 적용 (AI 설정) — 활성화 시 모든 것을 재정의합니다
방문자의 명시적 선택 (언어 선택기를 통해, 활성화된 경우)
기본 언어 — 이 설정
임베드 설정 로케일 — 임베드 코드의 locale 값
태국어 — 다른 설정이 없을 때 대체값

**“없음 — 임베드 설정 따르기”**를 선택하면 이 설정을 건너뛰고 임베드 코드의 로케일 값에 의존합니다.

미리보기

변경 사항을 적용한 후 설정 페이지 오른쪽의 실시간 미리보기 패널을 사용하여 저장하기 전에 위젯이 사이트에서 어떻게 표시될지 정확히 확인하세요.

위젯 커스터마이징

위젯 커스터마이징

설정

테마 색상

환영 메시지

위젯 위치

아바타

인사말 모드

정적 (Static)

방문자 언어 맞춤 (Match Visitor)

조직 기본 언어 (Org-Main)

언어 선택기

기본 언어

미리보기

팁