v2

API lịch sử cuộc gọi version 1

Danh sách

POST[URL]/api/v2/callTransaction/search

Lấy danh sách lịch sửa cuộc gọi

Path Parameters

Name	Type	Description
page	integer	Thứ tự phân trang, bắt đầu bằng 1
size	integer	Giới hạn số lượng phân tử của danh sách trả về, max = 50

Headers

Name	Type	Description
Content-type	string	application/json
Authorization	string	Bearer "Access token"

Request Body

Name	Type	Description
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 voiceBot
isCallBot	Boolean	Mã code của khách hàng bên đối tác
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

200 Danh sách cuộc gọi

{
    "instance_id": "stg",
    "payload": {
        "items": [
            {
                "transaction_id": "09d43196-4ec7-4fba-80fe-c6aa1f3760b8", //Call UUID cuộc gọi
                "tenant_id": "6391feada745be2a6aa18006", //ID của DN
                "direction": "outbound", //Hướng gọi
                "source_number": "842888806669", //Số nguồn
                "destination_number": "0393210914", //Số đích
                "disposition": "answered",
                "bill_sec": 8, //Thời lượng cuộc gọi
                "record_seconds": 6, //Thời lượng file ghi âm
                "time_start_to_answer": 1747128857, //Thời gian bắt đầu trả lời
                "recording_file": "....", //file ghi âm
                "recording_file_url": "...",//Link file ghi âm
                "recording_data": null,
                "sip_user": "101", //Số nội bộ nhân viên thực hiện
                "created_date": 1747128866529, //Ngày tạo
                "last_updated_date": 1747135112659, //Ngày cập nhật
                "is_auto_call": false,
                "ivr": "none",
                "provider": "viettel", //Nhà mạng số điện thoại KH
                "duration": 9, //Tổng thời gian
                "user": [ //Thông tin nhân viên liên quan đến cuộc gọi
                    {
                        "full_name": "SenBac",
                        "full_name_unsigned": "senbac",
                        "note": "Số test",
                        "tag": [
                            {
                                "name": "Đã gọi"
                            }
                        ]
                    }
                ],
                "customer": {  //Thông tin khách hàng
                    "full_name": "Nguyễn Văn A",
                    "full_name_unsigned": "nguyen van a"
                },
                "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": 106.664, //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
                    "6753cf48fc785a5b27347593"
                ],
                "invite_failure_status": null,
                "answer_sec": 6, //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": "8428xxx",  //Đầu số
                "phone_number": "0393xxx", //Số điện thoại khách hàng
                "create_by": { //Nhân viên thực hiện cuộc gọi
                    "id": "639202a8bf054d579109b35e",
                    "name": "SenBac",
                    "contact_id": "639202a8bf054d579109b35d",
                    "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",
                "hangup_cause": "NORMAL_CLEARING",
                "sip_hangup_disposition": "send_bye",
                "hangup_cause_q850": null,
                "is_voicemail": false, //Cờ đánh dấu cuộc gọi vào hộp thư thoại
                "recording_file_voicemail": null,
                "domain_fusion": "demo20",
                "send_num_retry": 0,
                "time_start_call": 1747128857, //Thời gian thực hiện cuộc gọi
                "time_end_call": 1747128866, //Thời gian kết thúc cuộc gọi
                "out_of_working_time": false,
                "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
                "sip_number_forward_out": null, // đầu số chuyển tiếp cuộc gọi
                "is_same_network": false,
                "is_same_network_forward_out": false,
                "provider_of_number": "digitel", // nhà cung cấp đầu số
                "provider_of_number_forward_out": null, // nhà cung cấp của số chuyển tiếp
                "callbot_script_id": null,
                "criteria": null
            }
        ],
        "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

Headers

Name	Type	Description
Content-type	string	application/json
Authorization	string	Bearer "Access token"

Request Body

Name	Type	Description
transactionId	String	Call UUID cuộc gọi

200 Yêu cầu thành công

{
    "instance_id": "stg",
    "payload": {
        "items": [
            {
                "transaction_id": "09d43196-4ec7-4fba-80fe-c6aa1f3760b8", //Call UUID cuộc gọi
                "tenant_id": "6391feada745be2a6aa18006", //ID của DN
                "direction": "outbound", //Hướng gọi
                "source_number": "842888806669", //Số nguồn
                "destination_number": "0393210914", //Số đích
                "disposition": "answered",
                "bill_sec": 8, //Thời lượng cuộc gọi
                "record_seconds": 6, //Thời lượng file ghi âm
                "time_start_to_answer": 1747128857, //Thời gian bắt đầu trả lời
                "recording_file": "....", //file ghi âm
                "recording_file_url": "...",//Link file ghi âm
                "recording_data": null,
                "sip_user": "101", //Số nội bộ nhân viên thực hiện
                "created_date": 1747128866529, //Ngày tạo
                "last_updated_date": 1747135112659, //Ngày cập nhật
                "is_auto_call": false,
                "ivr": "none",
                "provider": "viettel", //Nhà mạng số điện thoại KH
                "duration": 9, //Tổng thời gian
                "user": [ //Thông tin nhân viên liên quan đến cuộc gọi
                    {
                        "full_name": "SenBac",
                        "full_name_unsigned": "senbac",
                        "note": "Số test",
                        "tag": [
                            {
                                "name": "Đã gọi"
                            }
                        ]
                    }
                ],
                "customer": {  //Thông tin khách hàng
                    "full_name": "Nguyễn Văn A",
                    "full_name_unsigned": "nguyen van a"
                },
                "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": 106.664, //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
                    "6753cf48fc785a5b27347593"
                ],
                "invite_failure_status": null,
                "answer_sec": 6, //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": "8428xxx",  //Đầu số
                "phone_number": "0393xxx", //Số điện thoại khách hàng
                "create_by": { //Nhân viên thực hiện cuộc gọi
                    "id": "639202a8bf054d579109b35e",
                    "name": "SenBac",
                    "contact_id": "639202a8bf054d579109b35d",
                    "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",
                "hangup_cause": "NORMAL_CLEARING",
                "sip_hangup_disposition": "send_bye",
                "hangup_cause_q850": null,
                "is_voicemail": false, //Cờ đánh dấu cuộc gọi vào hộp thư thoại
                "recording_file_voicemail": null,
                "domain_fusion": "demo20",
                "send_num_retry": 0,
                "time_start_call": 1747128857, //Thời gian thực hiện cuộc gọi
                "time_end_call": 1747128866, //Thời gian kết thúc cuộc gọi
                "out_of_working_time": false,
                "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
                "sip_number_forward_out": null, // đầu số chuyển tiếp cuộc gọi
                "is_same_network": false,
                "is_same_network_forward_out": false,
                "provider_of_number": "digitel", // nhà cung cấp đầu số
                "provider_of_number_forward_out": null, // nhà cung cấp của số chuyển tiếp
                "callbot_script_id": null,
                "criteria": null
            }
        ],
        "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_params	Request Body thiếu hoặc sai format