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

# 電話番号

> 音声エージェントに電話番号を接続して、インバウンドおよびアウトバウンドの通話を行います。

Cartesia では、エージェントに電話番号を接続する 2 つの方法をサポートしています。Cartesia がプロビジョニングする番号と、Twilio（持ち込み）番号です。

| 機能           | Cartesia 番号 | Twilio 番号                                                    |
| ------------ | ----------- | ------------------------------------------------------------ |
| 番号の発行元       | 米国のみ        | Twilio で利用可能な任意の国                                            |
| インバウンド通話     | ✓           | ✓                                                            |
| 米国向けアウトバウンド  | ✓           | ✓                                                            |
| 国際アウトバウンド    | ✗           | ✓（Twilio の料金がかかります）                                          |
| リージョナルルーティング | 該当なし        | [構成可能](/line/integrations/telephony/twilio/regional-routing) |
| プロビジョニング     | 自動          | Twilio からインポート                                               |
| 料金           | プランに含まれる    | Twilio の利用料金                                                 |

## Cartesia 番号

Cartesia は、サブスクリプションプランに紐づく米国の電話番号をプロビジョニングします。プレイグラウンドまたは API から番号をプロビジョニングして、すぐにエージェントに割り当てられます。

セットアップと管理については [Cartesia 番号ガイド](/line/integrations/telephony/cartesia-numbers) を参照してください。

## Twilio 番号（BYO）

Twilio アカウントから電話番号をインポートして、Twilio がサポートする任意の宛先へのインバウンドおよびアウトバウンド通話など、国際的なフルサポートを利用できます。

ステップごとのセットアップについては [Twilio インテグレーションガイド](/line/integrations/telephony/twilio/integration) を参照してください。

## 番号の管理

すべての電話番号（Cartesia と Twilio の両方）は [電話番号ダッシュボード](https://play.cartesia.ai/phone-numbers)、[Phone Numbers API](/api-reference/agents/phone-numbers/list)、または [CLI](/line/cli#phone-numbers) で表示および管理できます。

<Frame caption="プレイグラウンドの電話番号">
  <img src="https://mintcdn.com/cartesia-2650f86a/cyPOLB5BGhebR1Zv/assets/images/agents/telephony/phone-number-list.png?fit=max&auto=format&n=cyPOLB5BGhebR1Zv&q=85&s=e63d2eda17e41ce0db850f62137e6340" alt="プレイグラウンドの電話番号タブで番号を一覧表示" width="1699" height="816" data-path="assets/images/agents/telephony/phone-number-list.png" />
</Frame>

CLI からすべての電話番号を一覧表示します：

```zsh lines theme={null}
cartesia phone-numbers ls
```

プロバイダーの種類またはエージェントでフィルタリングします：

```zsh lines theme={null}
cartesia phone-numbers ls --type twilio
cartesia phone-numbers ls --agent-id <agent-id>
```

### エージェントの割り当て

電話番号をエージェントに割り当てると、その番号へのインバウンド通話がエージェントにルーティングされます。1 つの番号は同時に 1 つのエージェントにのみ割り当てられますが、1 つのエージェントに対しては複数の番号をルーティングできます。

<Tabs>
  <Tab title="Playground">
    1. 電話番号をクリックして詳細ページを開きます
    2. **Agent** カードでエージェントを検索して選択します
  </Tab>

  <Tab title="CLI">
    ```zsh lines theme={null}
    cartesia phone-numbers assign <phone-number-id> --agent-id <agent-id>
    ```

    エージェントから番号の割り当てを解除するには：

    ```zsh lines theme={null}
    cartesia phone-numbers unassign <phone-number-id>
    ```
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    curl -X PATCH "https://api.cartesia.ai/agents/phone-numbers/YOUR_PHONE_NUMBER_ID" \
      -H "Authorization: Bearer $CARTESIA_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Cartesia-Version: 2026-03-01" \
      -d '{
        "agent_id": "YOUR_AGENT_ID"
      }'
    ```

    割り当てを解除するには、`agent_id` を `null` に設定します。
  </Tab>
</Tabs>