새로운 문서를 작성 중입니다.새 문서로 이동
ClawOps Docs

통화 녹음

통화 녹음을 켜고, 녹음 파일을 받고, 발신 통화를 받기 전(연결음)부터 녹음하도록 설정하는 방법. 보관 기간과 받아쓰기 요금 기준 포함.

통화 녹음

통화 녹음을 켜면 모든 통화가 자동으로 녹음됩니다. 녹음 파일은 통화가 끝나고 수초 안에 준비되며, 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 이 전송됩니다. 받아쓰기는 통화 녹음이 켜져 있어야 사용할 수 있습니다.