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