SIP トランキング

SIP トランキングは、既存のテレフォニーインフラを Cartesia Agents に直接接続し、エージェントが独自キャリアの番号で通話の受発信を行えるようにします。

Cartesia SIP エンドポイント

キャリアがサポートするトランスポートを使用して、キャリアのオリジネーションを Cartesia の SIP エンドポイントに向けてください。TLS は通話シグナリングを暗号化します。

sip:sip.cartesia.ai;transport=tls

sip:sip.cartesia.ai;transport=tcp

キャリアやファイアウォールが SIP シグナリングを IP アドレスで制限している場合は、許可リストに追加する Cartesia の静的 IP レンジについて support@cartesia.ai までお問い合わせください。

SIP トランキングの仕組み

インバウンド通話

キャリアが Cartesia の SIP エンドポイントにトラフィックを送信します。Cartesia は、ダイヤルされた番号に割り当てられたエージェントに各通話をルーティングします。

アウトバウンド通話

Cartesia はキャリアの SIP エンドポイントを経由して通話を発信します。受信者に表示される発信者番号（Caller ID）はキャリアが決定します。

認証

インバウンドトラフィックは、ダイジェスト認証、送信元 IP の許可リスト、またはその両方で制限できます。

シグナリングとメディア

通話のセットアップには TCP または TLS を使用します。media_encryption 設定は通話音声の SRTP ネゴシエーションを制御します（disabled、allowed、または required）。

キャリアの設定

Cartesia にトランクを登録する前に、以下の手順をキャリア側で完了してください。

オリジネーションを Cartesia に向ける

インバウンド通話用に、トランクのオリジネーション URI を、使用するトランスポートに対応する Cartesia SIP エンドポイントに設定します。

インバウンドトラフィックを制限する

ダイジェスト認証情報を設定するか、allowed_addresses に指定するためにキャリアの SIP シグナリング IP レンジを収集します。

Cartesia からのアウトバウンド通話を受け入れる

認証情報またはキャリアがサポートする他の認証方式で、Cartesia からの通話を受け入れるようにキャリアを設定します。キャリアやファイアウォールが SIP トラフィックを IP アドレスで制限している場合は、Cartesia の静的 IP レンジを許可リストに追加してください。

暗号化を有効にする

media_encryption: required で TLS を使用する場合は、キャリア側でセキュアトランキングと SRTP を有効にしてください。Cartesia 側の設定だけではキャリア側の暗号化は有効になりません。

インバウンドトランクで credentials、allowed_addresses、allowed_numbers をすべて空のままにしないでください。通話を受け入れる前に、少なくとも 1 つのアクセス制御方式を設定してください。

Twilio Elastic SIP Trunking は、インバウンドオリジネーションでのダイジェスト認証をサポートしていません。Twilio の現在のシグナリング IP レンジを allowed_addresses に指定してください。TLS と必須メディア暗号化でアウトバウンド通話を行う場合は、Twilio で Secure Trunking を有効にし、対応する認証情報リストを作成してください。

トランクを Cartesia にリンクする

キャリア側の設定が完了したら、Cartesia にトランクを登録します。以下の例では両方向でダイジェスト認証を使用しています。ホスト名と認証情報は、キャリアで設定した値に置き換えてください。すべてのフィールドは Create Provider を参照してください。 outbound.address は、Cartesia の SIP INVITE を受け取るキャリアのホストで、sip: プレフィックスなしの host または host:port 形式で指定します。ポートを省略すると、Cartesia は tcp では 5060、tls では 5061 を使用します。それ以外のポートで待ち受けるキャリアの場合は、sip.example.com:5067 のようにアドレスにポートを含める必要があります。tls の場合、キャリアはそのホスト名に対して検証できる証明書を提示する必要があります。

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": "sip_trunk",
    "label": "Primary carrier trunk",
    "inbound": {
      "credentials": {
        "username": "carrier-inbound",
        "password": "your-sip-password"
      },
      "media_encryption": "allowed"
    },
    "outbound": {
      "address": "sip.example.com",
      "transport": "tls",
      "destination_country": "US",
      "media_encryption": "required",
      "credentials": {
        "username": "cartesia-outbound",
        "password": "your-sip-password"
      }
    }
  }'

レスポンスには、プロバイダーの id と、パスワードを除いたトランク設定が含まれます。設定済みの各ユーザー名は auth_username として返されます。

{
  "type": "sip_trunk",
  "id": "ata_P4MgdLf1cpaucZJ7xWehCC",
  "label": "Primary carrier trunk",
  "inbound": {
    "allowed_addresses": [],
    "allowed_numbers": [],
    "auth_username": "carrier-inbound",
    "media_encryption": "allowed"
  },
  "outbound": {
    "address": "sip.example.com",
    "destination_country": "US",
    "transport": "tls",
    "media_encryption": "required",
    "auth_username": "cartesia-outbound"
  }
}

番号のインポート

前の手順で取得したプロバイダーの id を使用して、キャリアの番号をインポートします。すべてのフィールドは Import Phone Number を参照してください。

curl -X POST "https://api.cartesia.ai/agents/phone-numbers" \
  -H "X-API-Key: $CARTESIA_API_KEY" \
  -H "Cartesia-Version: 2026-08-14" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Support line",
    "number": "+14155551234",
    "provider": { "id": "ata_P4MgdLf1cpaucZJ7xWehCC" }
  }'

想定されるレスポンス：

{
  "id": "ap_M3gdLf1cpaucZJ7xWehCCa",
  "label": "Support line",
  "number": "+14155551234",
  "agent": null,
  "provider": {
    "type": "sip_trunk",
    "id": "ata_P4MgdLf1cpaucZJ7xWehCC",
    "label": "Primary carrier trunk"
  }
}

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

インポートした番号をエージェントに割り当てて、インバウンド通話がそのエージェントにルーティングされるようにします。割り当ては、プレイグラウンドの番号詳細ページから、または Phone Numbers API を通じて行えます。インポートと同じリクエスト内で割り当てるには、Import Phone Number に agent_id を渡してください。

通話の転送

Cartesia は、SIP REFER による E.164 電話番号および SIP URI へのコールドトランスファーをサポートしています。Playground で Transfer call を有効にするか、API を通じて transfer_to_number システムツールを設定してください。各ルールは、電話番号または sip:user@host のような直接の SIP アドレスをターゲットにできます。 Cartesia は、電話番号の転送先を tel:+E.164 として、SIP の転送先を設定された URI として送信します。キャリアは、選択した転送先タイプへの SIP REFER 転送をサポートしている必要があります。Twilio Elastic SIP Trunking の場合は、トランクの転送モードを enable-all に設定してください。キャリアが転送を拒否した場合、Cartesia は元の通話を接続したまま維持します。

アウトバウンド通話の発信

アウトバウンド通話を発信する際に、インポートした番号を from_number_id として使用します。Cartesia は設定済みのトランク経由で通話を発信し、受信者に表示される発信者番号（Caller ID）はキャリアが決定します。

はじめに

エージェント管理

ツール

オーディオ統合

テレフォニー

評価

移行

Cartesia SIP エンドポイント

SIP トランキングの仕組み

インバウンド通話

アウトバウンド通話

認証

シグナリングとメディア

キャリアの設定

トランクを Cartesia にリンクする

番号のインポート

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

通話の転送

アウトバウンド通話の発信

​Cartesia SIP エンドポイント

​SIP トランキングの仕組み

インバウンド通話

アウトバウンド通話

認証

シグナリングとメディア

​キャリアの設定

​トランクを Cartesia にリンクする

​番号のインポート

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

​通話の転送

​アウトバウンド通話の発信

Cartesia SIP エンドポイント

SIP トランキングの仕組み

キャリアの設定

トランクを Cartesia にリンクする

番号のインポート

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

通話の転送

アウトバウンド通話の発信