v2
Danh sách
POST[URL]/api/v2/callTransaction/search
Lấy danh sách lịch sửa cuộc gọi
Path Parameters
page
integer
Thứ tự phân trang, bắt đầu bằng 1
size
int
Giới hạn số lượng phân tử của danh sách trả về, max = 50
Request Body
fromDate
long
Thời gian bắt đầu
toDate
long
Thời gian kết thúc
directions
array
Hướng cuộc gọi gồm: outbound, inbound, local
tagIds
array
Danh sách ID của tag cần lọc
sipNumbers
array
Danh sách đầu số
sipUsers
array
Danh sách số nội bộ của nhân viên
phoneNumbers
array
Danh sách số điện thoại khách hàng
transactionIds
array
Danh sách call UUID của cuộc gọi
agentEmails
array
Danh sách email của nhân viên thực hiện cuộc gọi
agentUuids
array
Danh sách UUID nhân viên, không kết hợp lọc cùng agentEmails
isAutoCall
Boolean
Lọc cuộc gọi tự động
isCallBot
Boolean
Lọc cuộc gọi voiceBot
autoCallIds
array
Danh sách ID phiên gọi tự động thường hoặc voiceBot
isAnswer
Boolean
Lọc cuộc gọi có trả lời
queueDestinations
array
Danh sách nhóm nội bộ
outerGroups
array
Danh sách nhóm ngoài
keyInteractiveScripts
array
Danh sách số nội bộ của kịch bản tương tác phím
keyword
String
Từ khóa tìm kiếm lớn hơn 3 ký tự
sortField
String
Field cần sort
sortAsc
Boolean
Thứ tự sort
Headers
Content-type
string
application/json
Authorization
string
Access Token: Bearer 'token'
{
"instance_id": "stg",
"payload": {
"items": [
{
"transaction_id": "", //Call UUID cuộc gọi
"tenant_id": "", //ID của DN
"direction": "outbound", //Hướng gọi
"source_number": "xxx", //Số nguồn
"destination_number": "xxx", //Số đích
"bill_sec": 5, //Thời lượng cuộc gọi
"record_seconds": 3, //Thời lượng file ghi âm
"time_start_to_answer": 1729870387, //Thời gian bắt đầu trả lời
"recording_file": "",
"recording_file_url": "", //Link file ghi âm
"recording_data": null,
"sip_user": "999", //Số nội bộ nhân viên thực hiện
"created_date": 1729870397069, //Ngày tạo
"last_updated_date": 1730788680689, //Ngày cập nhật
"is_auto_call": false, //Cờ đánh dấu cuộc gọi tự động
"ivr": "none",
"provider": "viettel", //Nhà mạng số điện thoại KH
"duration": 10, //Tổng thời gian
"user": [ //Thông tin nhân viên liên quan đến cuộc gọi
{
"full_name": "DEV ZONE",
"full_name_unsigned": "DEV ZONE",
"note": null,
"tag": null
},
{
"full_name": "DEV ZONE",
"full_name_unsigned": "dev zone",
"note": "OMIDEV",
"tag": [
{
"name": "ATC_01"
}
]
}
],
"customer": {//Thông tin khách hàng
"full_name": "Trần Đình Tâm",
"full_name_unsigned": "tran dinh tam"
},
"state": null,
"call_uuid": null,
"from_number": null,
"to_number": null,
"hotline": null,
"is_have_forward_out": false,
"bill_sec_forward_out": 0,
"call_out_price": 66.000, //Cước gọi
"note": null, //Thông tin ghi chú cuộc gọi
"tag": [ //Danh sách ID tag cuộc gọi
"63c0bb010748c865ba321c53"
],
"invite_failure_status": null,
"answer_sec": 3, //Thời gian trả lời
"autocall_uuid": null, //Mã UUID mapping thông tin chi tiết cuộc gọi auto call
"autocall_id": null, //ID phiên gọi auto call
"sip_number": "842499950291", //Đầu số
"phone_number": "0983223566", //Số điện thoại khách hàng
"create_by": { //Nhân viên thực hiện cuộc gọi
"id": "60e79bd864b64271a923affe",
"name": "DEV ZONE",
"contact_id": "60e79beb1b20043c4e7a68af",
"avatar": null,
"gender": null,
"uuid": null,
"type": "agent"
},
"transfer_histories": [], //Danh sách luồng cuộc gọi
"user_data_str": null,
"user_ref_code": null,
"endby_name": "end_call_by_customer", //Nguyên nhân tắt máy
"hangup_cause": "NORMAL_CLEARING",
"sip_hangup_disposition": "send_bye",
"hangup_cause_q850": 16,
"is_voicemail": false, //Cờ đánh dấu cuộc gọi vào hộp thư thoại
"recording_file_voicemail": null,
"domain_fusion": "omicalltest1",
"send_num_retry": 0,
"time_start_call": 1729870387, //Thời gian thực hiện cuộc gọi
"time_end_call": 1729870396, //Thời gian kết thúc cuộc gọi
"out_of_working_time": true,
"sip_number_tags": [],
"evaluations": null,
"total_evaluate": null,
"internal_destination": null,
"classifies": null,
"collect_info_variables": null //Danh sách kết quả thu thập cuộc gọi voice bot
}
],
"page_number": 1,
"page_size": 50,
"total_items": 1,
"total_pages": 1,
"has_next": false,
"next_page": 1,
"has_previous": false,
"previous_page": 1,
"extension": null
},
"instance_version": "1.2.164",
"key_enabled": false,
"status_code": 9999
}
Mã Lỗi
Mô tả
missing_time_query
Thiếu bộ lọc thời gian
date_is_too_long
Khoảng cách thời gian quá lớn, giới hạn trong 3 tháng gần nhất
email_agent_not_found
Bộ lọc email nhân viên không đúng hoặc không có giữ liệu nhân viên
uuid_agent_not_found
Bộ lọc agentUuids không đúng hoặc không có giữ liệu nhân viên
Chi tiết cuộc gọi
POST[URL]/api/v2/callTransaction/getByTransactionId
Lấy thông tin chi tiết cuộc gọi
Request Body
transactionId
String
Call UUID cuộc gọi
Headers
Content-type
string
application/json
Authorization
string
Access token: Bearer 'token'
{
"instance_id": "stg",
"payload": {
"transaction_id": "", //Call UUID cuộc gọi
"tenant_id": "", //ID của DN
"direction": "outbound", //Hướng gọi
"source_number": "xxx", //Số nguồn
"destination_number": "xxx", //Số đích
"bill_sec": 5, //Thời lượng cuộc gọi
"record_seconds": 3, //Thời lượng file ghi âm
"time_start_to_answer": 1729870387, //Thời gian bắt đầu trả lời
"recording_file": "",
"recording_file_url": "", //Link file ghi âm
"recording_data": null,
"sip_user": "999", //Số nội bộ nhân viên thực hiện
"created_date": 1729870397069, //Ngày tạo
"last_updated_date": 1730788680689, //Ngày cập nhật
"is_auto_call": false, //Cờ đánh dấu cuộc gọi tự động
"ivr": "none",
"provider": "viettel", //Nhà mạng số điện thoại KH
"duration": 10, //Tổng thời gian
"user": [ //Thông tin nhân viên liên quan đến cuộc gọi
{
"full_name": "DEV ZONE",
"full_name_unsigned": "DEV ZONE",
"note": null,
"tag": null
},
{
"full_name": "DEV ZONE",
"full_name_unsigned": "dev zone",
"note": "OMIDEV",
"tag": [
{
"name": "ATC_01"
}
]
}
],
"customer": {//Thông tin khách hàng
"full_name": "Trần Đình Tâm",
"full_name_unsigned": "tran dinh tam"
},
"state": null,
"call_uuid": null,
"from_number": null,
"to_number": null,
"hotline": null,
"is_have_forward_out": false,
"bill_sec_forward_out": 0,
"call_out_price": 66.000, //Cước gọi
"note": null, //Thông tin ghi chú cuộc gọi
"tag": [ //Danh sách ID tag cuộc gọi
"63c0bb010748c865ba321c53"
],
"invite_failure_status": null,
"answer_sec": 3, //Thời gian trả lời
"autocall_uuid": null, //Mã UUID mapping thông tin chi tiết cuộc gọi auto call
"autocall_id": null, //ID phiên gọi auto call
"sip_number": "842499950291", //Đầu số
"phone_number": "0983223566", //Số điện thoại khách hàng
"create_by": { //Nhân viên thực hiện cuộc gọi
"id": "60e79bd864b64271a923affe",
"name": "DEV ZONE",
"contact_id": "60e79beb1b20043c4e7a68af",
"avatar": null,
"gender": null,
"uuid": null,
"type": "agent"
},
"transfer_histories": [], //Danh sách luồng cuộc gọi
"user_data_str": null,
"user_ref_code": null,
"endby_name": "end_call_by_customer", //Nguyên nhân tắt máy
"hangup_cause": "NORMAL_CLEARING",
"sip_hangup_disposition": "send_bye",
"hangup_cause_q850": 16,
"is_voicemail": false, //Cờ đánh dấu cuộc gọi vào hộp thư thoại
"recording_file_voicemail": null,
"domain_fusion": "omicalltest1",
"send_num_retry": 0,
"time_start_call": 1729870387, //Thời gian thực hiện cuộc gọi
"time_end_call": 1729870396, //Thời gian kết thúc cuộc gọi
"out_of_working_time": true,
"sip_number_tags": [],
"evaluations": null,
"total_evaluate": null,
"internal_destination": null,
"classifies": null,
"collect_info_variables": null //Danh sách kết quả thu thập cuộc gọi voice bot
},
"instance_version": "1.2.164",
"key_enabled": false,
"status_code": 9999
}missing_params
Request Body thiếu hoặc sai format
Last updated
Was this helpful?