> ## 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 番号

> 音声エージェント用の Cartesia 電話番号をプロビジョニングおよび管理します。

Cartesia を使って無料の電話番号を作成できます。無料電話番号の数はサブスクリプションプランによって異なります。

| プラン        | 電話番号スロット |
| ---------- | -------- |
| Free       | 1        |
| Pro        | 3        |
| Startup    | 5        |
| Scale      | 10       |
| Enterprise | カスタム     |

Cartesia がプロビジョニングする番号にはいくつかの制限があります。

* **米国の番号のみ** — Cartesia マネージドの番号はすべて米国の番号です
* **アウトバウンドは米国のみ** — アウトバウンド通話は、エージェントのデプロイメントリージョンに関わらず、米国の宛先番号に限定されます

<Frame caption="電話番号の追加">
  <img src="https://mintcdn.com/cartesia-2650f86a/cyPOLB5BGhebR1Zv/assets/images/agents/telephony/add-number.png?fit=max&auto=format&n=cyPOLB5BGhebR1Zv&q=85&s=96bdbc29a93702999d8d16e9748dfae9" alt="電話番号の取得" width="2890" height="442" data-path="assets/images/agents/telephony/add-number.png" />
</Frame>

## 番号のプロビジョニング

<Tabs>
  <Tab title="Playground">
    1. サイドバーの **Phone Numbers** に移動します
    2. **Add Number** → **Cartesia Number** をクリックします
    3. 番号の名前を入力します
    4. 必要に応じてエージェントを割り当てます

    <Frame caption="Cartesia のプロビジョニングパネル">
      <img src="https://mintcdn.com/cartesia-2650f86a/cyPOLB5BGhebR1Zv/assets/images/agents/telephony/provision-panel.png?fit=max&auto=format&n=cyPOLB5BGhebR1Zv&q=85&s=88b7c49fbabb0c976f48ef1bae339cee" alt="Cartesia 番号のプロビジョニング" width="2886" height="1920" data-path="assets/images/agents/telephony/provision-panel.png" />
    </Frame>
  </Tab>

  <Tab title="CLI">
    ```zsh lines theme={null}
    cartesia phone-numbers provision "My Agent Number"
    ```

    プロビジョニングと同時にエージェントへ割り当てるには：

    ```zsh lines theme={null}
    cartesia phone-numbers provision "My Agent Number" --agent-id <agent-id>
    ```
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    curl -X POST "https://api.cartesia.ai/agents/phone-numbers/provision" \
      -H "Authorization: Bearer $CARTESIA_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Cartesia-Version: 2026-03-01" \
      -d '{
        "label": "My Agent Number"
      }'
    ```
  </Tab>
</Tabs>

<Note>
  電話番号の上限に達している場合は、既存の Cartesia 番号を削除するか、プランをアップグレードして追加してください。
</Note>

## 番号の削除

削除は永続的です。番号は解放され、復元できません。

<Tabs>
  <Tab title="Playground">
    1. **Phone Numbers** に移動し、対象の番号をクリックします
    2. エージェントへの割り当てを解除します
    3. **Delete** をクリックします
  </Tab>

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

    番号がエージェントに割り当てられている場合、CLI はまず割り当て解除を促します。
  </Tab>

  <Tab title="API">
    まず番号の割り当てを解除してから削除します：

    ```bash theme={null}
    curl -X DELETE "https://api.cartesia.ai/agents/phone-numbers/YOUR_PHONE_NUMBER_ID" \
      -H "Authorization: Bearer $CARTESIA_API_KEY" \
      -H "Cartesia-Version: 2026-03-01"
    ```
  </Tab>
</Tabs>