> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 통화 녹음

> 통화 녹음이 어떻게 저장되고, 어디서 듣고 내려받는지 확인하세요.

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

<Note>
  에이전트의 [데이터 보존 정책](/docs/build/security/data-retention)에서 **통화 녹음**을 선택하지 않으면, 이후 통화의 녹음은 대시보드·API·CLI에서 제공되지 않습니다.
</Note>

## 녹음 파일 형식

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

| 항목         | 값           |
| ---------- | ----------- |
| 컨테이너       | OGG         |
| 코덱         | Opus        |
| 샘플레이트      | 48 kHz      |
| 채널         | 스테레오(2채널)   |
| **왼쪽 채널**  | 사용자(발신자) 음성 |
| **오른쪽 채널** | 에이전트 음성     |

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

## 녹음 듣기

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

## 녹음 내려받기

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

* [웹훅](/docs/operate/monitor/webhooks/schema#call_ended) `call_ended` 이벤트의 `call.recording_url`
* 통화 조회 API 응답의 `recording_url`

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

```bash cURL theme={null}
curl --request GET \
  --url "<recording_url>" \
  --header 'Authorization: Bearer <token>' \
  --output recording.ogg
```

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

## 데이터 보존

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

## 관련 문서

* [통화 기록](/docs/operate/monitor/history) — 통화 목록과 상세 패널
* [웹훅 스키마](/docs/operate/monitor/webhooks/schema) — `recording_url`을 포함한 페이로드 구조
* [데이터 보존 정책](/docs/build/security/data-retention) — 녹음 보관 기간과 저장 여부 설정

***

<Accordion title="연관 검색어">
  통화 녹음, call recording, recording\_url, 녹음 다운로드, recording download, OGG, Opus, 스테레오, 채널 분리, 녹음 파일, audio recording
</Accordion>