통화

통화 오디오 스트림 시작

Markdown으로 보기
POST
/v1/accounts/{accountId}/calls/{callId}/streams

진행 중인 통화의 오디오를 실시간으로 WebSocket 서버에 보냅니다. 통화는 그대로 유지되며, 이후 <Dial> 로 다른 번호에 연결되거나 전환되어도 스트림은 계속됩니다.

track 으로 받을 소리를 고릅니다 — inbound_track 은 통화 상대(발신자)의 목소리, outbound_track 은 상대에게 들리는 소리(연결된 상담원·안내 음성 등), both_tracks 는 둘 다입니다. 둘 다 받으면 하나의 WebSocket 으로 오며 media.track(inbound/outbound) 으로 구분합니다. 메시지 형식은 Stream 프로토콜 과 같습니다.

수신 전용입니다 — WebSocket 서버가 보낸 오디오는 통화에 들어가지 않습니다. VoiceML <Start><Stream> 과 같은 기능입니다.

WebSocket 연결을 기다리지 않고 응답합니다. 연결 실패는 statusCallback (StreamEvent=stream-error)과 통화 이벤트로 알립니다. 통화당 1개까지 열 수 있습니다(두 트랙이 필요하면 both_tracks 하나로 받습니다).

Authorization

BearerAuth
AuthorizationBearer <token>

API Key를 Bearer 토큰으로 전달

In: header

Path Parameters

accountId*string

계정 ID

callId*string

통화 ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/accounts/AC1a2b3c4d/calls/CA1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6/streams" \  -H "Content-Type: application/json" \  -d '{    "url": "wss://your-server.com/stream"  }'
{
  "callId": "CA1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6",
  "streamId": "MZ0123456789abcdef0123456789abcdef",
  "name": "stt",
  "track": "both_tracks",
  "status": "in-progress"
}
{
  "error": "string",
  "code": "recipient_blocked",
  "ip": "52.79.213.41",
  "processedAt": "2026-10-21T04:10:34.303Z",
  "blockers": [
    {
      "number": "07012340002",
      "code": "number_not_carrier_issued",
      "message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
    }
  ],
  "numbers": [
    "07012345678"
  ]
}
{
  "error": "string",
  "code": "recipient_blocked",
  "ip": "52.79.213.41",
  "processedAt": "2026-10-21T04:10:34.303Z",
  "blockers": [
    {
      "number": "07012340002",
      "code": "number_not_carrier_issued",
      "message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
    }
  ],
  "numbers": [
    "07012345678"
  ]
}
{
  "error": "string",
  "code": "recipient_blocked",
  "ip": "52.79.213.41",
  "processedAt": "2026-10-21T04:10:34.303Z",
  "blockers": [
    {
      "number": "07012340002",
      "code": "number_not_carrier_issued",
      "message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
    }
  ],
  "numbers": [
    "07012345678"
  ]
}
{
  "error": "string",
  "code": "recipient_blocked",
  "ip": "52.79.213.41",
  "processedAt": "2026-10-21T04:10:34.303Z",
  "blockers": [
    {
      "number": "07012340002",
      "code": "number_not_carrier_issued",
      "message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
    }
  ],
  "numbers": [
    "07012345678"
  ]
}
{
  "error": "string",
  "code": "recipient_blocked",
  "ip": "52.79.213.41",
  "processedAt": "2026-10-21T04:10:34.303Z",
  "blockers": [
    {
      "number": "07012340002",
      "code": "number_not_carrier_issued",
      "message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
    }
  ],
  "numbers": [
    "07012345678"
  ]
}
{
  "error": "string",
  "code": "recipient_blocked",
  "ip": "52.79.213.41",
  "processedAt": "2026-10-21T04:10:34.303Z",
  "blockers": [
    {
      "number": "07012340002",
      "code": "number_not_carrier_issued",
      "message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
    }
  ],
  "numbers": [
    "07012345678"
  ]
}
{
  "error": "string",
  "code": "recipient_blocked",
  "ip": "52.79.213.41",
  "processedAt": "2026-10-21T04:10:34.303Z",
  "blockers": [
    {
      "number": "07012340002",
      "code": "number_not_carrier_issued",
      "message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
    }
  ],
  "numbers": [
    "07012345678"
  ]
}