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

Name
Type
Description

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

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 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

Name
Type
Description

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

Name
Type
Description

transactionId

String

Call UUID cuộc gọi

Headers

Name
Type
Description

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
}

Mã Lỗi
Mô tả

missing_params

Request Body thiếu hoặc sai format

Previousv1NextGọi tự động

Last updated