API 참조
- 소개
- 워크스페이스
- 통화
- 테스트 엔드포인트
통화
통화 목록 조회
통화
통화 목록 조회
특정 필터 조건으로 통화 목록을 조회하는 엔드포인트입니다. 페이지네이션, 기간 필터, 에이전트 필터 등 다양한 조건으로 검색할 수 있습니다.
POST
/
v1
/
list-calls
curl --request POST \
--url https://client-api.tryvox.co/v1/list-calls \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"filter_criteria": {
"agent_id": [
"<string>"
],
"disconnection_reason": [
"<string>"
],
"call_type": [
"<string>"
],
"user_sentiment": [
"<string>"
],
"call_from": [
"<string>"
],
"call_to": [
"<string>"
],
"duration": "<any>",
"start_timestamp": "<any>"
},
"sort_order": "descending",
"limit": 50,
"pagination_key": "<string>"
}'
{
"calls": [
{
"agent_id": "<string>",
"call_id": "<string>",
"call_type": "inbound",
"call_from": "<string>",
"call_to": "<string>",
"dynamic_variables": {},
"metadata": {},
"disconnection_reason": "dial_no_answer",
"start_timestamp": 123,
"end_timestamp": 123,
"duration_ms": 123,
"transcript": [
{
"role": "agent",
"content": "<string>"
}
],
"transcript_with_tool_calls": [
{
"role": "agent",
"content": "<string>"
}
],
"recording_url": "<string>",
"call_cost": {
"total_credits_used": 123,
"duration_seconds": 123
},
"call_analysis": {
"summary": "<string>",
"user_sentiment": "<string>",
"custom_analysis_data": [
{}
]
},
"opt_out_sensitive_data_storage": false
}
],
"next_pagination_key": "<string>"
}
Authorizations
대시보드에서 발급받은 API 키를 인증 헤더에 포함시켜야 합니다. 형식은 "Bearer YOUR_API_KEY" 입니다.
Body
application/json
Response
200
application/json
Successful Response
The response is of type object
.
curl --request POST \
--url https://client-api.tryvox.co/v1/list-calls \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"filter_criteria": {
"agent_id": [
"<string>"
],
"disconnection_reason": [
"<string>"
],
"call_type": [
"<string>"
],
"user_sentiment": [
"<string>"
],
"call_from": [
"<string>"
],
"call_to": [
"<string>"
],
"duration": "<any>",
"start_timestamp": "<any>"
},
"sort_order": "descending",
"limit": 50,
"pagination_key": "<string>"
}'
{
"calls": [
{
"agent_id": "<string>",
"call_id": "<string>",
"call_type": "inbound",
"call_from": "<string>",
"call_to": "<string>",
"dynamic_variables": {},
"metadata": {},
"disconnection_reason": "dial_no_answer",
"start_timestamp": 123,
"end_timestamp": 123,
"duration_ms": 123,
"transcript": [
{
"role": "agent",
"content": "<string>"
}
],
"transcript_with_tool_calls": [
{
"role": "agent",
"content": "<string>"
}
],
"recording_url": "<string>",
"call_cost": {
"total_credits_used": 123,
"duration_seconds": 123
},
"call_analysis": {
"summary": "<string>",
"user_sentiment": "<string>",
"custom_analysis_data": [
{}
]
},
"opt_out_sensitive_data_storage": false
}
],
"next_pagination_key": "<string>"
}