ウィジェットカスタマイズ
チャットウィジェットの外観、動作、メッセージングをブランドに合わせて設定し、訪問者を効果的に引きつけましょう。
外観
サイト上でのウィジェットの見た目を制御します。
| 設定 | オプション | 説明 |
|---|---|---|
メインカラー | 任意の16進数値 | ウィジェットのヘッダー、送信ボタン、アクセントカラーを設定します。ブランドに合わせてください(例:#2563eb)。 |
位置 | 右下、左下 | ウィジェットが表示されるページの隅。 |
チャット表示 | オン / オフ | 埋め込みコードを削除せずにウィジェットのオン/オフを切り替え。メンテナンスやシーズンキャンペーンに便利です。 |
ヒント:白いテキストとのコントラストが良いカラーを使用してください。ウィジェットのヘッダーテキストは常に白なので、非常に薄い色は避けてください。
ウェルカムメッセージ
ウェルカムメッセージは、訪問者が初めてチャットを開き、既存のメッセージがない場合に表示されます。
仕組み
- デフォルト言語(例:英語)でメッセージを設定
- メッセージは言語別マップ(JSON)として保存されます
- 訪問者がチャットを開くと、Claudeにより訪問者のブラウザ言語に自動翻訳されます
- 翻訳はキャッシュされるため、同じ言語の後続の訪問者は即座に表示されます
例
英語でウェルカムメッセージを設定:
"Hi there! How can we help you today?"フランス語のブラウザの訪問者には:
"Bonjour ! Comment pouvons-nous vous aider aujourd'hui ?"プロアクティブメッセージング
プロアクティブメッセージは、訪問者がウィジェットをクリックする前に会話を始めるよう促します。
モード
| モード | 動作 |
|---|---|
auto_open | ページ読み込み時にチャットウィジェットが自動的に開きます。訪問者は完全なチャットウィンドウを即座に見ます。 |
attract | ウィジェットの横にプロアクティブメッセージ付きのフローティングバブルが表示され、押しつけがましくなく注目を集めます。 |
プロアクティブメッセージもウェルカムメッセージと同様に言語別で、訪問者のブラウザ言語に自動翻訳されます。
ヒント:「attract」モードはECサイト(「選ぶのにお困りですか?お気軽にどうぞ!」)に、「auto_open」は訪問者がすでに助けを求めているサポートページに適しています。
フォールバックメッセージ
フォールバックメッセージは、訪問者がオペレーターに接続されるのを待っている間に表示されます。応答時間についての期待値を設定します。
詳細
- 言語別に保存され、他のメッセージと同様に自動翻訳されます
- 会話がオペレーターの参加を待っている間に表示されます
- 例:「メッセージありがとうございます!チームメンバーがまもなく対応いたします。」
オペレーター言語
各ウィジェットにはデフォルトオペレーター言語があります。特定のオペレーターがまだ会話に割り当てられていない場合に、翻訳のターゲット言語として使用されます。
使用方法
- 訪問者がスペイン語でメッセージを送信
- まだオペレーターは割り当てられていない
- メッセージはウィジェットのオペレーター言語(例:英語)に翻訳されます
- オペレーターが会話を担当すると、翻訳はそのオペレーターの個人言語をターゲットにします
翻訳
このウィジェットでメッセージを自動翻訳するかどうかを制御します。
| 設定 | 説明 |
|---|---|
翻訳有効 | このウィジェットのマスタースイッチ。オフの場合、メッセージは翻訳されません。 |
翻訳モデル | 翻訳に使用するAIモデル。速度とコストの最適なバランスのためにHaikuを推奨します。 |
有効にすると、すべてのメッセージが両方向で自動翻訳されます — 訪問者のメッセージはオペレーターの言語に、オペレーターの返信は訪問者の言語に翻訳されます。詳細は翻訳ガイドをご覧ください。
レート制限
メッセージのレート制限でウィジェットを悪用から保護します。
設定
- 1分あたりのメッセージ数 — デフォルトは
20 - 訪問者セッションごとに適用
- 制限に達すると、訪問者は自分の言語でローカライズされた「少しお待ちください」メッセージを見ます
- スパムと過剰なトークン消費を防止
許可されたオリジン
セキュリティのために、ウィジェットを埋め込めるドメインを制限します。
仕組み
- ウィジェットが動作するドメインを追加します(例:
https://yoursite.com) - ウィジェットはホワイトリストに登録されたドメインでのみ読み込まれます
- リストが空の場合、ウィジェットはすべてのドメインで許可されます(制限なし)
- サードパーティのサイトでウィジェットキーの不正使用を防止するのに役立ちます
セキュリティ:本番環境では、必ず許可されたオリジンを追加してください。これにより、誰かがあなたの埋め込みコードをコピーして自分のサイトであなたのウィジェット(とトークン)を使用することを防ぎます。
埋め込みコード
各ウィジェットには固有の埋め込みコードがあります — ウェブサイトに追加する1つのスクリプトタグです。
<script src="https://enuchat.com/widget/enuchat-v1.js"
data-widget-key="wgt_your_key_here"></script>詳細
data-widget-key属性がウィジェットを識別します- スクリプトは非同期で読み込まれます — ページをブロックしません
- HTMLの
</body>の直前に配置してください - ウィジェットキーはクライアント側のコードで公開しても安全です — チャットセッションの開始にのみ使用でき、ダッシュボードへのアクセスはできません