ウィジェット連携

クイックスタート

<script
  src="https://widget.guidme.ai/v1/loader.js"
  data-key="gm_live_xxxxxxxxxxxx"
  data-app-id="11111111-1111-4111-8111-111111111111"
  data-locale="auto"
></script>

ウィジェットは右下にフローティングボタンとして表示されます。data-locale="auto" はページで宣言された言語を使用し、未対応の場合は英語に切り替えます。

プライバシー境界は引き続きこの 1 つの script タグだけで動作し、アプリ固有のマスキングコードは不要です。アプリケーションが標準 HTML 要素に closed shadow root を作成する場合は、ローダーがローカル参照を保持できるよう、タグをアプリケーションのメインバンドルより前に配置してください。

ランチャー画像

Pro および Enterprise のお客様は、ダッシュボード > ウィジェット から任意のランチャー画像をアップロードできます。画像はランチャーアイコンの代わりに表示されます。5 MB 以下の JPEG、PNG、WebP、AVIF を使用してください。GuidMe が画像を検証して正方形に切り抜き、管理対象の WebP として公開します。同じエディターで削除すると、選択したアイコンに戻ります。

本番ウィジェットは GuidMe のブランドマークを使用します。サーバーが配信するプラン設定でブランド表示が無効になっていない限り、Powered by GuidMe は https://www.guidme.ai/ を新しいタブで開きます。

権限

音声入力にはマイクを使用し、パネルを閉じると停止します。ユーザーが 保護された画面を共有 を選び、このアプリケーションのブラウザータブを共有するまで、保護された画面共有は開始されません。GuidMe は検出された機密領域をデバイス上でマスキングし、役立つコンテキストとして機密でないテキストや要素を表示したままにして、最初の保護された正確な画像を確認用に保持します。確認前には何も送信されません。確認後も各画像を再度サニタイズし、保護された JPEG だけを Google Gemini に送信します。ローダーは iframe に microphone を委任し、画面共有が有効な場合にのみ display-capture を委任します。ブラウザーは必ずユーザーに許可を求めます。

画面共有を拒否、キャンセル、または停止しても、音声とテキストによるサポートは引き続き利用できます。ユーザーが後で再試行できるよう 保護された画面を共有 は引き続き表示されます。自動的に再許可を求めることはありません。

アプリ管理者は、プロジェクトごとに ウィジェット > ルール > 画面のプライバシー でプロファイルを設定します。バランス（推奨） は検出された機密コンテンツを選択的にマスキングし、通常のコンテキストを維持します。厳格は、表示されているすべてのフォームコントロールと編集可能なフィールドもマスキングします。ポータルには、操作項目、テキスト、または広いページ領域が隠れ、案内が具体的でなくなったり追加の確認が必要になったりする可能性があるという警告が表示されます。埋め込みタグで、サーバーが発行するこのプロファイルを選択したり弱めたりすることはできません。

セキュリティと整合性

gm_live_ で始まるウィジェット用キーのみを使用し、管理者キーをクライアントに公開しないでください。
ホストドメインをアプリの許可オリジンに追加してください。
ホストページの CSP では script-src https://widget.guidme.ai、frame-src https://widget.guidme.ai、connect-src https://api.guidme.ai を許可します。iframe には独自の制限付き CSP が設定されます。
Sentry/OpenTelemetry の運用テレメトリは既定で無効です。組織がこの処理を承認した場合に限り、data-operational-telemetry="true" を設定してください。
/v1/loader.js は使用時に再検証されるチャネルエイリアスです。iframe エイリアスはブラウザーや CDN のキャッシュに保存されず、ローダーの正確なプライバシービルドに関連付けられます。/v1/integrity.json で SHA-384 値とコンテンツハッシュ付きの不変パスを取得し、デプロイ時に固定できます。

公開ウィジェットにはソースマップを含めません。