SIP トランキング（ベータ）

SIP トランキングの仕組み

SIP トランキングを利用すると、既存のテレフォニーインフラを Cartesia Agents に直接接続できます。 インバウンド通話。 キャリアが Cartesia の SIP エンドポイントにトラフィックを送信します。Cartesia は、ダイヤルされた番号に割り当てられたエージェントに通話をルーティングします。 アウトバウンド通話。 Cartesia はキャリアの SIP エンドポイントを経由して通話を発信します。受信者に表示される発信者番号（Caller ID）はキャリアが決定します。 認証。 インバウンドトラフィックは、ダイジェスト認証、送信元 IP の許可リスト、またはその両方で制限できます。 シグナリングとメディア。 通話設定には TCP または TLS を使用します。TLS はシグナリングを暗号化します。media_encryption 設定は通話音声の SRTP ネゴシエーションを制御します（disabled、allowed、または required）。

PSTN プロバイダーの設定

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

インバウンド通話用に、トランクのオリジネーション URI を Cartesia の SIP エンドポイントに設定します。キャリアがサポートするトランスポートを選択してください。
- TCP: sip:sip.cartesia.ai;transport=tcp
- TLS: sip:sip.cartesia.ai;transport=tls
インバウンドトラフィックを制限します。ダイジェスト認証情報を設定するか、キャリアの SIP シグナリング IP レンジを収集して allowed_addresses に指定します。
アウトバウンド通話用に、Cartesia からの通話を受け入れるようにキャリアを設定します。認証情報またはキャリアがサポートする他の認証方式をセットアップしてください。キャリアやファイアウォールが SIP トラフィックを IP アドレスで制限している場合は、以下の静的 IP ガイダンスを参照してください。
media_encryption: required で TLS を使用する場合は、キャリアで Secure Trunking と SRTP を有効にしてください。Cartesia 側の設定だけではキャリア側の暗号化は有効になりません。

Cartesia SIP 静的 IP レンジ

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

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

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

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

キャリア側の設定が完了したら、Cartesia にトランクを登録します。以下の例では両方向でダイジェスト認証を使用しています。ホスト名と認証情報は、キャリアで設定した値に置き換えてください。すべてのフィールドは Create Provider を参照してください。

curl -X POST "https://api.cartesia.ai/agents/phone-numbers/providers" \
  -H "X-API-Key: $CARTESIA_API_KEY" \
  -H "Cartesia-Version: 2026-03-01" \
  -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 とサニタイズされたトランク設定が含まれます。パスワードは返されません。Cartesia は設定済みの各ユーザー名を 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-03-01" \
  -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"
  }
}

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

インポートした番号をエージェントに割り当てて、インバウンド通話がそのエージェントにルーティングされるようにします。

import 時に agent_id を渡すことで、同じリクエスト内でエージェントを割り当てることもできます。

curl -X PATCH "https://api.cartesia.ai/agents/phone-numbers/ap_M3gdLf1cpaucZJ7xWehCCa" \
  -H "X-API-Key: $CARTESIA_API_KEY" \
  -H "Cartesia-Version: 2026-03-01" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_rwh4HGMgyhK7rM5ucVqbiC"
  }'

想定されるレスポンス：

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

割り当てを解除するには、agent_id を null に設定します。

通話の転送

Cartesia は、SIP REFER による E.164 電話番号へのコールドトランスファーをサポートしています。組み込みの transfer_call ツールをエージェントに追加し、転送先を target_phone_number として指定してください。キャリアは REFER リクエストを受け入れ、tel: ターゲットをルーティングできる必要があります。Twilio Elastic SIP Trunking の場合は、トランクの転送モードを enable-all に設定してください。キャリアが転送を拒否した場合、Cartesia は元の通話を接続したまま維持します。

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

インポートした電話番号を from_number_id として使用し、設定済みのトランク経由でアウトバウンド通話をルーティングします。受信者に表示される発信者番号（Caller ID）はキャリアが決定します。すべてのフィールドは Create Outbound Call を参照してください。

curl -X POST "https://api.cartesia.ai/agents/calls" \
  -H "X-API-Key: $CARTESIA_API_KEY" \
  -H "Cartesia-Version: 2026-03-01" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number_id": "ap_M3gdLf1cpaucZJ7xWehCCa",
    "agent_id": "agent_rwh4HGMgyhK7rM5ucVqbiC",
    "outbound_calls": [
      {
        "to_number": "+14155559876",
        "metadata": {
          "customer_id": "cust_Na9d9f9xK4mN2pQ7vR8wL"
        }
      }
    ]
  }'

想定されるレスポンス：

{"calls":[{"number":"+14155559876","agent_call_id":"ac_gqkgRWUz2u64qFUjA1mZyr"}]}

成功したエントリには agent_call_id が含まれます。失敗したエントリには error が含まれ、通話 ID が省略される場合があります。成功した通話を監視するには Get Call を使用してください。

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

​PSTN プロバイダーの設定

​Cartesia SIP 静的 IP レンジ

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

​番号のインポート

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

​通話の転送

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

SIP トランキングの仕組み

PSTN プロバイダーの設定

Cartesia SIP 静的 IP レンジ

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

番号のインポート

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

通話の転送

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