> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Twilio のリージョンが通話ルーティングと認証情報のスコープにどのように影響するか。

Twilio の電話番号は、それらを管理するために使用される API 認証情報を通じてリージョンにスコープされます。

このリージョンが Twilio API 呼び出しのルーティング方法を決定します。リージョン固有のトラフィックをリージョナル Cartesia クラスターに向けることで、レイテンシの最適化に役立てることができます。

## 仕組み

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

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

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

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

## 設定

<Steps>
  <Step title="Twilio リージョンを確認">
    [Twilio Console](https://console.twilio.com/) で **Phone Numbers → Manage → Active numbers** に移動し、対象の番号を選択して、**Voice & Fax** 配下の **Edge Location** を確認します。

    サポートされるリージョン：`us1`（米国、デフォルト）、`ie1`（アイルランド）、`au1`（オーストラリア）。
  </Step>

  <Step title="必要に応じて Twilio でリージョンを設定">
    エッジロケーションが希望のリージョンと一致しない場合、電話番号の設定の **Voice & Fax** セクションで更新して保存します。

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

  <Step title="Cartesia でリージョンを一致させる">
    プロバイダーの作成または電話番号のインポート時に、`region` フィールドを Twilio の構成と一致するように設定します。リージョンが一致しないと、転送などの通話中の操作が認証エラーで失敗します。

    米国以外のリージョンでは、リージョン固有の Twilio API キーを使用する必要があります。米国の標準キーは機能しません。
  </Step>
</Steps>

## マルチリージョン設定

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

1. Twilio アカウントで、リージョン固有の API キーを作成します（[インテグレーションガイドのステップ 2](/line/integrations/telephony/twilio/integration#step-2-create-an-api-key) を参照）
2. 同じ Twilio Account SID を各リージョンにリンクします：

```bash theme={null}
# 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 はエラーレスポンスに到達不可能な番号のリストを返す           |