통화 녹음 - vox.ai Docs

vox.ai는 모든 통화의 음성을 자동으로 녹음합니다. 녹음에는 사용자(발신자)와 에이전트의 발화가 함께 담기며, 대시보드에서 재생하거나 API·웹훅으로 받은 URL에서 내려받을 수 있습니다.

녹음 파일 형식

통화 한 건은 하나의 스테레오 OGG 파일로 저장됩니다. 사용자와 에이전트의 음성이 좌우 채널로 분리되어 있어, 화자별로 또렷하게 구분됩니다.

채널이 분리되어 있어 화자별 음성을 따로 추출할 수 있습니다. STT(음성 인식), 품질 검토, 감정 분석처럼 한 화자만 분석해야 할 때 유용합니다.

대시보드 통화 기록에서 통화를 열면 상세 패널의 녹음 재생 플레이어로 바로 들을 수 있습니다. 로그인 세션으로 동작하므로 별도 인증이 필요 없습니다.

녹음 파일 URL(recording_url)은 다음에서 받습니다.

recording_url은 인증이 필요한 엔드포인트입니다. 서버에서 원본을 받으려면 API 키를 헤더에 붙여 GET 하세요.

cURL

curl --request GET \
  --url "<recording_url>" \
  --header 'Authorization: Bearer <token>' \
  --output recording.ogg

API 키가 속한 워크스페이스가 해당 통화를 소유해야 하며, 다른 워크스페이스의 녹음은 받을 수 없습니다.