v1

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

Danh sách

GET [URL]/api/call_transaction/list

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

Query Parameters

Name	Type	Description
agents	array	Mảng email nhân viên
is_auto_call	boolean	Bao gồm cuộc gọi tự động (true / false / NULL)
keyword	string	Từ khóa tìm kiếm
sip_user	string	Số nội bộ của nhân viên
disposition	string	Trạng thái : 'cancelled' : Không trả lời, 'answered' : Trả lời
direction	array	Hướng gọi ('outbound' : Gọi đi ; 'inbound' : Gọi đến; 'local' : Gọi nội bộ)
page	number	Trang : Bắt đầu từ 1 ( Mặc định là 1)
size	number	Số lượng record trên một trang. Mặc định 50
from_date	integer	Từ ngày (Timestamp in milliseconds)
to_date	integer	Đến ngày (Timestamp in milliseconds)
agents	array	Danh sách email nhân viên
queue_destination	array	Danh sách số nhóm nội bộ (Hàng đợi) API Tổng đài >> Nhóm nội bộ
sip_numbers	array	Danh sách số hotline
user_uuids	array	Username hoặc Usercode của bên thứ 3

Headers

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

200 Danh sách cuộc gọi

{
    "instance_id": "stg",
    "payload": {
        "items": [
            {
                "transaction_id": "09d43196-4ec7-4fba-80fe-c6aa1f3760b8",
                "tenant_id": "6391feada745be2a6aa18006",
                "direction": "outbound",
                "source_number": "84288xxx",
                "destination_number": "0393xxx",
                "disposition": "answered",
                "bill_sec": 8,
                "record_seconds": 6,
                "time_start_to_answer": 1747128857,
                "recording_file": "https://drive.google.com/.......",
                "recording_file_url": "https://public-v1-stg.omicrm.com/....",
                "recording_data": null,
                "sip_user": "101",
                "created_date": 1747128866529,
                "last_updated_date": 1747135112659,
                "is_auto_call": false,
                "ivr": "none",
                "provider": "viettel",
                "duration": 9,
                "user": [
                    {
                        "full_name": "SenBac",
                        "full_name_unsigned": "senbac",
                        "note": "Số test",
                        "tag": [ // Danh sách thẻ tag cuộc gọi
                            {
                                "name": "Đã gọi"
                            }
                        ]
                    }
                ],
                "customer": null,
                "state": null,
                "call_uuid": null,
                "from_number": null,
                "to_number": null,
                "hotline": null,
                "is_have_forward_out": false,// Chuyển tiến ra sim true/false
                "bill_sec_forward_out": 0, // Số giây chuyển tiếp ra bên ngoài 
                "call_out_price": 106.664,
                "note": "Số test", // Ghi chu cuoc goi
                "tag": [
                    "Đã gọi"
                ], // tag cuoc goi
                "invite_failure_status": null,
                "answer_sec": 6,
                "autocall_uuid": null,
                "autocall_id": null,
                "sip_number": "84288xxx",
                "phone_number": "0393xxx",
                "create_by": {
                    "id": "639202a8bf054d579109b35e",
                    "name": "SenBac",
                    "contact_id": "639202a8bf054d579109b35d",
                    "avatar": null,
                    "gender": null,
                    "uuid": null,
                    "type": "agent"
                },
                "transfer_histories": [],
                "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,
                "recording_file_voicemail": null,
                "domain_fusion": "demo20",
                "send_num_retry": 0,
                "time_start_call": 1747128857,
                "time_end_call": 1747128866,
                "out_of_working_time": false,
                "sip_number_tags": [],
                "evaluations": null,
                "total_evaluate": null,
                "internal_destination": null,
                "classifies": null,
                "collect_info_variables": null,
                "sip_number_forward_out": null,
                "is_same_network": false,
                "is_same_network_forward_out": false,
                "provider_of_number": "digitel",
                "provider_of_number_forward_out": null,
                "callbot_script_id": null,
                "criteria": null
            }
        ],
        "page_number": 1,
        "page_size": 1,
        "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ả
limit_request_30_minute	Các request cách nhau 30 phút
from_date_is_required	Từ ngày là bắt buộc
to_date_is_required	Đến ngày là bắt buộc
date_invalid	Từ ngày hoặc đến ngày không hợp lệ
date_is_too_long	Khoảng cách giữa từ ngày - đến ngày : Chỉ cho phép 30 ngày

Chi tiết cuộc gọi

GET [URL]/api/call_transaction/detail/:transaction_id

Lấy thông tin chi tiết cuộc gọi

Path Parameters

Name	Type	Description
transaction_id	string	Id cuộc gọi

Headers

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

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

{
    "instance_id": "stg",
    "payload": {
        "items": [
            {
                "transaction_id": "09d43196-4ec7-4fba-80fe-c6aa1f3760b8",
                "tenant_id": "6391feada745be2a6aa18006",
                "direction": "outbound",
                "source_number": "84288xxx",
                "destination_number": "0393xxx",
                "disposition": "answered",
                "bill_sec": 8,
                "record_seconds": 6,
                "time_start_to_answer": 1747128857,
                "recording_file": "https://drive.google.com/.......",
                "recording_file_url": "https://public-v1-stg.omicrm.com/....",
                "recording_data": null,
                "sip_user": "101",
                "created_date": 1747128866529,
                "last_updated_date": 1747135112659,
                "is_auto_call": false,
                "ivr": "none",
                "provider": "viettel",
                "duration": 9,
                "user": [
                    {
                        "full_name": "SenBac",
                        "full_name_unsigned": "senbac",
                        "note": "Số test",
                        "tag": [ // Danh sách thẻ tag cuộc gọi
                            {
                                "name": "Đã gọi"
                            }
                        ]
                    }
                ],
                "customer": null,
                "state": null,
                "call_uuid": null,
                "from_number": null,
                "to_number": null,
                "hotline": null,
                "is_have_forward_out": false,// Chuyển tiến ra sim true/false
                "bill_sec_forward_out": 0, // Số giây chuyển tiếp ra bên ngoài 
                "call_out_price": 106.664,
                "note": "Số test", // Ghi chu cuoc goi
                "tag": [
                    "Đã gọi"
                ], // tag cuoc goi
                "invite_failure_status": null,
                "answer_sec": 6,
                "autocall_uuid": null,
                "autocall_id": null,
                "sip_number": "84288xxx",
                "phone_number": "0393xxx",
                "create_by": {
                    "id": "639202a8bf054d579109b35e",
                    "name": "SenBac",
                    "contact_id": "639202a8bf054d579109b35d",
                    "avatar": null,
                    "gender": null,
                    "uuid": null,
                    "type": "agent"
                },
                "transfer_histories": [],
                "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,
                "recording_file_voicemail": null,
                "domain_fusion": "demo20",
                "send_num_retry": 0,
                "time_start_call": 1747128857,
                "time_end_call": 1747128866,
                "out_of_working_time": false,
                "sip_number_tags": [],
                "evaluations": null,
                "total_evaluate": null,
                "internal_destination": null,
                "classifies": null,
                "collect_info_variables": null,
                "sip_number_forward_out": null,
                "is_same_network": false,
                "is_same_network_forward_out": false,
                "provider_of_number": "digitel",
                "provider_of_number_forward_out": null,
                "callbot_script_id": null,
                "criteria": null
            }
        ],
        "page_number": 1,
        "page_size": 1,
        "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
}

Cập nhật thông tin cuộc gọi

POST [URL]/api/call_transaction/change/:transaction_id

- Cập nhật các thông tin bổ sung cho lịch sử cuộc gọi

Path Parameters

Name	Type	Description
transaction_id	string	Id cuộc gọi

Headers

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

Request Body

Name	Type	Description
tag	array	Danh sách Tag được gán với lịch sử cuộc gọi Ví dụ : tag : ["hailong","goilaisau"]
note	string	Ghi chú cuộc gọi

200 Tạo danh sách thành công

{
    "instance_id": "stg",
    "payload": {
        "items": [
            {
                "transaction_id": "09d43196-4ec7-4fba-80fe-c6aa1f3760b8",
                "tenant_id": "6391feada745be2a6aa18006",
                "direction": "outbound",
                "source_number": "84288xxx",
                "destination_number": "0393xxx",
                "disposition": "answered",
                "bill_sec": 8,
                "record_seconds": 6,
                "time_start_to_answer": 1747128857,
                "recording_file": "https://drive.google.com/.......",
                "recording_file_url": "https://public-v1-stg.omicrm.com/....",
                "recording_data": null,
                "sip_user": "101",
                "created_date": 1747128866529,
                "last_updated_date": 1747135112659,
                "is_auto_call": false,
                "ivr": "none",
                "provider": "viettel",
                "duration": 9,
                "user": [
                    {
                        "full_name": "SenBac",
                        "full_name_unsigned": "senbac",
                        "note": "Số test",
                        "tag": [ // Danh sách thẻ tag cuộc gọi
                            {
                                "name": "Đã gọi"
                            }
                        ]
                    }
                ],
                "customer": null,
                "state": null,
                "call_uuid": null,
                "from_number": null,
                "to_number": null,
                "hotline": null,
                "is_have_forward_out": false,// Chuyển tiến ra sim true/false
                "bill_sec_forward_out": 0, // Số giây chuyển tiếp ra bên ngoài 
                "call_out_price": 106.664,
                "note": "Số test", // Ghi chu cuoc goi
                "tag": [
                    "Đã gọi"
                ], // tag cuoc goi
                "invite_failure_status": null,
                "answer_sec": 6,
                "autocall_uuid": null,
                "autocall_id": null,
                "sip_number": "84288xxx",
                "phone_number": "0393xxx",
                "create_by": {
                    "id": "639202a8bf054d579109b35e",
                    "name": "SenBac",
                    "contact_id": "639202a8bf054d579109b35d",
                    "avatar": null,
                    "gender": null,
                    "uuid": null,
                    "type": "agent"
                },
                "transfer_histories": [],
                "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,
                "recording_file_voicemail": null,
                "domain_fusion": "demo20",
                "send_num_retry": 0,
                "time_start_call": 1747128857,
                "time_end_call": 1747128866,
                "out_of_working_time": false,
                "sip_number_tags": [],
                "evaluations": null,
                "total_evaluate": null,
                "internal_destination": null,
                "classifies": null,
                "collect_info_variables": null,
                "sip_number_forward_out": null,
                "is_same_network": false,
                "is_same_network_forward_out": false,
                "provider_of_number": "digitel",
                "provider_of_number_forward_out": null,
                "callbot_script_id": null,
                "criteria": null
            }
        ],
        "page_number": 1,
        "page_size": 1,
        "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
}

Danh sách tiêu chí đánh giá cuộc gọi

GET [URL]/api/evaluation_criteria/call/list

Headers

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

Lấy danh sách chi tiết lịch sử cuộc gọi

POST [URL]/api/call_transaction/search

Danh sách chi tiết lịch sử cuộc gọi, lấy chi tiết rút gọn

Dữ liệu Body truyền lên dưới định dạng JSON.

Ví dụ:

{
"from_date" : 1693846799000,
"to_date" : 1696438799000,
"user_uuids" : ["0123456789"]
}

Path Parameters

Name	Type	Description
page	integer	Page cần get (= 1)
size	integer	Số phần tử trong trang (max 50 item)

Headers

Name	Type	Description
x-api-key*	string	API key
Content-Type*	string	application/json

Request Body

Name	Type	Description
from_date*	string	Thời gian bắt đầu lấy log (milisecond)
to_date*	string	Thời gian kết thúc lấy log (milisecond)
user_uuids*	List<string>	Danh sách user UUID
direction	List<string>	Hướng gọi ("inbound", "outbound", "local")
disposition	List<string>	Trạng thái trả lời/không trả lời ("answered", "cancelled")
tags	List<string>	Danh sách ID tags
numbers	List<string>	Danh sách đầu số

200 Dữ liệu thông tin khách hàng trả về, khi sửa thông tin thành công

{
    "instance_id": "stg",
    "payload": {
        "items": [
            {
                "transaction_id": "09d43196-4ec7-4fba-80fe-c6aa1f3760b8",
                "tenant_id": "6391feada745be2a6aa18006",
                "direction": "outbound",
                "source_number": "842888806669",
                "destination_number": "0393210914",
                "disposition": "answered",
                "bill_sec": 8,
                "record_seconds": 6,
                "time_start_to_answer": 1747128857,
                "recording_file": "https://drive.google.com/.......",
                "recording_file_url": "https://public-v1-stg.omicrm.com/....",
                "recording_data": null,
                "sip_user": "101",
                "created_date": 1747128866529,
                "last_updated_date": 1747135112659,
                "is_auto_call": false,
                "ivr": "none",
                "provider": "viettel",
                "duration": 9,
                "user": [
                    {
                        "full_name": "SenBac",
                        "full_name_unsigned": "senbac",
                        "note": "Số test",
                        "tag": [ // Danh sách thẻ tag cuộc gọi
                            {
                                "name": "Đã gọi"
                            }
                        ]
                    }
                ],
                "customer": null,
                "state": null,
                "call_uuid": null,
                "from_number": null,
                "to_number": null,
                "hotline": null,
                "is_have_forward_out": false,// Chuyển tiến ra sim true/false
                "bill_sec_forward_out": 0, // Số giây chuyển tiếp ra bên ngoài 
                "call_out_price": 106.664,
                "note": "Số test", // Ghi chu cuoc goi
                "tag": [
                    "Đã gọi"
                ], // tag cuoc goi
                "invite_failure_status": null,
                "answer_sec": 6,
                "autocall_uuid": null,
                "autocall_id": null,
                "sip_number": "84288xxx",
                "phone_number": "0393xxx",
                "create_by": {
                    "id": "639202a8bf054d579109b35e",
                    "name": "SenBac",
                    "contact_id": "639202a8bf054d579109b35d",
                    "avatar": null,
                    "gender": null,
                    "uuid": null,
                    "type": "agent"
                },
                "transfer_histories": [],
                "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,
                "recording_file_voicemail": null,
                "domain_fusion": "demo20",
                "send_num_retry": 0,
                "time_start_call": 1747128857,
                "time_end_call": 1747128866,
                "out_of_working_time": false,
                "sip_number_tags": [],
                "evaluations": null,
                "total_evaluate": null,
                "internal_destination": null,
                "classifies": null,
                "collect_info_variables": null,
                "sip_number_forward_out": null,
                "is_same_network": false,
                "is_same_network_forward_out": false,
                "provider_of_number": "digitel",
                "provider_of_number_forward_out": null,
                "callbot_script_id": null,
                "criteria": null
            }
        ],
        "page_number": 1,
        "page_size": 1,
        "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
}

Đánh giá cuộc gọi theo tiêu chí

POST [URL]/api/call_transaction/add_evaluation/:transaction_id

Path Parameters

Name	Type	Description
transaction_id*	string	Transaction Id cuộc gọi

Request Body

Name	Type	Description
user_uuid*	string	Id của User bên thứ 3 hoặc Số máy lẻ trong hệ thống
evaluation*	object	Đối tượng chưa thông tin đánh giá, json format như sau (Format như ảnh bên dưới )

200 OK Thông tin cuộc gọi + đánh giá