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

Truy vấn CDR theo nhiều điều kiện + tải ghi âm qua Signed URL.

GET /api/pbx/cdr — Liệt kê

Query parameters

Field	Type	Required	Mô tả	Giá trị hợp lệ
from	date	optional	Ngày bắt đầu (YYYY-MM-DD)	Không truyền → now() - 30 ngày
to	date	optional	Ngày kết thúc (YYYY-MM-DD)	Phải ≥ from. Không truyền → now()
direction	string	optional	Hướng cuộc gọi	inbound, outbound, internal, local
extension	string	optional	Lọc theo máy nhánh (match extension_number hoặc agent_extension)	3-20 ký tự
phone	string	optional	Lọc theo số điện thoại (match caller_number hoặc destination_number)	max 50 ký tự
page	integer	optional	Số trang	≥ 1
per_page	integer	optional	Số bản ghi/trang	1-200 (default 50)

Giới hạn cửa sổ thời gian

Cửa sổ from..to tối đa 30 ngày (có thể cấu hình riêng cho từng tài khoản qua giới hạn cấu hình theo từng khách hàng). Vượt → HTTP 422.

Response body fields (mỗi item trong data[])

Field	Type	Mô tả	Giá trị hợp lệ
uuid	string	UUID cuộc gọi (Zorio PBX call_uuid)	UUID 36 ký tự
direction	string	Hướng cuộc gọi	inbound / outbound / internal / local
source_type	string	Nguồn cuộc gọi	inbound / outbound_manual / outbound_telesales / outbound_callback / outbound_webphone / internal
caller_number	string	Số gọi đi (caller ID)
destination_number	string	Số đích
extension_number	string|null	Máy nhánh thực hiện hoặc nhận cuộc gọi
agent_extension	string|null	Máy nhánh của Agent đã trả lời cuộc gọi (cho queue/IVR)
start_time	datetime	Lúc cuộc gọi bắt đầu	ISO 8601
answer_time	datetime|null	Lúc nhấc máy	ISO 8601 (null nếu không nhấc)
end_time	datetime	Lúc cúp máy	ISO 8601
duration	integer	Tổng thời lượng (giây)	≥ 0
billsec	integer	Thời gian tính tiền (sau khi nhấc, giây)	≥ 0
queue_name	string|null	Tên queue (nếu cuộc đi qua hàng đợi)
queue_wait_time	integer|null	Thời gian chờ trong queue (giây)
trunk_name	string|null	Tên trunk gọi ra (cho outbound)
transfer_count	integer	Số lần chuyển máy	≥ 0
result	string	Kết quả cuộc gọi	answered / busy / no_answer / failed / cancelled / rejected / voicemail
hangup_cause	string	Mã hangup từ Zorio PBX	vd NORMAL_CLEARING, NO_ANSWER, USER_BUSY, CALL_REJECTED, ...
sip_response_code	string|null	Mã phản hồi SIP cuối cùng (cho outbound)	vd 200, 486, 487
recording_available	bool	Có file ghi âm không	true / false
created_at	datetime	Ngày tạo row CDR

Response Body (JSON) — 200

{
  "current_page": 1,
  "data": [
    {
      "uuid": "65569ce0-0183-4f61-a3b2-0e433cfa4031",
      "direction": "outbound",
      "source_type": "outbound_telesales",
      "caller_number": "0900000021",
      "destination_number": "0987654321",
      "extension_number": "0900000021",
      "agent_extension": null,
      "start_time": "2026-06-27T08:15:42+00:00",
      "answer_time": "2026-06-27T08:15:42+00:00",
      "end_time": "2026-06-27T08:15:56+00:00",
      "duration": 14,
      "billsec": 14,
      "queue_name": null,
      "queue_wait_time": null,
      "trunk_name": null,
      "transfer_count": 0,
      "result": "answered",
      "hangup_cause": "NORMAL_CLEARING",
      "sip_response_code": null,
      "recording_available": true,
      "created_at": "2026-06-27 08:15:56"
    }
  ],
  "last_page": 5,
  "per_page": 20,
  "total": 87
}

GET /api/pbx/cdr/{uuid} — Chi tiết + signed recording URL

Path parameter

uuid (string, Zorio PBX call_uuid).

Response = 22 field như list + 1 object recording (nếu có ghi âm).

recording object fields

Field	Type	Mô tả
duration	integer	Thời lượng file ghi âm (giây)
file_size	integer	Kích thước file (byte)
recorded_at	datetime	Lúc ghi âm bắt đầu (ISO 8601)
url	string	Signed URL dùng để tải file ghi âm .wav — chỉ valid trong expires_in_seconds
expires_in_seconds	integer	Thời gian hiệu lực của URL (TTL) (default 1800 = 30 phút)

Response Body (JSON) — 200

{
  "data": {
    "uuid": "65569ce0-...",
    "direction": "outbound",
    "recording_available": true,
    "recording": {
      "duration": 14,
      "file_size": 56265,
      "recorded_at": "2026-06-27T08:15:57+00:00",
      "url": "https://app.zorio.vn/api/public/recordings/401/audio?expires=1782706011&signature=de93e86...",
      "expires_in_seconds": 1800
    }
  }
}

GET /api/pbx/cdr/{uuid}/recording — 302 redirect tới signed URL

Path parameter

uuid (CDR Unique-ID).

Response

HTTP 302 với header Location: <signed URL>. Client làm theo redirect để tải file hoặc Client tự động theo redirect để tải file .wav. TTL signed URL: 30 phút (HMAC SHA256).