# 통화 녹음 (/docs/call-recording)

## 통화 녹음

통화 녹음을 켜면 모든 통화가 자동으로 녹음됩니다. 녹음 파일은 통화가 끝나고 수초 안에 준비되며,
[Recording Webhook](/docs/webhooks/recording) 으로 완료 알림을 받을 수 있습니다.

## 켜고 끄기

콘솔 **부가서비스 → 통화 녹음** 에서 켜고 끕니다. 별도 요금은 없습니다.

녹음 기능 사용 시 관련 법령 준수 책임은 고객사에 있습니다. 통화 상대에게 녹음 사실을 알려야 하는지 확인하세요.

## 녹음 파일

| 항목 | 내용 |
| --- | --- |
| 형식 | WAV (16-bit PCM, mono, 8kHz) — 양쪽 목소리가 한 파일에 담깁니다 |
| 보관 기간 | 기본 90일. 이후 자동 삭제됩니다. [보관 기간](#보관-기간) 에서 7일·30일로 줄일 수 있습니다 |
| 다운로드 | [통화 녹음 다운로드](/docs/api/calls/getRecording) `GET /v1/accounts/{accountId}/recordings/{callId}` — 15분 동안 유효한 다운로드 주소로 이동(302)합니다 |
| 삭제 | [통화 녹음 삭제](/docs/api/calls/deleteRecording) — 보관 기간 전에 지워야 할 때. 호출 즉시 파일이 삭제되며 되돌릴 수 없습니다 |
| 완료 알림 | [Recording Webhook](/docs/webhooks/recording) 의 `recording.completed` |

## 보관 기간

**부가서비스 → 통화 녹음 → 보관 기간** 에서 통화 녹음을 며칠 보관할지 고릅니다. 계정 소유자만 바꿀 수 있습니다.

| 설정 | 삭제 시점 |
| --- | --- |
| **7일** | 통화일로부터 7일이 지나면 매일 오전 11시(한국 시간)에 삭제됩니다 |
| **30일** | 통화일로부터 30일이 지나면 매일 오전 11시(한국 시간)에 삭제됩니다 |
| **90일** (기본값) | 녹음 파일이 만들어지고 90일이 지나면 삭제됩니다 |

기간을 줄이면 이미 있는 녹음에도 적용되어, 새 기간이 지난 녹음은 다음 정리 때 삭제됩니다. 삭제된 녹음은 되돌릴 수 없습니다.

기간을 늘리면 아직 남아 있는 녹음부터 새 기간이 적용됩니다.

[콜 플로우](/docs/webhooks/callflow) 의 녹음 블럭 녹음은 이 설정과 관계없이 90일간 보관됩니다.

## 녹음 시작 시점

**부가서비스 → 통화 녹음 → 녹음 시작 시점** 에서 **발신 통화** 를 언제부터 녹음할지 고릅니다.
수신 통화에는 적용되지 않습니다.

| 설정 | 녹음 범위 | 상대가 받지 않은 통화 |
| --- | --- | --- |
| **받은 후부터** (기본값) | 상대가 전화를 받은 뒤부터 | 녹음하지 않습니다 |
| **신호음부터** | 전화를 건 직후부터. 연결음·컬러링·안내 멘트 등 통신사가 받기 전에 보내 주는 소리가 함께 담깁니다 | 녹음합니다 |

통화 녹음이 꺼져 있으면 이 설정은 적용되지 않습니다.

### 신호음부터로 설정하면 달라지는 점

- **받지 않은 통화도 녹음됩니다.** 벨이 울린 뒤 끊긴 통화에도 녹음 파일이 생기고 `recording.completed` 가 전송됩니다.
- **웹훅에 필드 두 개가 더해집니다.** `recording.completed` 에 녹음 파일 길이(`RecordingDurationSec`)와, 녹음 시작 후 상대가 받기까지 걸린 초(`AnswerOffsetSec`)가 담깁니다. 받지 않은 통화에는 `AnswerOffsetSec` 가 없습니다.
- **받아쓰기 요금은 녹음 길이 기준입니다.** 통화 받아쓰기를 사용 중이면 받지 않은 통화도 받아쓰기되며, 받기 전 구간을 포함한 녹음 길이로 계산됩니다.
- **통화 요금은 그대로입니다.** 설정과 관계없이 상대가 받은 시점부터 계산됩니다. 받지 않은 통화는 통화 요금이 없습니다.
- **받아쓰기 시간 정보는 녹음 시작 기준입니다.** 통화 구간만 보려면 각 시간에서 `AnswerOffsetSec` 를 빼세요.

예: 12초 동안 벨이 울린 뒤 받아 87초 통화한 경우

| 항목 | 값 |
| --- | --- |
| 녹음 파일 길이 (`RecordingDurationSec`) | 99초 |
| 받기까지 걸린 시간 (`AnswerOffsetSec`) | 12초 |
| 통화 길이 (`DurationSec`) · 통화 요금 기준 | 87초 |
| 받아쓰기 요금 기준 | 99초 |

받기 전 구간에 어떤 소리가 담기는지는 상대 번호와 통신사에 따라 다릅니다. 일반 연결음만 들리는 경우도 많습니다.

### 벨이 울리기 전에 끝난 통화

없는 번호, 번호 형식 오류처럼 **벨이 울리기 전에 거절된 통화** 는 받기 전 구간에도 소리가 없으므로 녹음되지 않습니다.
이런 통화는 녹음이 아니라 통화 결과로 판별하세요 — 통화 조회 응답과 Status Callback 의 `hangupCause`
(예: 없는 번호는 `invalid_number`)에 사유가 남습니다. 자세한 값은 [통화 실패 원인](/docs/call-failure-causes) 을 보세요.

## 받아쓰기·요약

**부가서비스 → 통화 받아쓰기** 를 켜면 녹음이 끝난 뒤 자동으로 받아쓰기되고, 완료되면
[Transcript Webhook](/docs/webhooks/transcript) 이 전송됩니다. 받아쓰기는 통화 녹음이 켜져 있어야 사용할 수 있습니다.