> 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.

# Twilioのリージョナルルーティング

## 概要

リージョナルルーティングにより、電話データを特定の地理的リージョン内に保持できます。ElevenLabsを隔離環境（EUデータレジデンシーなど）でTwilioと併用する場合、データレジデンシー要件を満たすにはリージョナルルーティングを正しく設定する必要があります。

このガイドでは、リージョナルルーティングとは何か、なぜ重要なのか、TwilioとElevenLabsの両方で正しく設定する方法を説明します。

## リージョナルルーティングとは？

リージョナルルーティングは、通話データが特定の地理的リージョン内で処理・保存されるようにするTwilioの仕組みです。電話インフラにおけるデータレジデンシーと考えるとわかりやすいでしょう。

> **Note**
>
> デフォルトでは、Twilioの電話番号は`us1`（米国）リージョンを経由するよう設定されています。**電話番号自体が別の国のものであっても同様です**。たとえば、イタリアの電話番号でも、リージョナルルーティングを明示的に設定しない限り、米国を経由します。

## リージョナルルーティングが重要な理由

ElevenLabsを隔離環境（EUデータレジデンシーなど）で使用する場合、すべてのデータ処理を指定リージョン内にとどめる必要があります。リージョナルルーティングを適切に設定しない場合、次の問題が発生する可能性があります。

* **データレジデンシー違反**：通話データが意図しないリージョンを経由する可能性があります
* **API操作の失敗**：進行中の通話に対する操作（転送、保留、再開など）が失敗します
* **SDKのルーティング不一致**：Twilio SDKはデフォルトで`us1`リージョンを使用するため、Twilioがバックエンドで通話を正しくルーティングしていても、API呼び出しが誤ったリージョンに送信されます

## 仕組み

Twilioの電話番号をElevenLabsにインポートすると、次のように動作します。

1. **Twilioが通話をルーティング**：Twilioは、Twilioアカウントで設定されているリージョンに着信通話を自動的にルーティングします（`us1`、アイルランドの`ie1`、オーストラリアの`au1`など）
2. **ElevenLabsがリージョンを認識する必要がある**：進行中の通話に対して転送などの操作を行うには、ElevenLabsからTwilioが通話をルーティングしたリージョンと同じリージョンにAPIリクエストを送信する必要があります
3. **リージョン指定により失敗を防止**：ElevenLabsプラットフォームでルーティングリージョンを指定することで、すべてのAPI呼び出しが正しいTwilioリージョンを対象にするようにします

> **Warning**
>
> ルーティングリージョンが指定されていない、または正しくない場合、通話転送などの操作は失敗します。実際の通話は別のリージョンで処理されているにもかかわらず、APIリクエストがデフォルトの`us1`リージョンに送信されるためです。

## 設定

### Twilioのリージョナルルーティングを確認する

まず、Twilioの電話番号に設定されているリージョンを確認します。

1. [Twilio Console](https://console.twilio.com/)にログインします
2. **Phone Numbers**→**Manage**→**Active numbers**に移動します
3. 電話番号を選択します
4. **Voice & Fax**設定セクションを探します
5. **Regional routing**または**Edge Location**の設定を確認します

代表的なTwilioリージョン：

* `us1` - 米国（デフォルト）
* `ie1` - アイルランド（欧州）
* `au1` - オーストラリア
* `br1` - ブラジル
* `jp1` - 日本
* `sg1` - シンガポール

> **Tip**
>
> 隔離環境（EUデータレジデンシーなど）を使用している場合は、Twilioの電話番号が対応するリージョン（例：EUの場合は`ie1`）を経由するよう設定されていることを確認してください。

### Twilioでリージョナルルーティングを設定する

電話番号が正しいリージョンに設定されていない場合：

1. [Twilio Console](https://console.twilio.com/)で電話番号の設定を開きます
2. **Voice & Fax**セクションを見つけます
3. **Edge Location**を使用するリージョンに設定します
4. 設定を保存します

> **Note**
>
> Twilioでリージョナルルーティングを設定するには、追加の設定やアカウント権限が必要になる場合があります。アカウントでリージョナルルーティングを有効にする際に支援が必要な場合は、[Twilio Support](https://support.twilio.com/)にお問い合わせください。

### ElevenLabsでルーティングリージョンを指定する

ElevenLabsの[Phone Numbers](https://elevenlabs.io/app/agents/phone-numbers)ページでTwilioの電話番号をインポートまたは設定する場合：

1. 電話番号の設定に移動します
2. 隔離環境を使用している場合は、「You are using a phone number in an isolated environment. Double check the routing region for this phone number in your provider.」という警告メッセージが表示されます
3. **routing region**がTwilioの設定と一致することを確認します
4. 指定したリージョンがTwilioアカウントで設定されているリージョンと一致することを確認します
   > **Warning**
   >
   > リージョナルルーティングを使用する場合は、ルーティングリージョンに対応したTwilioの**リージョナルAPIキー**を使用する必要があります。標準の米国APIキーは米国以外のリージョンでは使用できず、認証エラーになります。[Twilio Console](https://console.twilio.com/)でリージョン固有のAPIキーを生成してください。

## 設定を確認する

リージョナルルーティングが正しく設定されていることを確認するには：

1. **Twilio Consoleを確認**：電話番号に正しいEdge Locationが表示されていることを確認します
2. **ElevenLabsプラットフォームを確認**：ルーティングリージョンの設定がTwilioの設定と一致することを確認します
3. **通話操作をテスト**：テスト通話を行い、通話転送などの操作が正しく機能することを確認します

> **Tip**
>
> リージョナルルーティングを設定した後、最初の数件の通話を[通話履歴ダッシュボード](https://elevenlabs.io/app/agents/history)で確認し、すべてが想定どおりに動作することを確かめてください。

## よくある問題

#### 通話転送が失敗する

通常、これはリージョナルルーティングの不一致を示しています。以下を確認してください。

* Twilioの電話番号に正しいEdge Locationが設定されている
* ElevenLabsで指定したルーティングリージョンがTwilioの設定と一致している
* ルーティングリージョンに対応する隔離環境を使用している

#### 電話番号は欧州のものなのに米国を経由している

電話番号の地理的な発行元はルーティング動作を決定しません。Twilioでリージョナルルーティングを明示的に設定する必要があります。デフォルトでは、欧州の電話番号を含むすべての番号が、別途設定しない限り`us1`を経由します。

#### 隔離環境を使っていません。それでも必要ですか？

標準のElevenLabs環境（EUデータレジデンシーなどの隔離環境ではない環境）を使用している場合、リージョナルルーティングの設定は任意です。

#### 使用するリージョンはどのように選べばよいですか？

以下を満たすリージョンを選択してください。

* データレジデンシー要件に適合している（例：EUのデータレジデンシーには`ie1`）
* 最適なレイテンシーを得るため、ユーザーに最も近い
* ElevenLabsの隔離環境と一致している（該当する場合）

#### Twilio認証情報で認証エラーが発生する

リージョナルルーティングの使用時に認証エラーが表示される場合は、正しい**リージョナルAPIキー**を使用していることを確認してください。

* リージョナルルーティングには、標準の米国APIキーではなく、Twilioのリージョン固有のAPIキーが必要です
* Twilio Consoleで、対象リージョン（例：`ie1`、`au1`）にスコープ設定された新しいAPIキーを生成します
* ElevenLabsの認証情報をリージョナルAPIキーで更新します
* Account SIDは同じままですが、APIキーはリージョンに対応している必要があります

## ベストプラクティス

* **リージョンを一致させる**：TwilioのリージョナルルーティングをElevenLabs環境と一致させます
* **設定を文書化する**：どの番号がどのリージョンを使用するか記録しておきます
* **十分にテストする**：リージョナルルーティングを変更した後、通話操作が正しく機能することを確認します
* **通話を監視する**：ルーティング問題を示す可能性のある失敗が通話履歴ダッシュボードにないか確認します
* **スケールを計画する**：新しいリージョンへの拡大を予定している場合は、最初からリージョナルルーティングを検討します

## 関連リソース

* [Twilioリージョナルルーティングのドキュメント](https://www.twilio.com/docs/global-infrastructure/edge-locations)
* [ElevenLabsデータレジデンシーガイド](/docs/ja/overview/administration/data-residency)
* [Twilio電話番号ガイド](/docs/ja/eleven-agents/phone-numbers/twilio-integration/native-integration)