Skip to main content
vox.ai는 모든 통화의 음성을 자동으로 녹음합니다. 녹음에는 사용자(발신자)와 에이전트의 발화가 함께 담기며, 대시보드에서 재생하거나 API·웹훅으로 받은 URL에서 내려받을 수 있습니다.
에이전트의 데이터 보존 정책에서 통화 녹음을 선택하지 않으면, 이후 통화의 녹음은 대시보드·API·CLI에서 제공되지 않습니다.

녹음 파일 형식

통화 한 건은 하나의 스테레오 OGG 파일로 저장됩니다. 사용자와 에이전트의 음성이 좌우 채널로 분리되어 있어, 화자별로 또렷하게 구분됩니다.
채널이 분리되어 있어 화자별 음성을 따로 추출할 수 있습니다. STT(음성 인식), 품질 검토, 감정 분석처럼 한 화자만 분석해야 할 때 유용합니다.

녹음 듣기

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

녹음 내려받기

녹음 파일 URL(recording_url)은 다음에서 받습니다.
  • 웹훅 call_ended 이벤트의 call.recording_url
  • 통화 조회 API 응답의 recording_url
recording_url은 인증이 필요한 엔드포인트입니다. 서버에서 원본을 받으려면 API 키를 헤더에 붙여 GET 하세요.
cURL
API 키가 속한 워크스페이스가 해당 통화를 소유해야 하며, 다른 워크스페이스의 녹음은 받을 수 없습니다.

데이터 보존

  • 녹음 보관 기간은 에이전트의 데이터 보존 정책에서 설정합니다.
  • 보존 기간은 통화 종료 시각부터 계산합니다.
  • 통화 녹음을 선택하지 않으면 통화 종료 10분 뒤에 녹음이 삭제됩니다. 보존 기간을 정한 경우 기간이 지나면 삭제됩니다.
  • 삭제된 녹음은 재생하거나 내려받을 수 없습니다.

관련 문서


통화 녹음, call recording, recording_url, 녹음 다운로드, recording download, OGG, Opus, 스테레오, 채널 분리, 녹음 파일, audio recording