통화 기능
통화 녹음
통화 녹음을 켜고, 녹음 파일을 받고, 발신 통화를 받기 전(연결음)부터 녹음하도록 설정하는 방법. 보관 기간과 받아쓰기 요금 기준 포함.
통화 녹음
통화 녹음을 켜면 모든 통화가 자동으로 녹음됩니다. 녹음 파일은 통화가 끝나고 수초 안에 준비되며, Recording Webhook 으로 완료 알림을 받을 수 있습니다.
켜고 끄기
콘솔 부가서비스 → 통화 녹음 에서 켜고 끕니다. 별도 요금은 없습니다.
녹음 기능 사용 시 관련 법령 준수 책임은 고객사에 있습니다. 통화 상대에게 녹음 사실을 알려야 하는지 확인하세요.
녹음 파일
| 항목 | 내용 |
|---|---|
| 형식 | WAV (16-bit PCM, mono, 8kHz) — 양쪽 목소리가 한 파일에 담깁니다 |
| 보관 기간 | 기본 90일. 이후 자동 삭제됩니다. 보관 기간 에서 7일·30일로 줄일 수 있습니다 |
| 다운로드 | 통화 녹음 다운로드 GET /v1/accounts/{accountId}/recordings/{callId} — 15분 동안 유효한 다운로드 주소로 이동(302)합니다 |
| 삭제 | 통화 녹음 삭제 — 보관 기간 전에 지워야 할 때. 호출 즉시 파일이 삭제되며 되돌릴 수 없습니다 |
| 완료 알림 | Recording Webhook 의 recording.completed |
보관 기간
부가서비스 → 통화 녹음 → 보관 기간 에서 통화 녹음을 며칠 보관할지 고릅니다. 계정 소유자만 바꿀 수 있습니다.
| 설정 | 삭제 시점 |
|---|---|
| 7일 | 통화일로부터 7일이 지나면 매일 오전 11시(한국 시간)에 삭제됩니다 |
| 30일 | 통화일로부터 30일이 지나면 매일 오전 11시(한국 시간)에 삭제됩니다 |
| 90일 (기본값) | 녹음 파일이 만들어지고 90일이 지나면 삭제됩니다 |
기간을 줄이면 이미 있는 녹음에도 적용되어, 새 기간이 지난 녹음은 다음 정리 때 삭제됩니다. 삭제된 녹음은 되돌릴 수 없습니다.
기간을 늘리면 아직 남아 있는 녹음부터 새 기간이 적용됩니다.
콜 플로우 의 녹음 블럭 녹음은 이 설정과 관계없이 90일간 보관됩니다.
녹음 시작 시점
부가서비스 → 통화 녹음 → 녹음 시작 시점 에서 발신 통화 를 언제부터 녹음할지 고릅니다. 수신 통화에는 적용되지 않습니다.
| 설정 | 녹음 범위 | 상대가 받지 않은 통화 |
|---|---|---|
| 받은 후부터 (기본값) | 상대가 전화를 받은 뒤부터 | 녹음하지 않습니다 |
| 신호음부터 | 전화를 건 직후부터. 연결음·컬러링·안내 멘트 등 통신사가 받기 전에 보내 주는 소리가 함께 담깁니다 | 녹음합니다 |
통화 녹음이 꺼져 있으면 이 설정은 적용되지 않습니다.
신호음부터로 설정하면 달라지는 점
- 받지 않은 통화도 녹음됩니다. 벨이 울린 뒤 끊긴 통화에도 녹음 파일이 생기고
recording.completed가 전송됩니다. - 웹훅에 필드 두 개가 더해집니다.
recording.completed에 녹음 파일 길이(RecordingDurationSec)와, 녹음 시작 후 상대가 받기까지 걸린 초(AnswerOffsetSec)가 담깁니다. 받지 않은 통화에는AnswerOffsetSec가 없습니다. - 받아쓰기 요금은 녹음 길이 기준입니다. 통화 받아쓰기를 사용 중이면 받지 않은 통화도 받아쓰기되며, 받기 전 구간을 포함한 녹음 길이로 계산됩니다.
- 통화 요금은 그대로입니다. 설정과 관계없이 상대가 받은 시점부터 계산됩니다. 받지 않은 통화는 통화 요금이 없습니다.
- 받아쓰기 시간 정보는 녹음 시작 기준입니다. 통화 구간만 보려면 각 시간에서
AnswerOffsetSec를 빼세요.
예: 12초 동안 벨이 울린 뒤 받아 87초 통화한 경우
| 항목 | 값 |
|---|---|
녹음 파일 길이 (RecordingDurationSec) | 99초 |
받기까지 걸린 시간 (AnswerOffsetSec) | 12초 |
통화 길이 (DurationSec) · 통화 요금 기준 | 87초 |
| 받아쓰기 요금 기준 | 99초 |
받기 전 구간에 어떤 소리가 담기는지는 상대 번호와 통신사에 따라 다릅니다. 일반 연결음만 들리는 경우도 많습니다.
벨이 울리기 전에 끝난 통화
없는 번호, 번호 형식 오류처럼 벨이 울리기 전에 거절된 통화 는 받기 전 구간에도 소리가 없으므로 녹음되지 않습니다.
이런 통화는 녹음이 아니라 통화 결과로 판별하세요 — 통화 조회 응답과 Status Callback 의 hangupCause
(예: 없는 번호는 invalid_number)에 사유가 남습니다. 자세한 값은 통화 실패 원인 을 보세요.
받아쓰기·요약
부가서비스 → 통화 받아쓰기 를 켜면 녹음이 끝난 뒤 자동으로 받아쓰기되고, 완료되면 Transcript Webhook 이 전송됩니다. 받아쓰기는 통화 녹음이 켜져 있어야 사용할 수 있습니다.