통화 목록 조회
인증된 워크스페이스(organization_id)의 통화 목록을 조회합니다. 에이전트, 통화 상태, 통화 유형, 전화번호, 종료 사유, 시작 시각, 통화 시간, 에이전트 버전, 메타데이터, 동적 변수로 필터링할 수 있습니다.
Authorizations
워크스페이스 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.
Query Parameters
에이전트 UUID 필터입니다. 여러 에이전트로 필터링하려면 query parameter를 반복해서 전달합니다.
에이전트 버전 필터입니다(current 또는 v{n}, 반복 가능). agent_id를 1개 지정할 때만 사용할 수 있습니다.
통화 시간 하한입니다(밀리초, 이 값 이상).
0 <= x <= 9223372036854776000통화 시간 상한입니다(밀리초, 이 값 이하).
0 <= x <= 9223372036854776000key:value 형식의 메타데이터 정확 일치 필터입니다(예: source:crm). 같은 key를 반복하면 OR, 다른 key끼리는 AND로 찾습니다.
20key:value 형식의 동적 변수 정확 일치 필터입니다(예: name:홍길동). 같은 key를 반복하면 OR, 다른 key끼리는 AND로 찾습니다.
20상태 필터입니다. 여러 상태를 지원하는 endpoint에서는 query parameter를 반복해서 전달합니다.
queued, ongoing, ended, error, canceled, not_connected 통화 유형 필터 (반복 가능). 허용값: web/phone/inbound/outbound/api.
web, phone, inbound, outbound, api 통화 종료 사유 필터 (반복 가능).
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, operator_hangup 발신 번호 필터 (반복 가능). 하이픈 없는 국내 번호.
수신 번호 필터 (반복 가능). 하이픈 없는 국내 번호.
귀속 고객 UUID 필터입니다. 해당 고객에 귀속된 통화만 반환합니다.
캠페인 id 필터입니다. GET /v3/campaigns 응답의 정수 문자열 id를 사용합니다.
^[0-9]+$통화 시각 하한입니다(unix ms, 이 시각 이상). 연결된 통화는 시작 시각을 사용합니다. 연결 전에 종료된 통화는 생성 시각으로 비교합니다. 10~11자리 unix 초 입력도 허용하며 ms로 정규화합니다.
통화 시각 상한입니다(unix ms, 이 시각 이하). 연결된 통화는 시작 시각을 사용합니다. 연결 전에 종료된 통화는 생성 시각으로 비교합니다. 10~11자리 unix 초 입력도 허용하며 ms로 정규화합니다.
정렬 방향입니다. 허용값은 asc, desc입니다.
asc, desc 이전 응답의 next_cursor 값입니다. 다음 페이지를 조회할 때 그대로 전달합니다.
반환할 최대 항목 수입니다. v3 목록 endpoint는 1~100을 허용합니다.
1 <= x <= 100