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

SIP トランキングの仕組み

SIP トランキングを利用すると、既存のテレフォニーインフラを Cartesia Agents に直接接続できます。 インバウンド通話 — トランクからのトラフィックは Cartesia の SIP エンドポイントに送信されます。番号へのインバウンド通話は、その番号に割り当てられたエージェントにルーティングされます。 アウトバウンド通話 — Cartesia はトランクの SIP ホスト名経由で通話を発信するため、発信通話には利用中のキャリアと発信者番号（Caller ID）が使用されます。認証 — ダイジェスト認証（ユーザー名とパスワード）や、特定の送信元 IP のみを許可することで、トラフィックの送信元を制限できます。 シグナリングとメディア — 通話設定（シグナリング）には TCP または TLS を使用します。暗号化されたシグナリングが必要な場合は TLS を使用してください。通話が確立された後、RTP 音声は media_encryption 設定（disabled、allowed、または required）に従って暗号化できます。

PSTN プロバイダーの設定

利用中の PSTN プロバイダーの SIP トランク設定で、トランクの向き先を Cartesia の SIP エンドポイントに指定します。キャリアがサポートするトランスポートを選択してください。

TCP: sip:sip.cartesia.ai;transport=tcp
TLS: sip:sip.cartesia.ai;transport=tls（暗号化されたシグナリング）

トランクを 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": {
      "media_encryption": "allowed"
    },
    "outbound": {
      "address": "abcd1234.pstn.twilio.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": "",
    "media_encryption": "allowed"
  },
  "outbound": {
    "address": "abcd1234.pstn.twilio.com",
    "destination_country": "US",
    "transport": "tls",
    "media_encryption": "required",
    "auth_username": "example_username"
  }
}

番号のインポート

前の手順で取得したプロバイダーの 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 に設定します。

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

インポートした電話番号を使用してアウトバウンド通話をルーティングします。発信者番号（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"}]}

レスポンスには宛先ごとに通話 ID が含まれます。通話ステータスを監視するには Get Call を使用してください。

はじめに

オーディオ連携

デプロイとモニタリング

評価

開発者ツール

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

SIP トランキングの仕組み

PSTN プロバイダーの設定

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

番号のインポート

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

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

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

​PSTN プロバイダーの設定

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

​番号のインポート

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

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

SIP トランキングの仕組み

PSTN プロバイダーの設定

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

番号のインポート

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

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