Webサイトへの設置

設置前に

管理者権限とWebサイトの共通テンプレートを編集できる担当者が必要です。小さなスクリプトがiframe内のチャットを開き、Webサイトのスタイルと分離します。既存のフォームやコンテンツを置き換えるものではありません。

スクリプトを追加する

設置画面でワークスペース専用のコードをコピーし、共通HTMLの通常はbody終了タグの直前へ一度だけ追加します。

<script src="https://preview.runsagents.com/launcher.js" data-tenant="your-workspace"></script>

これは構造例です。実際にはコピーした識別子入りのコードを使用してください。単一ページアプリのルート移動ごとにスクリプトを重複挿入しないでください。

正確なオリジンを許可する

オリジンはスキーム、ホスト名、必要ならポートを含み、ページパスは含みません。https://example.com と https://www.example.com は設置では別のオリジンです。HTTPとHTTPS、サブドメイン、ポートの違いも区別します。登録がなければ外部サイトには表示しません。

表示ページのルール

ルールはそのページだけ、または配下も含める指定です。/support の配下には /support/contact を含み、/supporters は含みません。クエリやフラグメントは判定に使いません。

設定は短時間キャッシュされる場合があり、開いたページへ即時配信しません。保存後は再読み込みしてください。単一ページアプリのパス移動では表示条件を再判定します。

読み込みとセキュリティポリシー

サイトでCSPを設定している場合、Runs Agentsのスクリプト、フレーム、公開設定取得の実際のリクエストを許可してください。サイト全体の保護を無効にせず、拒否された通信を担当者が調べます。

チャット側のフレームポリシーも表示許可を確認するため、iframeを直接置いても許可設定の代わりにはなりません。拡張機能、プロキシ、ブラウザー制限、保存機能の拒否が影響する場合もあります。

動作を確認する

デスクトップとモバイルで表示を確認し、プライバシー画面、架空の質問、閉じる・再開、移動・再読み込み、会話と下書きの復元を試します。対象外ページと正しいワークスペースへの記録も確認します。位置はプレビューで保存します。

設置を取り除くには共通テンプレートのスクリプトを削除します。ポータルからはサイト許可とページルールで表示を管理できます。