홈으로

텍스트와 언어

위젯이 사용하는 언어와 선택 방식, 약 200개 텍스트를 계정이나 코드에서 바꾸는 방법.

위젯은 독일어, 영어, 폴란드어를 사용합니다. 약 200개의 텍스트를 각각 바꿀 수 있습니다. 계정에서 모든 페이지에 적용하거나 코드에서 개별 페이지에 적용합니다.

위젯의 언어 선택

위젯은 페이지 안에 있으므로 방문자가 현재 읽는 언어가 브라우저 설정보다 중요합니다. 순서는 다음과 같습니다.

페이지가 ReactiveChat('setLocale', …)로 선택한 방문자 언어(아래 참조).
스니펫(data-rc-locale) 또는 설정의 고정 언어.
그 외에는 페이지의 <html lang="…"> 언어.
그 외에는 계정의 기본 언어.
그 외에는 브라우저 언어, 마지막으로 영어.

지역 코드는 줄입니다. de-AT는 de가 됩니다. 알 수 없는 언어는 영어입니다.

따라서 페이지의 올바른 <html lang>가 가장 중요합니다. 그러면 웹사이트의 각 언어 버전을 자동으로 따릅니다.

계정의 기본 언어

/app/projects/{id}의 설치 탭, 기본 설정 섹션에서 기본 언어 de, en, pl 중 선택합니다. 두 역할이 있습니다.

<html lang> 없는 페이지에서 스니펫에도 언어가 없으면 적용합니다.
자체 문구, 홈 화면과 홍보 카드를 작성할 언어입니다(아래 참조).

코드의 언어 설정

스니펫으로 한 페이지에 고정합니다.

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-locale="pl"
        async></script>

실행 중에는 자체 언어 전환기 등에서 호출합니다.

ReactiveChat('setLocale', 'en');

setLocale은 위젯의 문구를 즉시 바꿉니다. 방문자의 브라우저에서 선택을 1년 기억하며 다른 페이지의 data-rc-locale보다도 우선합니다. 위젯 자체에는 언어 선택기가 없습니다. 방문자가 고르게 하려면 자체 전환기에서 setLocale을 호출합니다.

계정의 자체 문구

텍스트와 양식 탭, 자체 문구 섹션에 영역별로 묶고 접은 위젯의 모든 텍스트와 키가 있습니다. 필드의 회색은 당사 문구이며 입력하면 대체합니다. 제목에 이미 작성한 자체 텍스트 수가 표시됩니다.

텍스트당 최대 400자.
비워 두면 당사 문구.
당사 문구와 정확히 같으면 저장하지 않음.
위젯이 {n}, {name}, {time} 같은 중괄호 자리 표시자를 채웁니다. 값을 표시하려면 텍스트에 유지합니다.

언어 관련 중요 사항: 프로젝트 기본 언어로 입력하며 해당 언어에서 적용됩니다. 다른 언어의 위젯을 보는 방문자는 당사 기본 문구를 봅니다. 추가 언어의 자체 문구는 아래의 코드를 사용하고 가능하면 해당 언어 페이지에 넣습니다.

변경은 1분 안에 방문자에게 적용됩니다.

주요 키

영역별 발췌:

launcher.text, launcher.subtext – 채팅 버튼 레이블과 두 번째 줄. 기본값은 비어 있으며 입력하면 외관 → 브랜드 설정 필드보다 우선합니다.
launcher.label – 스크린 리더가 읽는 채팅 버튼 레이블(“채팅 열기”).
header.title, header.subtitle_online, header.subtitle_bot, header.response_time – 헤더 제목과 두 번째 줄.
home.greeting, home.sub, home.start, home.start_sub – 홈 화면 인사말과 시작점. 인사말은 홈 화면에서 더 쉽게 설정합니다.
tabs.home, tabs.messages, tabs.help – 탭.
input.placeholder와 기타 input.* – 입력란.
offline.* – “메시지 남기기” 양식.
prechat.* – 채팅 전 양식.
bh.* – 상담 시간 안내.
ds.*와 daten.* – 동의와 “내 데이터” 카드.
msg.ki_notice – AI 어시스턴트 첫 답변 전 안내.
csat.* – 대화 후 평가.
transcript.*, upload.*, handoff.*, queue.*, teaser.*, err.* – 이메일 대화 사본, 첨부, 팀 인계, 대기 순서, 툴팁 말풍선과 오류 메시지.

전체 목록은 계정에 있습니다.

“Powered by reactive.chat” 안내(채팅 창)와 제품 투어 문구(제품 투어)는 이 텍스트 설정으로 바꿀 수 없습니다.

코드에서 텍스트 바꾸기

스니펫의 data-rc-strings에 점 표기 키의 JSON을 넣습니다.

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-locale="en"
        data-rc-strings='{"input.placeholder":"Your question about your order …","header.title":"Customer service"}'
        async></script>

또는 설정에서 지정합니다.

ReactiveChat('boot', {
  strings: { 'input.placeholder': 'Your question about your order …' }
});

같은 페이지의 두 번째 boot 호출은 새 strings를 반영합니다. 따라서 로그인 후 텍스트 변경도 가능합니다.

코드의 텍스트는 모든 언어에 동일하게 적용됩니다. 따라서 언어가 고정된 페이지에 넣고 언어도 지정합니다.

강한 것부터 약한 순서의 우선순위:

코드의 텍스트(strings) – 해당 페이지만 적용.
계정의 자체 문구 – 기본 언어.
방문자 언어의 당사 기본 문구.
영어.

코드가 의도적으로 우선합니다. 한 페이지만 다르게 표시하려면 다른 모든 페이지 설정을 바꾸지 않고 해당 페이지에서 합니다.

다른 곳의 텍스트

일부 텍스트에는 자체 필드가 있으며 언어별인 경우도 많습니다.

인사말, 타일과 홈 화면: 채팅 홈 화면
채팅 전 양식 위 문장(언어별): 상담 가능 여부, 양식과 서비스
동의 문장과 개인정보 처리방침 링크(언어별): 개인정보 보호와 동의
툴팁과 선제 메시지 텍스트: 선제 메시지
AI 어시스턴트 이름과 말투: AI 어시스턴트
홍보 카드, 코드에서 언어별도 가능: 채팅의 홍보 카드

최종 업데이트: 2026-10-25