デプロイ電話Twilio

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

データレジデンシー要件への準拠を確保するため、Twilio電話番号のリージョナルルーティングを設定します。

概要

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

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

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

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

デフォルトでは、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リージョンを対象にするようにします

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

設定

1

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

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

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

代表的なTwilioリージョン：

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

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

2

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

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

  1. Twilio Consoleで電話番号の設定を開きます
  2. Voice & Faxセクションを見つけます
  3. Edge Locationを使用するリージョンに設定します
  4. 設定を保存します

Twilioでリージョナルルーティングを設定するには、追加の設定やアカウント権限が必要になる場合があります。アカウントでリージョナルルーティングを有効にする際に支援が必要な場合は、Twilio Supportにお問い合わせください。

3

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

ElevenLabsの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アカウントで設定されているリージョンと一致することを確認します

    リージョナルルーティングを使用する場合は、ルーティングリージョンに対応したTwilioのリージョナルAPIキーを使用する必要があります。標準の米国APIキーは米国以外のリージョンでは使用できず、認証エラーになります。Twilio Consoleでリージョン固有のAPIキーを生成してください。

設定を確認する

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

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

リージョナルルーティングを設定した後、最初の数件の通話を通話履歴ダッシュボードで確認し、すべてが想定どおりに動作することを確かめてください。

よくある問題

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

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

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

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

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

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

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

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

ベストプラクティス

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

関連リソース