API Reference
통화 중 안내 재생
진행 중인 통화에 안내 음성을 넣습니다. <Dial> 로 연결된 통화에만 사용할 수 있으며, 통화를 끊지 않고 오디오만 얹습니다.
text 를 주면 그 문장을 읽어 주고, url 을 주면 그 오디오 파일을 재생합니다 (둘 중 하나만 지정). 재생 대상은 target 으로 고릅니다 — 기본값은 양쪽 모두입니다.
접수만 하고 즉시 202 로 응답합니다. 재생이 끝날 때까지 기다리지 않습니다.
아직 연결되지 않았거나(벨 울리는 중) 이미 끝난 통화, 앞선 안내가 재생 중인 통화는 409 로 거절됩니다.
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
application/json
curl -X POST "https://example.com/v1/accounts/AC1a2b3c4d/calls/CA1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6/actions/play" \ -H "Content-Type: application/json" \ -d '{}'{
"callId": "CA1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6",
"playbackId": "b8f1c2d3-4e5f-6789-abcd-ef0123456789",
"status": "playing"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}