Lịch sử cuộc gọi V2 (GetCallHistoryVer2)

Tra cứu lịch sử cuộc gọi tổng đài phiên bản 2 với các trường dữ liệu tiếng Anh chuẩn hóa.

POSThttps://api.ods.vn/api/CloudFone/GetCallHistoryVer2

Khuyến nghị: Đây là phiên bản API cũ. Doanh nghiệp tích hợp mới được khuyến nghị sử dụng GetCallLogs để có định dạng dữ liệu chuẩn hóa, đầy đủ thông tin nhất (chi tiết trạng thái nghe máy/nhỡ/bận, thời gian đổ chuông, cước phí và liên kết ghi âm).

Phiên bản nâng cấp của GetCallHistory, chuyển đổi toàn bộ tên trường dữ liệu trả về sang chuẩn tiếng Anh camelCase (callDate, callerNumber, receiveNumber, totalCallTime, realCallTime).

Tham số request

Tham số	Kiểu dữ liệu	Bắt buộc	Mô tả chi tiết
`ServiceName`	string	Có	Mã dịch vụ tổng đài khi mua tại ODS.
`AuthUser`	string	Có	Mã tài khoản khách hàng.
`AuthKey`	string	Có	Khóa bí mật API do ODS cấp.
`TypeGet`	number	Có	Loại cuộc gọi: `0` (tất cả), `1` (gọi đến), `2` (gọi đi), `3` (gọi nội bộ), `4` (gọi nhỡ), `5` (nhóm trả lời), `6` (nhóm nhỡ), `7` (tất cả cuộc nhỡ).
`DateStart`	string	Có	Thời gian bắt đầu tra cứu (`YYYY-MM-DD HH:mm:ss`).
`DateEnd`	string	Có	Thời gian kết thúc tra cứu (`YYYY-MM-DD HH:mm:ss`).
`PageIndex`	number	Có	Số thứ tự trang bắt đầu từ `1`.
`PageSize`	number	Có	Số bản ghi trên 1 trang (tối đa `200`).
`HideFWOut`	number	Không	`1` để gom các cuộc gọi forward về 1 dòng khi lấy all log.
`IsSort`	number	Không	`0` (tăng dần - mặc định), `1` (giảm dần).
`CallNum`	string	Không	Lọc theo số gọi.
`ReceiveNum`	string	Không	Lọc theo số nhận.
`Key`	string	Không	Mã định danh cuộc gọi.

Ví dụ request

curl -X POST "https://api.ods.vn/api/CloudFone/GetCallHistoryVer2" \
  -H "Content-Type: application/json" \
  -d '{
    "ServiceName": "YOUR_SERVICE_NAME",
    "AuthUser": "YOUR_AUTH_USER",
    "AuthKey": "YOUR_AUTH_KEY",
    "TypeGet": 0,
    "HideFWOut": 1,
    "DateStart": "2026-10-13 00:00:00",
    "DateEnd": "2026-10-13 23:59:59",
    "IsSort": 0,
    "CallNum": "",
    "ReceiveNum": "",
    "Key": "",
    "PageIndex": 1,
    "PageSize": 20
  }'

Response mẫu

{
  "result": "success",
  "message": "",
  "total": 415,
  "data": [
    {
      "stt": 1,
      "key": "1652343010.8-0900000000",
      "callDate": "2026-10-13T15:10:10",
      "callerNumber": "101",
      "callerName": "Support Agent 1",
      "headNumber": "02873007788",
      "receiveNumber": "0900000000",
      "status": "ANSWERED",
      "totalCallTime": "120",
      "realCallTime": "105",
      "linkFile": "https://recording.ods.vn/recordings/audio.mp3",
      "gsmPort": "",
      "typecall": "Outbound"
    }
  ]
}

Cấu trúc phản hồi

Trường	Kiểu dữ liệu	Mô tả
`key`	string	Mã cuộc gọi định danh.
`callDate`	string	Thời gian thực hiện cuộc gọi.
`callerNumber`	string	Số gọi đi.
`callerName`	string	Tên người gọi.
`headNumber`	string	Đầu số Hotline tổng đài.
`receiveNumber`	string	Số nhận cuộc gọi.
`status`	string	Trạng thái (`ANSWERED`, `NO ANSWER`, `BUSY`).
`totalCallTime`	string	Tổng thời gian cuộc gọi (giây).
`realCallTime`	string	Thời gian đàm thoại thực tế (giây).
`linkFile`	string	Đường dẫn tệp ghi âm.
`typecall`	string	Hướng cuộc gọi (`Inbound`, `Outbound`).

Lưu ý quan trọng

Endpoint này chuẩn hóa tên trường tiếng Anh cho GetCallHistory, hỗ trợ tốt hơn cho việc tích hợp trên các framework hiện đại.
Giới hạn phân trang tối đa PageSize là 200 bản ghi.

Lịch sử cuộc gọi V2 (GetCallHistoryVer2)

Tham số request

Cấu trúc phản hồi

Lưu ý quan trọng

Lỗi thường gặp

Bài viết liên quan

Nhật ký cuộc gọi chuẩn mới

API Tổng đài PBX

Lịch sử cuộc gọi V2 (GetCallHistoryVer2)

Tham số request

Cấu trúc phản hồi

Lưu ý quan trọng

Lỗi thường gặp

Khoảng thời gian tra cứu quá dài

Dữ liệu rỗng khi tra cứu

Bài viết liên quan

Nhật ký cuộc gọi chuẩn mới

API Tổng đài PBX