ClawOps APICalls

통화 중 안내 재생

View as Markdown
진행 중인 통화에 안내 음성을 넣습니다. `<Dial>` 로 **연결된 통화**에만 사용할 수 있으며, 통화를 끊지 않고 오디오만 얹습니다. `text` 를 주면 그 문장을 읽어 주고, `url` 을 주면 그 오디오 파일을 재생합니다 (둘 중 하나만 지정). 재생 대상은 `target` 으로 고릅니다 — 기본값은 양쪽 모두입니다. **접수만 하고 즉시 202 로 응답합니다.** 재생이 끝날 때까지 기다리지 않습니다. 아직 연결되지 않았거나(벨 울리는 중) 이미 끝난 통화, 앞선 안내가 재생 중인 통화는 409 로 거절됩니다.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

callIdstringRequired

통화 ID

Request

This endpoint expects an object.
textstringOptional

읽어 줄 문장. url 과 함께 쓸 수 없습니다.

urlstringOptionalformat: "uri"

재생할 오디오 파일 URL (mp3/wav). text 와 함께 쓸 수 없습니다.

languageenumOptionalDefaults to ko

text 를 읽을 언어. 기본값: ko

Allowed values:
voicestringOptional
`text` 를 읽을 음성. VoiceML `<Say>` 의 `voice` 와 같은 형식입니다 — 생략하면 무료 기본 음성으로 읽고(요금 없음), `cartesia` 또는 `cartesia:<음성 ID>` 를 지정하면 고품질 음성으로 읽으며 읽은 글자 수만큼 과금됩니다. 통화 중 다른 안내와 음색을 맞추려면 `<Say>` 에 쓴 값과 같은 값을 주세요.
targetenumOptionalDefaults to both

재생 대상. both=양쪽 모두 / caller=발신자만 / callee=연결된 상대만. 기본값: both

Allowed values:

Response

재생 접수됨

callIdstringOptional

대상 통화 ID

playbackIdstring or nullOptional

재생 식별자

statusstringOptional

처리 상태

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error
502
Bad Gateway Error
503
Service Unavailable Error