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

Twilio の電話番号は、それらを管理するために使用される API 認証情報を通じてリージョンにスコープされます。このリージョンが Twilio API 呼び出しのルーティング方法を決定します。リージョン固有のトラフィックをリージョナル Cartesia クラスターに向けることで、レイテンシの最適化に役立てることができます。

仕組み

Twilio の電話番号を Cartesia にインポートする際：

Twilio が通話をリージョンベースでルーティング: Twilio は、その番号を管理する API キーに設定されたリージョン（us1、ie1（アイルランド）、au1（オーストラリア））に着信通話を振り分けます。
Cartesia は同じリージョンを対象にする必要がある: 進行中の通話に対する操作（転送、保留、切断）を行うため、Cartesia は Twilio に対して API リクエストを返します。これらのリクエストは、Twilio が通話を処理している同じリージョンに到達する必要があります。
プロバイダーにリージョンを設定することで両者を整合: Cartesia のプロバイダーでリージョンを指定すると、Cartesia から送信されるすべての API リクエストが、Twilio の正しいリージョナルエッジに自動的に向けられます。

リージョンは、電話番号の国コードやエージェントのデプロイメントリージョンではなく、プロバイダーの API 認証情報に紐付いています。たとえば、us1 プロバイダー下にある英国の番号（+44...）は、米国の Twilio サーバー経由でルーティングされる可能性があります。最寄りのサーバー経由でルーティングするには、ie1（アイルランド）の API キー下で作成してください。

リージョンが欠けていたり誤っていたりすると、転送やアウトバウンド通話などの操作が失敗します。Twilio 認証情報のリージョンは、Cartesia で指定したリージョンと一致している必要があります。

設定

Twilio リージョンを確認

Twilio Console で Phone Numbers → Manage → Active numbers に移動し、対象の番号を選択して、Voice & Fax 配下の Edge Location を確認します。サポートされるリージョン：us1（米国、デフォルト）、ie1（アイルランド）、au1（オーストラリア）。

必要に応じて Twilio でリージョンを設定

エッジロケーションが希望のリージョンと一致しない場合、電話番号の設定の Voice & Fax セクションで更新して保存します。

デフォルト以外のリージョンを使用するには、Twilio からリージョン固有の API キーを取得する必要があります。米国の標準キーは ie1 や au1 のルーティングには使用できず、認証エラーになります。

Cartesia でリージョンを一致させる

プロバイダーの作成または電話番号のインポート時に、region フィールドを Twilio の構成と一致するように設定します。リージョンが一致しないと、転送などの通話中の操作が認証エラーで失敗します。米国以外のリージョンでは、リージョン固有の Twilio API キーを使用する必要があります。米国の標準キーは機能しません。

マルチリージョン設定

複数の Twilio リージョンで運用する場合は、それぞれに別のプロバイダーオブジェクトを作成します。

Twilio アカウントで、リージョン固有の API キーを作成します（インテグレーションガイドのステップ 2 を参照）
同じ Twilio Account SID を各リージョンにリンクします：

# US region
curl -X POST "https://api.cartesia.ai/agents/phone-numbers/providers" \
  -H "Authorization: Bearer $CARTESIA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Cartesia-Version: 2026-03-01" \
  -d '{
    "type": "twilio",
    "account_sid": "YOUR_TWILIO_ACCOUNT_SID",
    "api_key_sid": "US_API_KEY_SID",
    "api_key_secret": "US_API_KEY_SECRET",
    "region": "us1"
  }'

# Ireland region
curl -X POST "https://api.cartesia.ai/agents/phone-numbers/providers" \
  -H "Authorization: Bearer $CARTESIA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Cartesia-Version: 2026-03-01" \
  -d '{
    "type": "twilio",
    "account_sid": "YOUR_TWILIO_ACCOUNT_SID",
    "api_key_sid": "IE_API_KEY_SID",
    "api_key_secret": "IE_API_KEY_SECRET",
    "region": "ie1"
  }'

\u0001\u0001\u0001 各 Account SID とリージョンの組み合わせは一意です。電話番号は、意図したルーティングリージョンに対応するプロバイダー下にインポートしてください。

トラブルシューティング

症状	原因	対処
アウトバウンド通話が認証エラーで失敗する	API キーのリージョンが Cartesia のプロバイダーのリージョンと一致していない	プロバイダーのリージョンが、Twilio API キーが作成されたリージョンと一致しているか確認する
通話が誤ったリージョンを経由してルーティングされる	電話番号が誤ったプロバイダー下にインポートされている	`PATCH /agents/phone-numbers/{id}` で正しいプロバイダー ID を指定して電話番号のプロバイダーを更新する
認証情報の更新が到達不可能な番号があるため拒否される	新しい API キーがプロバイダーのリージョンの電話番号にアクセスできない	新しいキーがすべての番号にアクセスできることを確認する。Twilio はエラーレスポンスに到達不可能な番号のリストを返す

はじめに

オーディオ連携

デプロイとモニタリング

評価

開発者ツール

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

仕組み

設定

マルチリージョン設定

トラブルシューティング

​仕組み

​設定

​マルチリージョン設定

​トラブルシューティング

仕組み

設定

マルチリージョン設定

トラブルシューティング