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

Twilio の電話番号は、その管理に使用する API 認証情報を通じてリージョンにスコープされます。リージョンは Twilio が API 呼び出しをどのようにルーティングするかを決定し、これを一致させることで、Cartesia はリージョン固有のトラフィックを近くのクラスターから処理できます。

仕組み

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

Twilio が通話をリージョナルにルーティングします。 Twilio は、番号を管理する API キーに設定されたリージョン（us1、ie1（アイルランド）、au1（オーストラリア））に着信通話を振り向けます。
Cartesia は同じリージョンを対象にする必要があります。 転送や切断など、進行中の通話を操作するために、Cartesia は Twilio へ API リクエストを送り返します。これらのリクエストは、Twilio がその通話を処理しているリージョンに届く必要があります。
プロバイダー上のリージョンが両者を揃えます。 Cartesia のプロバイダーにリージョンを設定すると、Cartesia からのすべてのリクエストがその Twilio リージョナルエッジを対象とします。

リージョンはプロバイダーの API 認証情報に紐づいており、電話番号の国番号やエージェントのリージョンには紐づいていません。us1 プロバイダー配下の英国番号（+44...）は、米国の Twilio サーバーを経由してルーティングされます。最寄りのサーバーを経由させるには、ie1 プロバイダー配下でインポートしてください。

リージョンが未設定または誤っている場合、転送とアウトバウンド通話は認証エラーで失敗します。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 でリージョンを一致させる

プロバイダーの作成時または電話番号のインポート時に、Twilio の設定と一致するように region を設定します。

複数リージョンのセットアップ

複数の Twilio リージョンで運用している場合は、リージョンごとに 1 つのプロバイダーを作成します：

Twilio でリージョン固有の API キーを作成します（インテグレーションガイドのステップ 2を参照）。
同じ Twilio Account SID をリージョンごとに 1 回ずつリンクします：

# 米国リージョン
curl -X POST "https://api.cartesia.ai/agents/phone-numbers/providers" \
  -H "X-API-Key: $CARTESIA_API_KEY" \
  -H "Cartesia-Version: 2026-08-14" \
  -H "Content-Type: application/json" \
  -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"
  }'

# アイルランドリージョン
curl -X POST "https://api.cartesia.ai/agents/phone-numbers/providers" \
  -H "X-API-Key: $CARTESIA_API_KEY" \
  -H "Cartesia-Version: 2026-08-14" \
  -H "Content-Type: application/json" \
  -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"
  }'

Account SID とリージョンの各ペアは一意です。各電話番号は、そのルーティングリージョンに一致するプロバイダー配下でインポートしてください。

トラブルシューティング

症状	原因	対処
アウトバウンド通話が認証エラーで失敗する	API キーのリージョンがプロバイダーのリージョンと一致していない	プロバイダーのリージョンを、Twilio API キーが作成されたリージョンに設定する
通話が誤ったリージョンを経由してルーティングされる	番号が誤ったプロバイダー配下でインポートされた	`PATCH /agents/phone-numbers/{id}` で番号のプロバイダーを更新する
アクセスできない番号があるとして認証情報の更新が拒否される	新しい API キーがプロバイダーのリージョン内の番号にアクセスできない	すべての番号にアクセスできるキーを使用する。Twilio はアクセスできない番号をエラーレスポンスに列挙します

​仕組み

​リージョンの設定

​複数リージョンのセットアップ

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

仕組み

リージョンの設定

複数リージョンのセットアップ

トラブルシューティング