電話番号 - Cartesia Docs

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

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

Cartesia 番号

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

Twilio 番号（BYO）

Twilio アカウントから電話番号をインポートして、Twilio がサポートする任意の宛先へのインバウンドおよびアウトバウンド通話など、国際的なフルサポートを利用できます。ステップごとのセットアップについては Twilio インテグレーションガイドを参照してください。

番号の管理

すべての電話番号（Cartesia と Twilio の両方）は電話番号ダッシュボード、Phone Numbers API、または CLI で表示および管理できます。

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

cartesia phone-numbers ls

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

cartesia phone-numbers ls --type twilio
cartesia phone-numbers ls --agent-id <agent-id>

エージェントの割り当て

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

Playground
CLI
API

電話番号をクリックして詳細ページを開きます
Agent カードでエージェントを検索して選択します

cartesia phone-numbers assign <phone-number-id> --agent-id <agent-id>

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

cartesia phone-numbers unassign <phone-number-id>

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 に設定します。

​Cartesia 番号

​Twilio 番号（BYO）

​番号の管理

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

Cartesia 番号

Twilio 番号（BYO）

番号の管理

エージェントの割り当て