통화종료사유

모든 통화에는 종료 사유가 기록됩니다. 통화 기록의 종료 사유 칼럼, API 응답, 웹훅 페이로드에서 같은 의미의 값이 사용됩니다. 일부 내부 사유는 표면별로 노출 여부가 다를 수 있으므로, API 연동에서는 알 수 없는 값도 안전하게 처리하세요.

정상 종료

통화가 의도대로 완료된 경우입니다.

아웃바운드 통화가 연결되지 못한 경우입니다.

값	설명	대응 방법
`dial_no_answer`	상대방이 응답하지 않음	다이얼 대기 시간을 조정하거나, 시간대를 바꿔 재발신하세요.
`dial_failed`	발신 실패	수신번호가 올바른지, 발신번호가 활성 상태인지 확인하세요.
`dial_busy`	수신자 통화 중	잠시 후 재발신하세요.
`dial_declined`	수신자가 통화를 거절	수신자가 직접 거절했거나 단말·통신망에서 거절로 처리된 경우입니다.
`voicemail_reached`	음성사서함 연결 감지	에이전트가 음성사서함을 감지하고 자동으로 통화를 종료한 경우입니다.

조직의 사용량 제한에 도달한 경우입니다.

값	설명	대응 방법
`max_duration_reached`	최대 통화 시간 도달	필요하면 최대 통화 시간 설정을 늘리세요.
`inactivity`	무응답 대기 시간 초과	사용자가 오래 응답하지 않아 통화가 종료된 경우입니다.
`concurrency_limit_reached`	동시 통화 한도 초과	동시에 진행 중인 통화가 너무 많습니다. 플랜 업그레이드를 검토하세요.
`insufficient_balance`	잔액 부족	크레딧을 충전하세요.
`daily_call_limit_reached`	일간 통화 한도 도달	일일 사용 한도에 도달했습니다. 다음 날 자동으로 초기화됩니다.
`hourly_call_limit_reached`	시간당 통화 한도 도달	시간당 사용 한도에 도달했습니다. 다음 시간에 자동으로 초기화됩니다.

플랫폼 정책이나 워크스페이스 설정에 의해 통화가 시작되지 않은 경우입니다.

값	설명	대응 방법
`blocked_number`	차단 번호 정책에 의해 통화 차단	차단 번호 설정을 확인하세요.

blocked_number는 대시보드나 내부 기록에 표시될 수 있습니다. 공개 API와 웹훅에서의 노출은 버전과 표면에 따라 다를 수 있으므로, 연동 코드는 새 종료 사유가 추가되어도 실패하지 않도록 구현하세요.

시스템 문제로 통화가 종료된 경우입니다.

값	설명	대응 방법
`error_voxai`	내부 시스템 오류	일시적인 오류입니다. 반복되면 지원팀에 문의하세요.
`flow_error`	플로우 실행 오류	플로우 에이전트의 노드 설정을 점검하세요. API 노드의 엔드포인트, 조건 노드의 분기 조건 등을 확인하세요.
`orphaned_no_agent_pickup`	에이전트 미배정	인바운드 통화에 에이전트가 연결되지 않았습니다. 전화번호에 인바운드 에이전트가 올바르게 연결되어 있는지 확인하세요.

특정 종료 사유가 반복되면 알림을 설정해 자동으로 감지하세요. 예를 들어 error_voxai 발생 시 Slack으로 알림을 받을 수 있습니다.