> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Vonageインテグレーション

## 概要

[WebSocketコネクターアプリケーション](https://github.com/nexmo-se/elevenlabs-agent-ws-connector)を使用して、ElevenLabs AgentsをVonage Voice APIまたはVideo APIの通話に接続します。これにより、PSTN通話、SIPトランク、WebRTCクライアントなどのユースケースで、リアルタイムの双方向オーディオストリーミングが可能になります。

## 仕組み

Node.jsコネクターはVonageとElevenLabsをブリッジします。

1. Vonageが、進行中の通話用にコネクターへのWebSocket接続を開始します。
2. コネクターがElevenLabs AgentsエンドポイントへのWebSocket接続を確立します。
3. オーディオはVonage（L16）→コネクター→ElevenLabs（base64）の順に中継され、その逆方向にも中継されます。
4. コネクターが会話イベント（`user_transcript`、`agent_response`、`interruption`）を管理します。

## セットアップ

### 1. ElevenLabsの認証情報を取得する

* **APIキー**：APIキーは、サイドバーからリンクされている[DevelopersページのAPI Keysタブ](https://elevenlabs.io/app/developers)にあります。
* **エージェントID**：[ElevenAgentsダッシュボード](https://elevenlabs.io/app/agents/agents/)でエージェントを見つけます。エージェントを選択したら、設定ボタンをクリックして「Copy Agent ID」を選択します。

### 2. コネクターを設定する

リポジトリをクローンし、環境ファイルをセットアップします。

```bash
git clone https://github.com/nexmo-se/elevenlabs-agent-ws-connector.git
cd elevenlabs-agent-ws-connector
cp .env.example .env
```

認証情報を`.env`に追加します。

**`.env`**

```bash title=".env"
ELEVENLABS_API_KEY = YOUR_API_KEY;
ELEVENLABS_AGENT_ID = YOUR_AGENT_ID;
```

依存関係をインストールします：`npm install`。

### 3. コネクターを公開する（ローカル開発）

ngrokまたは同様のサービスを使用して、コネクター用のパブリックURLを作成します（デフォルトポートは6000）。

```bash
ngrok http 6000
```

パブリック`Forwarding` URL（例：`xxxxxxxx.ngrok-free.app`）を控えます。Vonageの設定時に\*\*`https://`を含めないでください\*\*。

### 4. コネクターを実行する

アプリケーションを起動します。

```bash
node elevenlabs-agent-ws-connector.cjs
```

### 5. Vonage音声アプリケーションを設定する

Vonageアプリは、コネクターのWebSocketエンドポイント（`wss://YOUR_CONNECTOR_HOSTNAME/socket`）に接続する必要があります。これはステップ3で取得したngrok URLです。

* **サンプルアプリを使用**：[サンプルVonageアプリ](https://github.com/nexmo-se/voice-to-ai-engines)で、`PROCESSOR_SERVER`をコネクターのホスト名に設定します。
* **既存アプリを更新**：[Nexmo Call Control Object](https://developer.vonage.com/en/voice/voice-api/ncco-reference)を変更し、`content-type: audio/l16;rate=16000`を指定してコネクターのWebSocket URI（`wss://...`）を対象とする`connect`アクションを含めます。`peer_uuid`や`webhook_url`など、必要なクエリパラメーターを渡します。

### 6. テスト

Vonageアプリケーション経由で着信または発信し、ElevenLabsエージェントと対話します。

## クラウドデプロイ

本番環境では、パブリックホスト名を持つ安定したホスティングプロバイダー（例：Vonage Cloud Runtime）にコネクターをデプロイします。