Skip to main content
GET
통화 조회

Authorizations

Authorization
string
header
required

조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Path Parameters

call_id
string<uuid>
required

통화 ID입니다.

Response

성공 응답

v3 단건 통화 응답. transcript 포함.

id
string
required

통화의 고유 식별자입니다.

agent
AgentMapping · object
required

agent_idagent_version으로 구성된 에이전트 매핑 객체입니다.

call_type
enum<string>
required

통화 유형. 'web'/'phone'/'inbound'/'outbound'/'api' 중 하나.

Available options:
web,
phone,
inbound,
outbound,
api
status
enum<string>
required

통화 상태입니다. 값 의미와 전이 규칙은 CallStatusV3Enum 정의를 참고합니다.

Available options:
queued,
ongoing,
ended,
error,
canceled,
not_connected
customer_id
string<uuid> | null

서버가 귀속한 고객 UUID입니다. 아직 고객 귀속이 완료되지 않았거나 귀속 대상이 없으면 null입니다.

from_number
string | null

발신 번호. 하이픈 없는 국내 번호 (예: '01012345678'). 웹 통화 등은 null.

to_number
string | null

수신 번호. 하이픈 없는 국내 번호.

presentation_number
string | null

수신자에게 표시할 발신 번호. 조직이 사전 등록·승인한 번호 (telephone_presentation_numbers). 미지정 시 null.

disconnection_reason
enum<string> | null

통화 종료 사유. 진행 중이면 null.

Available options:
user_hangup,
agent_hangup,
dial_no_answer,
dial_failed,
dial_busy,
voicemail_reached,
concurrency_limit_reached,
insufficient_balance,
error_voxai,
max_duration_reached,
inactivity,
flow_error,
call_transfer,
orphaned_no_agent_pickup,
dial_declined,
daily_call_limit_reached,
hourly_call_limit_reached,
blocked_number
start_at
integer | null

통화가 시작된 시각 (unix ms). 통화가 아직 시작되지 않았으면 null.

end_at
integer | null

통화가 종료된 시각 (unix ms). 통화가 아직 종료되지 않았으면 null.

recording_url
string | null

녹음 파일 URL. 녹음 없거나 옵트아웃이면 null.

metadata
Metadata · object

요청 시 전달된 정적 메타데이터를 그대로 반환합니다.

dynamic_variables
Dynamic Variables · object

요청 시 전달된 동적 변수를 그대로 반환합니다.

call_analysis
CallV3AnalysisDto · object | null

통화 분석 결과입니다(요약, 감정, 사용자 정의 분석). 분석 완료 전에는 null입니다.

call_cost
CallV3CostDto · object | null

통화 비용입니다(KRW 원 단위, Decimal 문자열). 계산 완료 전에는 null입니다.

variant_label
string | null

Traffic split variant label. Split 미사용/우회/폴백 통화는 null.

opt_out_sensitive_data_storage
boolean
default:false

민감정보 저장 거부 여부. true면 transcript/recording/analysis null.

transcript
Transcript · object[] | null

통화 대화록 (통합 리스트). 항목 role 3종:

  • 'agent'/'user': {role, content, start_at?, end_at?}
  • 'tool_call_invocation': {role, tool_call_id, name, arguments}
  • 'tool_call_result': {role, tool_call_id, content} 옵트아웃 시 null.