サンタのボイスエージェントをReactアプリに数分で追加
- 公開日
このホリデーシーズン、アプリにサンタを追加しませんか?
ElevenLabsのAgentsプラットフォームと@elevenlabs/react SDKを使えば、サンタクロースのボイスエージェントをReactアプリに数分で追加できます。このガイドでは以下を行います:
- ElevenLabsダッシュボードでサンタエージェントを作成
- WebRTCを使ってReactコンポーネントに組み込み
- シンプルな「サンタに電話」ボタンを追加
1. サインアップしてAgents Platformを開く
- サインアップ/ログインしてElevenLabsにアクセスします。
- 左サイドバーで、プラットフォーム切り替えを上部で開きます。
- 「Agentsプラットフォーム.
」を選択します。サイドバーにエージェント, ナレッジベース, ツール、ボイスなど「Build」セクションが表示されます。
2. サンタエージェントを作成
次に、サンタのように振る舞い、サンタの声で話すエージェントを作成します。
- サイドバーでエージェント.
- をクリック+ 新規Agent.
- をクリック空のAgentを選択して新規作成します。
名前を「Santa」にします。
システムプロンプト
「システムプロンプト」欄に、次の内容を貼り付けます:
最初のメッセージ
「最初のメッセージ」を以下に設定します:
ホッホッホー!メリークリスマス、友よ。あなたの名前を教えてくれるかな?
これは通話開始時にユーザーが聞くメッセージです。
ボイス
「ボイス」セクションで:
- 「Jerry B. – Santa Claus」
- ボイスID:
MDLAMJ0jxkpYkjXbmG4t
これでサンタが実際にサンタのような声になります。
セキュリティ
この例では、オープンな設定にします:
- 「セキュリティ」で、認証を有効化がオフ.
になっていることを確認してください。最初のデモでは、認証を有効化をオフのままにしておけば、誰でも制限なくエージェントに接続できます。これによりオンボーディングが早くなり、プロトタイプやハッカソン、社内デモに最適です。
ただし、本番環境や外部公開アプリの場合は、絶対にエージェントをオープンのままにしないでください。代わりにElevenLabsのトークンエンドポイントを使い、各ユーザーセッションごとに有効期限付きのスコープ付きアクセストークンを発行しましょう。これにより、誰が接続できるか、アクセス期間、ユーザーの操作範囲を完全に管理できます。認証を有効にすることで、不正な通話や悪用、意図しない利用からエージェントを守れます。公開前には必ず有効化をおすすめします。
3. エージェントIDを取得
エージェントページ上部にエージェントID欄があります。
この値を控えておき、後ほどReactコンポーネントに貼り付けます:
4. React SDKをインストール
React/Next.jsプロジェクトでElevenLabs React SDKをインストールします:
これで、useConversationフックを使って音声通話を開始・終了できます。
5. 「サンタに電話」ボタンを追加
新しいコンポーネント(例:CallSantaButton.tsx)を作成し、次のコードを貼り付けます:
次に、「置き換え」 "<AGENT_ID>"を、ダッシュボードでコピーした実際のエージェントIDに変更します。
その後、UIのどこかにボタンを表示します。例:
6. 試してみる
ブラウザで開き、通話開始:
- をクリックします。ブラウザが.
- マイクの許可
- を求めます。
SantaエージェントとのWebRTCセッションが始まります。
次のメッセージが聞こえます:
「ホッホッホー!メリークリスマス、友よ。あなたの名前を教えてくれるかな?」
ここからサンタが名前やほしいものリスト、今年良い子だったことなどを質問します。
- 次にできること基本が動いたら、以下も試せます:
- 認証でサンタへのアクセスを制限(エージェントのセキュリティ設定を利用)
- 言語切り替え(ユーザーのロケールを渡してプロンプトで対応)
UIのカスタマイズ
- (オリジナルボタンやアニメーション、「サンタに電話」専用画面など)でも、コアの連携はとてもシンプルです:
- Agents Platformで1つのエージェント
1つの - agentId
useConversationフックとボタン
これだけで、リアルタイムで会話できるサンタの魔法をReactアプリに追加できます。


.webp&w=3840&q=80)
.webp&w=3840&q=80)
