トップページへ

テキストと言語

ウィジェットの言語、言語の選び方、約200のテキストをアカウントやコードで置き換える方法を説明します。

ウィジェットはドイツ語、英語、ポーランド語に対応します。約200の各テキストを、全ページ向けにアカウントで、個別ページ向けにコードで置き換えられます。

言語の選び方

ウィジェットはページ内にあるため、ブラウザー設定より、現在読んでいるページを優先します。順序は次のとおりです。

ページがReactiveChat('setLocale', …)で、この訪問者用に選んだ言語（下記）。
スニペット（data-rc-locale）や設定で固定した言語。
ページの<html lang="…">。
アカウントの既定の言語。
ブラウザーの言語、最後に英語。

地域コードは短縮し、de-ATはdeになります。未知の言語は英語です。

最も大切なのは、ページの正しい<html lang>です。これで、サイトの各言語版に自動で追従します。

アカウントの既定の言語

/app/projects/{id}のインストール → 基本設定 → 既定の言語で、de、en、plを選びます。役割は2つです。

<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 – ボタンのラベルと2行目。初期値は空で、入力は外観 → ブランド設定より優先。
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 …' }
});

同じページで2回目のbootを呼ぶと、新しいstringsを読み込みます。ログイン後の変更などに使えます。

コードの文言は全言語で同じです。そのため、言語が固定のページで、言語も合わせて指定してください。

優先順位は高い順に次のとおりです。

コードのテキスト（strings）。そのページのみ。
既定言語のアカウントの独自文。
訪問者の言語の当社テキスト。
英語。

個別ページだけ別のラベルにし、他ページを変えずに済むよう、意図的にコードを優先しています。

他の場所のテキスト

一部には専用フィールドがあり、多くは言語別です。

あいさつ、タイル、ホーム：チャットのホーム画面
開始前フォームの上の文（言語別）：対応状況、フォーム、サービス
同意文とポリシーリンク（言語別）：プライバシーと同意
ツールチップとプロアクティブ文：プロアクティブメッセージ
AIの名前と口調：AIアシスタント
コードでは言語別にもできるカード：チャット内のプロモーションカード

最終更新: 2026-10-25