世界は立ち止まらない。RSS
BIG CHANGE.

Markdown版

AI-translated from English; not yet reviewed by a fluent editor.

# 1つのウェブページに ElevenLabs の音声FAQウィジェットを追加する

> 専用の公開FAQエージェントを設定し、許可ホスト名を絞って1ページに埋め込み、実際の会話、プライバシー、使用量を確認します。

By BIG CHANGE Editorial

Published: 2026-10-20T06:57:39.691Z
Updated: 2026-10-20T06:57:39.691Z
Canonical: https://bigchange.ai/blog/elevenlabs-voice-faq-widget-website-guide

![Conceptual charcoal illustration of one person speaking toward a handheld phone displaying an unbranded, unreadable web page.](https://bigchange.ai/api/media/file/elevenlabs-public-voice-faq-phone-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

ElevenLabs ウィジェットを使うと訪問者がサイトで声で質問できます。本稿はページとエージェントの管理者向けです。範囲の狭い公開FAQを設定し、公開ページで検証した後、アクセス、会話記録、使用量を調べます。2026年10月20日に確認した文書に基づきます。BIG CHANGE はエージェント作成、埋め込み、テスト通話を行っていません。

## 大きな変化

- **何が：** ElevenLabs は公開 ElevenAgents エージェント用のサイトウィジェットを案内しており、標準は音声モードです。
- **仕組み：** ページは公開されるエージェントIDでカスタム要素を読み込みます。ホスト名の許可リストが接続元サイトを制限します。
- **重要な理由：** 運営者は1ページで音声案内を確認できますが、公開前に情報、訪問者向け通知、通話料金の可能性を承認する必要があります。ホスト名のリストは個々の訪問者を識別しません。

## 公開FAQと小さなテストを準備する

1つのエージェントを管理し、1ページを編集・公開する権限が必要です。HTTPSページ、マイクの使えるブラウザー、FAQを承認して回答を聞ける人を用意します。サイトの公開ツールがカスタム要素とスクリプトを許可することを確認し、現在のカスタムHTML追加方法を使います。例は提供元の通常HTML埋め込みであり、個別プラットフォームの手順ではありません。

少数の **承認済みの公開情報** と、範囲外の依頼の有人連絡先を書き出します。情報内で答えられる質問と、拒否または人へ案内すべき質問を1つずつ選びます。顧客記録、非公開方針、アカウント情報、APIの秘密は含めません。声と訪問者通知の承認者を決めます。音声と契約が目的の利用を許可するか確認してください。本稿は一律の商用音声利用権を認めるものではありません。

音声テスト前に実際のプラン、残クレジット、従量課金設定、選択モデルの費用を確認します。ElevenLabs はエージェント作成を無料としていますが、接続通話は使用量を消費し、LLM料金は別の場合があります。接続時間は発話時間より長くなることがあります。ダッシュボードと公開ページのテスト費用を先に承認します。1通話の時間制限は月額の支出上限ではありません。

## 専用エージェントを設定する

1. **独立した公開FAQエージェントを作成します** 。承認された空の設定またはテンプレートを使い、継承した知識とツールを確認します。私的な知識、予約、CRM、webhook、不要な操作を除きます。承認情報に基づく目的と回答範囲、有人連絡先、許可された声と言語を設定します。既存の非公開エージェントの認証を切って公開化しないでください。
2. 次の画面で設定します： **Channels → Widget → Interface**。音声インターフェースを選び、訪問者向け文と規約を確認します。手引きは一部を **Widget** タブとも呼ぶので、保存済みの設定を確認します。以下の方式に必要なのは **認証を無効にした公開エージェント**で、手引きでは設定箇所を **Advanced**としています。IDはページソースに見えるため秘密ではありません。APIキー、個人情報、訪問者固有情報をマークアップや上書き設定に入れません。
3. エージェントの **Security** タブで、サイトの正確なホスト名を **Allowlist**に追加し、保存後に読み直します。ElevenLabs は完全一致、最大10件、サブドメインごとの登録と説明します。ローカルテストのホストは必要時だけ追加します。これは接続元を制限するもので、話者の認証ではありません。
4. 文字起こし保持と音声保存を確認し、サイトに合う通知と同意の手続きを承認します。通話前に規約を表示できますが、その画面やブラウザーのマイク許可だけでサイトの法的義務が済むわけではありません。 **Advanced → Call limits**で適切な値を設定して保存する項目は **Max conversation duration**です。文書上の標準は600秒、範囲は60～7,200秒です。課金テスト前にプライバシー、時間、アクセス設定を読み直します。

## 1つの下書きページに埋め込む

サイトがサポートするカスタムHTMLまたはスクリプト機能で、次をページ本文に置きます。 `YOUR_PUBLIC_AGENT_ID` を専用エージェントIDへ置き換え、最初はこの承認済み1ページだけに設置します。

```html
<elevenlabs-convai agent-id="YOUR_PUBLIC_AGENT_ID"></elevenlabs-convai>
<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async type="text/javascript"></script>
```

これは現在の [公式ウィジェット埋め込み](https://elevenlabs.io/docs/eleven-agents/customization/widget)です。スクリプトURLには **固定バージョンがありません**。設置内容を記録し、保守時に手引きを再確認します。下書きで1つだけ表示され、重要操作を隠さないか見ます。Content Security Policy がある場合は担当者が具体的な遮断要求を調べ、限定的で審査済みの変更をします。無効化や広いワイルドカードは設置手順ではありません。

## エージェントを確認してから実際の訪問経路を試す

費用とプライバシーの確認後、ダッシュボードの音声テストで2問を尋ねます。承認情報と有人案内の境界に照らし、安全でない、または根拠のない答えは修正して再試験します。ダッシュボード通話はその経路だけの確認で、サイト埋め込みを証明しません。

公開前にページ責任者が内容、通知、配置、結果を確認します。 **許可ホスト名の公開ページ**でウィジェットを開き、意図してマイクを許可し、同じ2問の回答を聞いて通話を終了します。マイク表示の消灯と電話サイズでの操作性を確認します。流暢でも正確とは限らないため承認回答と比較します。調査用に時間とエージェントを記録します。これは読者の検証手順で、BIG CHANGE の観測結果ではありません。

次を開きます： **Call history** 。保持設定で記録が残る場合に2問と照合します。続いて **Analytics**で対象エージェントと短期間に絞り、回数、時間、費用を見ます。集計だけでは特定通話の料金を証明できません。承認設定が記録を削除するなら、許可された最小の回答観察だけを残し、集計を確認します。このために保持期間を延ばさないでください。記録がないことは無料の証拠ではありません。

## 確認に失敗した場合

表示されなければ実際の公開マークアップを [文書の埋め込み例](https://elevenlabs.io/docs/eleven-agents/customization/widget)と比較し、重複や具体的なスクリプト・CSPエラーを調べます。表示されても接続しなければ公開認証、正確なホスト名、マイク許可、残高、ダッシュボードのエラーを確認します。音声障害はマイク選択、ブラウザー許可、安全なページ環境、利用可能な記録を見ます。不確かな通話を終了し、使用量を確認してから有料の再試行をします。

FAQ外や創作の回答があれば、情報と指示を修正する間は埋め込みを外します。復帰前にダッシュボードとサイトで2問を再試験します。予算超過なら外して統計と請求を調べ、時間と展開範囲を見直します。削除はこのページの新規通話を止めるだけで、通話中の終了や他の許可ホストからのアクセス停止を証明しません。

ローカル開発のブラウザー音声アプリについては、 [OpenAI Realtime のガイド](https://bigchange.ai/blog/openai-realtime-browser-voice-webrtc-guide) が別の作業を説明します。本稿はホスト型の公開ウィジェットです。手引きの別箇所にはある `signed-url` 属性が記載されていますが、基本手順は公開エージェントを明示的に要求します。その属性だけではテスト済み非公開方式にはなりません。

## 出典と参考資料

- [ElevenLabs ウィジェットのカスタマイズ](https://elevenlabs.io/docs/eleven-agents/customization/widget)：公開要件、画面設定、現在の埋め込み。URLのバージョンは固定されていません。
- [エージェント認証](https://elevenlabs.io/docs/eleven-agents/customization/authentication)：正確なホスト名、10件上限、個人認証との違い。
- [会話の流れ](https://elevenlabs.io/docs/eleven-agents/customization/conversation-flow) と [プライバシー設定](https://elevenlabs.io/docs/eleven-agents/customization/privacy)：時間、保持、音声保存。
- [ElevenAgents クイックスタート](https://elevenlabs.io/docs/eleven-agents/quickstart)、 [Analytics](https://elevenlabs.io/docs/eleven-agents/dashboard) と [費用の説明](https://elevenlabs.io/docs/help-center/product/eleven-agents/how-much-does-eleven-agents-cost)：テスト、履歴、集計、課金基準。実際の枠と請求は契約によります。

## Sources

- [ウィジェットのカスタマイズ](https://elevenlabs.io/docs/eleven-agents/customization/widget) — 2026年10月20日確認。公開要件、モード、基本要素、現在の非固定版スクリプト。非公開の署名付き実装の検証ではありません。
- [エージェント認証](https://elevenlabs.io/docs/eleven-agents/customization/authentication) — 2026年10月20日確認。ホスト完全一致と10件上限。接続元の制御であり、訪問者認証ではありません。
- [会話の流れ](https://elevenlabs.io/docs/eleven-agents/customization/conversation-flow) — 2026年10月20日確認。標準時間、範囲、会話ごとの保存。総支出上限は確認していません。
- [プライバシー](https://elevenlabs.io/docs/eleven-agents/customization/privacy) — 2026年10月20日確認。文字と音声の保持。実際の通知と法的根拠は責任者の審査が必要です。
- [ElevenAgents クイックスタート](https://elevenlabs.io/docs/eleven-agents/quickstart) — 2026年10月20日確認。設定とテスト、Call history、公式コード。BIG CHANGE の実測ではありません。
- [Analytics](https://elevenlabs.io/docs/eleven-agents/dashboard) — 2026年10月20日確認。エージェント・時間フィルターと回数、時間、費用の集計。1回のテスト通話を集計だけで識別できません。
- [ElevenAgents の費用は？](https://elevenlabs.io/docs/help-center/product/eleven-agents/how-much-does-eleven-agents-cost) — 2026年10月20日確認。作成、接続時間、別のLLM料金。プラン、残高、声の権利は個別確認が必要です。