Skip to main content
GET
/
calls
/
{call_id}
통화 조회
curl --request GET \
  --url https://client-api.tryvox.co/v3/calls/{call_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "agent": {
    "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "agent_version": "current"
  },
  "from_number": "<string>",
  "to_number": "<string>",
  "presentation_number": "<string>",
  "start_at": 123,
  "end_at": 123,
  "recording_url": "<string>",
  "metadata": {},
  "dynamic_variables": {},
  "call_analysis": {
    "summary": "<string>",
    "custom_analysis_data": [
      {}
    ]
  },
  "call_cost": {
    "total_cost": "<string>"
  },
  "variant_label": "<string>",
  "opt_out_sensitive_data_storage": false,
  "transcript": [
    {}
  ]
}

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_id와 agent_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
​
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입니다.

​
call_cost
CallV3CostDto · object

통화 비용입니다(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.