통화
통화 오디오 스트림 시작
진행 중인 통화의 오디오를 실시간으로 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 API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
계정 ID
통화 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"
]
}